ALM Accelerator'ı el ile yapılandırma

  • Makale

ALM Accelerator for Power Platform bileşenlerini ilgili yönetim uygulamasını kullanarak veya el ile yapılandırabilirsiniz. Bu makale, uygulamayı el ile yapılandırarma konusunda rehberlik sağlar ve yedi bölüm olarak yapılandırılmıştır:

Önkoşullar

ALM Accelerator for Power Platform'u yüklemeden önce, aşağıdaki ön koşulları karşılamış olduğunuzdan emin olun.

  • ALM Accelerator, Microsoft Dataverse veritabanına sahip bir Power Platform ortamına yüklenmelidir. Ayrıca çözüm dağıtmak için ALM Accelerator kullandığınız tüm ortamlar da bir Dataverse veritabanı gerektirir.

    Not

    ALM Accelerator, Dataverse for Teams ile uyumlu değildir. Hem ALM Accelerator uygulaması, hem de ilişkili ardışık düzenler tüm ortamlarda Dataverse'ün tam sürümünü kullandığınızı varsayar.

    ALM Accelerator'ı diğer CoE Başlangıç Seti çözümleriyle aynı ortama yüklemenizi öneriyoruz. Kuruluşunuz için en iyi stratejiyi belirleme hakkında daha fazla bilgi edinin:

  • ALM Accelerator, kaynak denetimi ve dağıtımlar için Azure DevOps kullanır. Bir Azure DevOps kuruluşunuz yoksa, Azure DevOps sitesinde en fazla beş kullanıcı için ücretsiz kaydolun.

  • Bu bölümdeki adımları tamamlayabilmeniz için Azure, Azure DevOps ve Power Platform'ta aşağıdaki kullanıcılara ve izinlere gerek duyarsınız:

    • Microsoft Entra grupları oluşturup görüntüleme, uygulama kayıtları oluşturma ve Microsoft Entra ID'de uygulama kayıtlarına yönetici izni verme izinleri olan lisanslı bir Azure kullanıcısı
    • Ardışık düzenler, hizmet bağlantıları, depolar ve uzantılar oluşturma ve yönetme izinlerine sahip lisanslı bir Azure DevOps kullanıcısı
    • Uygulama kullanıcıları oluşturma ve onlara yönetim izinleri atama izinlerine sahip lisanslı bir Power Platform kullanıcısı

  • Aşağıdaki bağlayıcıların, ALM Accelerator'ın içeri aktarılacağı ortamlarda birlikte kullanılabilmek için uygun olması gerekir:

  • Oluşturucu Setini ALM Accelerator'ı yüklediğiniz ortama yükleyin.

Temel kurulum

Aşağıdaki ALM Accelerator'ın işlevselliği için geneldir ve herhangi bir projeye veya çözüme özgü değildir.

Microsoft Entra ortamınızda uygulama kaydı oluşturma

Uygulamayı ve Azure DevOps ve Power Apps veya Dataverse'de işlemler gerçekleştirmek için gereken ilişkili ardışık düzen izinlerini vermek için ALM Accelerator'a yönelik bir uygulama kaydı oluşturun. Bunu yalnızca bir kere yapmanız gerekir.

Aşağıdaki adımlar, hem Dataverse hem de Azure DevOps için izinlerle tek bir uygulama kaydının nasıl oluşturulacağını göstermektedir. Ancak, sorumlulukları bölmek için ayrı uygulama kayıtları oluşturmak isteyebilirsiniz. Uygulama kayıt stratejisine karar vermeden önce, ayrı uygulama kayıtlarının bakım ve güvenliği nasıl etkileyeceğini dikkate almanız gerekir .

Uygulama kaydını oluşturma

  1. Azure portalında oturum açın.

  2. Microsoft Entra ID>Uygulama kayıtları'nı seçin.

  3. + Yeni kayıt'ı seçin ve kayda ALMAcceleratorServicePrincipal gibi bir ad verin.

  4. Diğer tüm seçenekleri varsayılan değerlerinde bırakın ve ardından Kaydet öğesini seçin.

Uygulama kaydına izinler ekleme

  1. Sol panelde API izinleri'ni seçin.

  2. + İzin ekle'yi seçin.

  3. Dynamics CRM ve ardından Temsilci izinleri'ni ve user_impersonation'ı seçin.

  4. Uygulama kaydında Dynamics CRM API user_impersonation iznini eklemek İzin ekle'yi seçin.

  5. Yeniden + İzin ekle'yi seçin.

  6. Kuruluşumun kullandığı API'ler sekmesini seçin. PowerApps-Danışman öğesini ve ardından Temsilci izinleri ve Analysis.All öğesini (yönetici onayı gereklidir) seçin.

    Bu izin, uygulama denetleyici aracılığıyla statik analiz çalıştırmak için gereklidir.

  7. Uygulama kaydında PowerApps API-Danışman API'si Analysis.All iznini eklemek İzin ekle'yi seçin.

  8. Yeniden + İzin ekle'yi seçin.

  9. Microsoft API'leri sekmesinde veya Kuruluşumun kullandığı API'ler sekmesinde Azure DevOps öğesini ve Temsilci izinleri ve user_impersonation öğesini seçin.

    Bu izin, ALM Accelerator uygulamasındaki özel bağlayıcıyla Azure DevOps'a bağlanmak için gereklidir.

  10. Azure DevOps iznini Kuruluşumun kullandığı API'ler sekmesinden eklediyseniz bu yordamın sonraki adımlarında kullanmak için Uygulama (istemci) kimliğini kopyalayın.

    Bunu DevOps Uygulama (istemci) kimliği olarak kullanacaksınız; bu kimlik, bu yordamda daha sonra kopyalayacağınız Uygulama (istemci) Kimliğinden farklıdır.

    Kuruluşumun kullandığı API'ler sekmesi ve Uygulama (istemci) kimliğinin vurgulandığı API izinleri iste penceresinin ekran görüntüsü.

    Azure DevOps iznini Kuruluşumun kullandığı API'ler sekmesinde bulamazsanız, DevOps Uygulama (istemci) kimliğini almak için bu adımları izleyin:

    1. Özel bir tarayıcı penceresi açın ve https://dev.azure.com/<your devops organization>/_apis konumuna gidin.
    2. Oturum açma sayfasında, URL'deki istemci_kimliği parametresinin değerini kopyalayın.

    URL'deki istemci_kimliği parametresi vurgulanmış olarak Azure DevOps kuruluş oturum açma sayfasının ekran görüntüsü.

  11. Uygulama kaydında Azure DevOps API user_impersonation iznini eklemek İzin ekle'yi seçin.

  12. Kiracınız için <yönetici onayı verin> öğesini seçin.

İstemci gizli anahtarını ve yeniden yönlendirme URI'sini yapılandırma

  1. Sol taraftaki bölmede, Sertifikalar ve gizli anahtarlar'ı seçin.

  2. Yeni gizli anahtar’yi seçin.

  3. Bir bitiş tarihi belirleyin ve ardından Ekle'yi seçin.

  4. Daha sonra kullanmak için istemci gizli anahtarı Değerini kopyalayın. Değeri yalnızca bu adımda kopyalayabilirsiniz. Sayfadan ayrılmadan önce bunu yapmaya dikkat edin.

  5. Sol panelde Genel bakış'ı seçin.

  6. Uygulama (istemci) kimliğini ve Dizin (kiracı) kimlik değerini kopyalayın.

  7. Yapılandır'ı seçin.

Uygulama kaydınız için Power App Yönetim izni verin

Ardışık düzenlerin, ortamlarınızda gereksinim duydukları eylemleri gerçekleştirebilmesi amacıyla uygulama kaydınıza Power App Yönetimi izinleri verin. Bunu yapmak için, aşağıdaki PowerShell cmdlet'ini Power Apps yönetici ayrıcalıklarına sahip bir etkileşimli kullanıcı olarak çalıştırın. Uygulama kaydınızı oluşturduktan sonra bu komutu yalnızca bir kez çalıştırmanız gerekir.

Önemli

Aşağıdaki PowerShell cmdlet'i, uygulama kaydına Power Platform Yönetimi gibi yükseltilmiş izinleri verir. Kuruluşunuzun güvenlik ilkeleri bu izin türlerine izin vermiyor olabilir. Devam etmeden önce bunlara izin verildiğinden emin olun. İzin verilmiyorsa, belirli özellikler ALM Accelerator ardışık düzenleri içinde çalışmaz.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Azure DevOps uzantılarını yükleme

ALM Accelerator, Azure DevOps markette bulunan bazı üçüncü taraf uzantılar da dahil olmak üzere çeşitli Azure DevOps uzantıları kullanır. Her üçüncü taraf uzantının web sitesi ve kaynak koduna götüren bir bağlantı aşağıdaki yönergelerde sağlanmıştır. Market uzantı yayımcısını nasıl değerlendireceğinizi öğrenin.

  1. Azure DevOps'te oturum açın.

  2. Kuruluş ayarları'nı seçin.

  3. Genel>Uzantılar'ı seçin.

  4. Aşağıdaki uzantıları arayın ve kurun:

YAML işlem hatlarını GitHub'dan Azure DevOps örneğinize kopyalama

  1. https://aka.ms/coe-alm-accelerator-templates-latest-release konumuna gidin ve en son sürümün URL'sini kopyalayın.

  2. Azure DevOps'te oturum açın.

  3. Proje oluşturun veya var olan bir projeyi seçin.

  4. Depolar'ı ve ardından depo listesinde Depoyu içeri aktar'ı seçin.

  5. 1. adımda kopyaladığınız URL'yi Klon URL'si olarak yapıştırın ve ardından İçeri aktar'ı seçin.

  6. Depo için varsayıla dalın ana olduğunu doğrulayın. Depoları ve Dalları seçin ve ana dalın varsayılan olarak etiketlendiğinden emin olun.

    Değilse, ana dala ilişkin üç dikey noktayı (⋮) ve Diğer seçenekler menüsünden Varsayılan dal olarak ayarla'yı seçin.

    Not

    Bu depo, çözüm ardışık düzen şablonlarının ve dışarı aktarma/içeri aktarma ardışık düzenin çalıştığı bir alandır. Daha sonra, çözümleriniz için ardışık düzen oluşturduğunuzda, çözümlerinizin kaynak denetimi için farklı bir depo kullanmayı tercih ederseniz, bu belirli projeye ve depoya başvurmanız gerekebilir.

Çözümleri içeri aktarmak, silmek ve dışarı aktarmak için işlem hatları oluşturma

Azure DevOps deposundaki YAML'ye göre içeri aktarma, silme ve dışarı aktarma ardışık düzenleri oluşturun. Bu ardışık düzenler, uygulamayı Git'e bir çözüm işlemek, bir çözüm içeri aktarmak veya çözüm silmek için kullandığınızda çalışır.

Not

Ardışık düzenin çalıştığı çözümden bağımsız olarak tüm dışarı aktarma işlemlerinin aynı eylemleri gerçekleştirmesini bekliyorsanız, bu bölümde açıklanan şekilde tek bir dışarı aktarma kanalı oluşturabilirsiniz. Ancak, çözüme bağlı olarak farklı dışarı aktarma eylemlerine gereksinim duyabilirsiniz. Bu durumda uygulamanın, uygulamada eylemleri gerçekleştirirken belirli çözüm ardışık düzenlerinizi işlemesi için çözüm adını export-solution-to-git-SampleSolution gibi bir export-solution-to-git ardışık düzenine ekleyebilirsiniz.

Aşağıdaki tabloda, depodaki YAML dosyası ve buna karşılık gelen ardışık düzen arasındaki yazışma gösterilmektedir.

YAML dosyası İşlem hattı adı
export-solution-to-git.yml export-solution-to-git
import-unmanaged-to-dev-environment.yml import-unmanaged-to-dev-environment
delete-unmanaged-solution-and-components.yml delete-unmanaged-solution-and-components

  1. Azure DevOps'da İşlem hatları>Yeni işlem hattı oluştur'a gidin.

  2. Kod deponuz için Azure Repos Git'i seçin ve ardından oluşturduğunuz ve önceki adımlardaki ardışık düzen şablonlarıyla tohumladığınız Azure DevOps deposuna yönlendirin.

  3. İşlem hattınızı yapılandırın sayfasında, Varolan Azure İşlem Hatları YAML dosyası'nı seçin ve /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml veya /Pipelines/delete-unmanaged-solution-and-components.yml dosyasına gidin.

  4. Devam'ı seçin ve sonra Kaydet'i seçin.

  5. Ardışık düzen çalıştır yanındaki Diğer menüsünü (...) ve ardından Yeniden Adlandır/Taşı seçeneğini belirleyin.

  6. Ardışık düzen adını export-solution-to-git, import-unmanaged-to-dev-environment veya delete-unmanaged-solution-and-components olarak (uygun şekilde) değiştirin.

  7. Kaydet'i seçin.

Dışarı aktarma işlem hattı değişkenleri oluşturma (isteğe bağlı)

Kaynak denetimine hangi bilgilerin kalıcı olduğunu denetlemek için export-solution-to-git ardışık düzeninde ardışık düzen değişkenlerini ayarlayabilirsiniz. Bu ayarları genel olarak uygulamak için export-solution-to-git ardışık düzeninizde değişkenleri ayarlayın. Ayarları dışarı aktarma sırasında belirli çözümlere uygulamak için, önceki bölümdeki notta açıklandığı şekilde çözümünüz için bir dışarı aktarma ardışık düzeni oluşturun ve bu ardışık düzende değişkenleri ayarlayın.

Ortam değişkenlerinin geçerli değerlerinin dışarı aktarma işlemi sırasında kaynak denetimine hiçbir zaman işlenmediğinden emin olmak için export-solution-to-git ardışık düzeninizde DoNotExportCurrentEnvironmentVariableValues değişkenini oluşturun ve değerini Doğru olarak ayarlayın.

Önemli

Bu ardışık düzen değişkeni, ALM Accelerator'daki dağıtım yapılandırma işlevini kullanabilmeniz için önerilir.

Belirli varsayılan ortam değişkenlerinin değerlerinin çözüm dışarı aktarma işlemi sırasında ayarlandığından emin olmak için export-solution-to-git ardışık düzeninizde VerifyDefaultEnvironmentVariableValues değişkenini oluşturun ve değerini Doğru olarak ayarlayın. customDeploymentSettings.json'da varsayılan ortam değişkenlerindeki değerleri dağıtım yapılandırma kılavuzunda açıklandığı şekilde ayarlayın.

  1. Azure DevOps'ta, Ardışık Düzenler>Kitaplık>Yeni Değişken Grubu Oluştur'u seçin.

  2. Yeni değişen gurubunu tam olarak burada belirtildiği şekilde alm-accelerator-variable-group olarak adlandırın.

    Ardışık düzenler bu belirli değişken grubuna başvuruda bulunduğundan tam olarak gösterildiği gibi adlandırılmalıdır. Değişken grubunuz için farklı bir adlandırma kuralı kullanmaya karar verirseniz, ardışın düzenin bölümlerini kullandığınız ada başvuracak şekilde değiştirmeniz gerekir.

  3. Değişken grubuna aşağıdaki değişkenleri ekleyin:

    Adı Veri Akışı Açıklaması Değer
    AADHost Microsoft Entra yetkilendirme uç noktası Genel bulutlar için login.microsoftonline.com kullanın. Kamu bulutlarında uygun kimlik doğrulama URL'sini kullanın.
    ProcessCanvasApps Tuval uygulamalarının dışarı aktarma sırasında paketleri açılacak mı veya derlemeler sırasında paketlenecek mi Yanlış ise, tuval uygulamalarının dışarı aktarma sırasında paketleri açılmaz veya derlemeler sırasında paketlenmezler. Tuval uygulaması paketini açma ve paketle işlevi önizlemedir ve şu anda üretim ortamlarında kullanımı önerilmez. Ancak, bu değişkeni Doğru olarak belirlemediğiniz sürece, tuval kaynak kodunu kaynak denetiminde görüntüleyemezsiniz.

  4. (İsteğe bağlı) Ardışık düzenlerinizde tuval stüdyosu test otomasyonunu kullanırsanız değişken grubuna aşağıdaki değişkenleri ekleyin:

    Adı Değer
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl Power Apps Oluşturucu Portalından URL. Genellikle, *https://make.powerapps.com*
    TestAutomationUsername Otomatikleştirilmiş testleri işlemek için kullanılan kullanıcı hesabı
    TestAutomationPassword Otomatikleştirilmiş testleri işlemek için kullanılan kullanıcı hesabı parolası

  5. (İsteğe bağlı) Varsayılan olarak, genel değişkenler kısıtlanır ve her ardışık düzen için erişimi yapılandırmanız gerekir. Bunu basitleştirebilirsiniz ve herhangi bir ardışık düzen için erişim olanağı verebilirsiniz. Değişken grubu (Ardışık düzenler>Kitaplık>alm-accelerator-variable-group) altında üst menüden Ardışık düzen izinleri'ni seçin, (…) öğesini ve Erişimi aç'ı seçin.

Proje derleme hizmeti için izinleri ayarlama

Önemli

Azure DevOps belirli sayıda "Derleme Hizmeti" hesabı içerir ve bu bölümdeki adımları takip ederken kafa karışıklığına neden olabilir. Aşağıdaki Adım 3 ve 5'te belirtilen adlara ve biçime çok dikkat edin. İlk listede görünmüyorsa belirli bir hesabı aramanız gerekebilir.

  1. Azure DevOps'ta Proje ayarları'nı seçin.

  2. Depolar>Güvenlik'i seçin.

  3. Kullanıcılar altında Proje Koleksiyonu Derleme Hizmeti (Kuruluşunuzun Adı) öğesini seçin.

    Not

    Proje Koleksiyonu Derleme Hizmeti kullanıcı ardında Kuruluşunuzun Adı'nı göremeyebilirsiniz. Bu, benzersiz bir tanımlayıcı olabilir. Bu durumda, kullanıcıyı bulmak için arama işlevini kullanın ve seçin.

  4. Derleme hizmeti kullanıcısı için aşağıdaki izinleri ayarlayın:

    İzin Değer
    Katkıda bulunma İzin ver
    Çekme isteklerine katkıda bulunma İzin ver
    Dal oluşturma İzin ver
    İlkeleri düzenleme İzin ver

  5. Kullanıcılar altında Proje Adınız Derleme Hizmeti (Kuruluşunuzun Adı) öğesini seçin.

  6. 4. adımdakiyle aynı değerleri ayarlayın.

  7. İşlem hatları'nı seçin, sağ üst köşedeki üç noktayı (...) seçin ve ardından Güvenliği Yönet'i seçin.

  8. Proje Adınız Derleme Hizmeti (Kuruluşunuzun Adı) kullanıcı için aşağıdaki izinleri ayarlayın:

    İzin Değer
    Derleme işlem hattını düzenle İzin ver
    Derleme kalitesini düzenle İzin ver
    Derleme sıralarını yönetme İzin ver
    Derlemeye göre giriş doğrulamasını geçersiz kılma İzin ver
    Derleme bilgilerini güncelleştir İzin ver
    Derleme ardışık düzenini görüntüleme İzin ver
    Derlemeleri görüntüle İzin ver

  9. Proje ayarları>Temsilci havuzları'nı seçin, Güvenlik'i ve ardından Ekle'yi seçin.

  10. Proje Adınız Derleme Hizmeti (Kuruluş Adınız)'ı arayın ve seçin.

  11. RolüOkuyucu olarak ayarlayın.

  12. Ekle'yi seçin.

  13. (İsteğe bağlı) Varsayılan olarak, her depo için ardışık düzen izinleri ve bunları ayrı ayrı yapılandırmanız gerekir. Bunu basitleştirebilirsiniz ve herhangi bir ardışık düzen için erişim olanağı verebilirsiniz. Proje Ayarları>Depolar altından sırayla her depoyu seçin. Üst menüden Güvenlik’i seçin. Ardışık düzen izinleri bloğunu bulun, (...) öğesini seçin ve Erişimi aç'ı seçin.

Geliştirme projesi kurulumu

Aşağıdaki bölüm, desteklediğiniz geliştirme projelerinin her birini ayarlamak için gerekli olan adımlarda size yol gösterir. Bu bağlamda geliştirme projesi, ALM sürecinin kendisini destekleyen Dataverse ortamının yapılandırması dahil sağlıklı uygulama yaşam döngüsü yönetimini (ALM) destekleyen altyapı ve yapılandırmadan oluşur.

Power Platform'a erişmesi için Azure DevOps hizmet bağlantıları oluşturma

Geliştirme, doğrulama, test ve üretim gibi her Dataverse ortamının Azure DevOps'ta bir Power Platform hizmet bağlantısı olmalıdır. Ortamlarınızın her biri için aşağıdaki adımları uygulayın.

Not

ALM Accelerator uygulaması kullanıcıları, yalnızca Azure DevOps'taki hizmet bağlantısında kullanıcı veya yönetici rolüne sahip oldukları ortamları görürler. Oluşturucular, kişisel geliştirme ortamlarında çalışırlarsa, kişisel geliştirme ortamıyla ilgili hizmet bağlantısında bir kullanıcı veya yönetici rolüne sahip olmalıdır. Derleme hizmeti gibi doğrulama, test ve üretim ortamı hizmet bağlantıları yalnızca ardışık düzenlere verilen izinlere gereksinim duyar.

  1. Azure DevOps'ta oturum açın ve projenizi seçin.

  2. Proje ayarları>Hizmet bağlantıları'nı ve ardından Hizmet bağlantısı oluştur'u seçin.

  3. Power Platform hizmet bağlantısı türünü arayın ve seçin.

  4. İleri'yi seçin.

  5. Sunucu URL'si için ortamınızın URL'sini seçin: örneğin, https://myorg.crm.dynamics.com/.

    Önemli

    URL'nin sonuna öne ğik çizgi (/) eklemeniz gerekir; örnekte .com'dan sonradır.

  6. Hizmet Bağlantı Adı için öne eğik çizgi (/) dahil 4. adımda girdiğiniz aynı URL'yi girin.

  7. Kiracı Kimliği, Uygulama (istemci) kimliği ve uygulama kaydını oluştururken Microsoft Entra'den kopyaladığınız İstemci Gizli Anahtarı'nı girin.

  8. Tüm ardışık düzenlere erişim izinleri ver'i seçin.

  9. Kaydet'i seçin.

Hizmet bağlantıları, kullanıcılarının uygulamadan erişebilmeleri için gerekli olan tüm ortamlardaki (örneğin, oluşturucu ortamları) tüm kullanıcılara kullanıcı izinleri sağlamalıdır.

  1. Hizmet Bağlantıları listesinde, kullanıcılarla paylaşılacak hizmet bağlantısını seçin.

  2. Sağ üst köşedeki Diğer (...) öğesini seçin ve ardından Güvenlik'i seçin.

  3. Grup veya Kullanıcı listesinde, kullanıcı izinleri vermek istediğiniz kullanıcıyı veya grubu seçin.

  4. Kullanıcı'yı seçin, bir Rol seçin ve ardından Ekle'yi seçin.

Geliştirme, doğrulama, test ve üretim ortamlarınızın her biri için bu bölümdeki adımları yineleyin.

Hizmet bağlantılarını kullanmak için proje derleme hizmeti izinlerini ayarlama

  1. Azure DevOps'ta Proje ayarları>Hizmet bağlantıları'nı seçin.

  2. Sağ üst köşedeki (...) öğesini seçin, Güvenlik'i ve ardından Ekle'yi seçin.

  3. Proje Adınız Derleme Hizmeti (Kuruluş Adınız)'ı arayın ve seçin.

  4. RolüYönetici olarak ayarlayıp Ekle'yi seçin.

Dataverse ortamlarınızda uygulama kullanıcısı oluşturma

Ardışık düzenlerin Dataverse'e bağlanmasına izin vermek için ortamlarınızla bir uygulama kullanıcısı oluşturun. Bunu, dağıtım için ALM Accelerator kullanmayı planladığınız her ortamda yapın.

  1. Power Platform yönetim merkezinde oturum açın.

  2. Geliştirme ortamınızı ve ardından Ayarlar'ı seçin.

  3. Kullanıcılar + izinler>Uygulama kullanıcıları'nı seçin.

  4. + Yeni uygulama kullanıcısı'nı seçin.

  5. + Uygulama ekle'yi seçin, daha önce oluşturduğunuz uygulama kaydını ve ardından Ekle'yi seçin.

  6. Departman'ı seçin.

  7. Güvenlik rolleri'nin sağındaki kalem simgesini ve ardından uygulama kullanıcısı için güvenlik rollerini seçin.

    Bu kullanıcıya, her ortamda gerekli işlevleri gerçekleştirebilmesi için uygulama kullanıcıcı sistem yöneticisi güvenlik rolleri ayrıcalıklarını vermenizi öneririz.

  8. Create'u seçin.

Doğrulama, test ve üretim ortamlarınızda bu adımları yineleyin.

Çözüm kurulumu

Dataverse'te bir çözüm oluşturduğunuzda, özellikle bu çözüm için boru hatları oluşturmanız gerekir. Aşağıdaki örnek ardışık düzenler coe-alm-templates deposundaki Ardışık düzenler dizininde yer alır:

Örnek işlem hatları, kuruluşların işlem hattı şablonlarını belirli bir çözüm işlem hattı YAML'sinden ayrı bir projede veya depoda depolamaları için esneklik sağlar. Çözüm işlem hattınızı yapılandırmak için bu bölümdeki adımları izleyin. Kaynak denetimi için ALM Accelerator'ı kullandığınız her çözüm için bu adımları yineleyin.

Önemli

Çözüm ardışık düzeniniz YAML her zaman çözümünüzde kaynak denetimi için kullandığınız depolama içinde depolanır. Ancak, işlem hattı şablonları, yani Pipeline\Templates klasörü, çözüm işlem hattı YAML'niz ile aynı depoda veya ayrı bir depo ve/veya projede bulunabilir.

Çözüm derleme ve dağıtım ardışık düzenlerini oluşturma

Çözüm işlem hatları, kaynak denetimli çözümlerinizi oluşturmak ve kiracınızdaki ortamlara dağıtmak için kullanılır. Örnek ardışık düzenler yalnızca üç ortam kullandığınızı varsayar: doğrulama, test ve üretim. Ancak, kuruluşunuzun ortam stratejisine bağlı olarak gerektikçe çok sayıda çözüm ardışık düzeni oluşturabilirsiniz.

Örnek dağıtım ardışık düzenleri, bir dalda (yani, test ve üretim) yapılan değişiklikler tarafından veya Azure DevOps'taki bir dal ilkesinin (doğrulama) parçası olarak tetiklenir. Çekme isteği doğrulaması için dal ilkeleri ayarlama hakkında daha fazla bilgi edinin. Ardışık düzenleri, bir tetikleyici olmadan el ile de çalıştırabilirsiniz.

Örnek ardışık düzen YAML'den dağıtım ardışık düzenleri oluşturmak için bu bölümdeki adımları izleyin. Aşağıdaki tabloda ardışık düzen yapılandırması açıklanmaktadır.

Önemli

Ardışık düzen adı, tam olarak aşağıdaki gibi olmalı MyNewSolution yerine çözümün adı kullanılmalıdır.

İşlem Hattı YAML dosya adı İşlem hattı adı Dal ilkesi etkin Gerekli
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Evet Evet
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution Hayır Evet
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Hayır Hayır (Önceki bölüme gidin)

Not

Aşağıdaki adımlar doğrulama, test ve üretim ortamları için derleme ve dağıtım ardışık düzenleri oluşturur. Ancak, doğrulama ve test ortamına dağıtmak ve daha sonra test derlemesindeki yapıtları üretime dağıtmak isteyebilirsiniz. Bu durumda, yalnızca doğrulama ve test ortamlarınız için bu bölümdeki adımları izleyin. Ardından, sürüm ardışık düzenini yapılandırmak için Çözüm dağıtımı ardışık düzeni oluşturma bölümüne atlayın.

Ardışık düzen dosyasını oluşturma

  1. Azure DevOps'ta, uyguladığınız işlem hatları klasörünü içeren depoya gidin ve İşlem Hatları klasörünü seçin.

  2. Üç örnek dağıtım ardışık düzeninden birini açın ve yeni ardışık düzende kullanmak üzere YAML'yi kopyalayın.

  3. İşlem hattınızda kullanılmak üzere deponun adını not edin.

  4. Çözümünüzde kaynak denetimi için kullanmak istediğiniz depoya gidin.

  5. Varsayılan dalınızı temel alarak bir dal oluşturun ve çözümünüz için adlandırın; örneğin, MyNewSolution.

    Bu dal, çözümünüz için sonraki sürüm (v-next) dalı olur. Tüm geliştirme çalışmaları bu daldan bir geliştiricinin kişisel çalışma dalına dallandırılmalı ve ardından doğrulama ve teste göndermek için v-next dalıyla birleştirilmelidir. Daha sonra, bir sürüm hazır olduğunda, v-next dalı ana veya varsayılan dalda birleştirilebilir.

  6. Üst menüden Yeni'yi seçin ve ardından Klasör'ü seçin.

  7. Yeni klasöre, çözümünüz ile aynı adı verin.

  8. Yeni ardışık düzen YAML dosyasına build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml veya build-deploy-prod-SampleSolution.yml gibi bir ad verin

  9. Create'u seçin.

Dosyayı güncelleştirme ve kaydetme

  1. Önceki bölümdeki 2. adımda kopyaladığınız YAML'yi, yeni ardışık düzen dosyasına yapıştırın.

  2. Yeni ardışık düzen YAML dosyasında aşağıdaki değerleri değiştirin:

    • Kaynaklar>Depolar>Ad'ı ardışık düzen şablonlarınızı içeren deponun adıyla değiştirin.

      Bu örnekte, depo coe-alm-accelerator-templates olarak adlandırılır ve MyNewSolution deposuyla aynı projede bulunur. Şablon deponuz farklı bir Azure DevOps projesindeyse ProjeAdı/DepoAdı biçimini kullanın. Ayrıca, gerekirse ref parametresini kullanarak şablonlarınızın kullanıma alındığı yerlerde bir dal belirtebilirsiniz.

    • SampleSolutionName öğesine başvuran herhangi bir değeri çözümünüzün benzersiz adıyla değiştirin; Örneğin, MyNewSolution.

  3. Yaptığınız değişiklikleri kaydetmek için Uygula'yı seçin.

  4. Azure DevOps'ta İşlem hatları'na gidin ve Yeni İşlem hattı oluştur'u seçin.

  5. Kod deponuz için Azure Repos Git'i seçin.

  6. Dağıtım ardışık düzeni YAML'sini içeren DevOps deposunu seçin.

  7. Ardışık düzeninizi yapılandırın sayfasında Mevcut Azure Ardışık Düzenleri YAML dosyası'nı seçin, daha önce oluşturduğunuz depodaki YAML dosyasına yönlendirin ve Devam'ı seçin.

  8. Kaydet'i Ardışık düzen çalıştır yanındaki (...) öğesini, ve ardından Yeniden Adlandır/Taşı seçeneğini belirleyin.

  9. Ardışık düzen adını deploy-validation-MyNewSolution, deploy-test-MyNewSolution veya deploy-prod-MyNewSolution olarak değiştirin; MyNewSolution çözümünüzün adıdır.

  10. Kaydet'i seçin.

  11. Yeni ardışık düzen, deponun varsayılan dalında oluşturulmadıysa: ardışık düzende Düzenle'yi seçin. Sağ üst köşedeki (...) öğesini seçin ve ardından Tetikleyiciler'i seçin. YAML sekmesini seçin ve Get Kaynakları'nı seçin. Çözümünüzün dalına yönlendirmek için Manule ve zamanlanan derlemeler için varsayılan dal'ı değiştirin. Ardışık düzen tetikleyicileri yapılandırma hakkında daha fazla bilgi edinin.

  12. coe-alm-accelerator-templates deposu (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml ve deploy-prod-SampleSolution.yml) kaynaklı örnek dağıtım ardışık düzeni YAML'sine başvuran ortamlarınızın her biri için bir dağıtım ardışık düzeni oluşturmak üzere önceki adımları yineleyin.

  13. Kaydet ve Sıraya Al'ı ve ardından Kaydet'i seçin.

Çözüm dağıtım ardışık düzeni oluşturma (isteğe bağlı)

Önceki bölümdeki adımlar, daha önce belirtildiği gibi doğrulama, test ve üretim ortamları için derleme ve dağıtım yapan ardışık düzenler oluşturur. Bununla birlikte, yalnızca doğrulama ve test için derlemek ve dağıtmak ve ardından yapıtları test derlemesinden üretime dağıtmak istiyorsanız ayrı bir çözüm dağıtımı ardışık düzeni oluşturabilirsiniz.

Örnek ardışık düzen YAML dosyasından bir çözüm dağıtımı ardışık düzeni oluşturmak için bu bölümdeki adımları izleyin. Aşağıdaki tabloda ardışık düzen yapılandırması açıklanmaktadır.

Önemli

Ardışık düzen adı, tam olarak aşağıdaki gibi olmalı MyNewSolution yerine çözümün adı kullanılmalıdır.

İşlem Hattı YAML dosya adı İşlem hattı adı Dal ilkesi etkin
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution Hayır

  1. Azure DevOps'ta, uyguladığınız işlem hatları klasörünü içeren depoya gidin ve İşlem Hatları klasörünü seçin.

  2. Örnek dağıtım işlem hattını (deploy-prod-pipelineartifact-SampleSolution.yml) açın ve yeni işlem hattınızda kullanmak üzere YAML'yi kopyalayın.

  3. İşlem hattınızda kullanılmak üzere deponun adını not edin.

  4. Çözümünüzde kaynak denetimi için kullanmak istediğiniz depoya gidin.

  5. Üst menüden Yeni'yi seçin ve ardından Dosya'yı seçin.

  6. Yeni ardışık düzen YAML dosyasına bir ad verin; örneğin, deploy-prod-MyNewSolution.yml, burada MyNewSolution çözümünüzün adıdır.

  7. Create'u seçin.

  8. 2. adımda kopyaladığınız YAML'yi, yeni ardışık düzen dosyasına yapıştırın.

  9. Yeni ardışık düzen YAML dosyasında aşağıdaki değerleri değiştirin:

    • Tetikleyici>Dallar>Dahil et'i değişikliğin üretime bir dağıtım tetiklemesi gereken dallar olarak değiştirin.

    • Kaynaklar>Depolar>Ad'ı ardışık düzen şablonlarınızı içeren deponun adıyla değiştirin.

      Bu örnekte, depo coe-alm-accelerator-templates olarak adlandırılır ve MyNewSolution deposuyla aynı projede bulunur. Şablon deponuz farklı bir Azure DevOps projesindeyse ProjeAdı/DepoAdı biçimini kullanın. Ayrıca, gerekirse ref parametresini kullanarak şablonlarınızın kullanıma alındığı yerlerde bir dal belirtebilirsiniz.

    • Bu ardışık düzenin dağıtması gereken yapıtları içeren derleme ardışık düzenini belirtmek için Kaynaklar>Ardışık Düzenler>Kaynak'ı güncelleştirin. Bu durumda, daha önce oluşturduğunuz ve çözümünüzü derleyen ve test ortamına dağıtan test ardışık düzenindeki yapıtları dağıtırsınız.

    • SampleSolutionName öğesine başvuran herhangi bir değeri çözümünüzün benzersiz adıyla değiştirin; Örneğin, MyNewSolution.

  10. deploy-prod-ALMAcceleratorSampleSolution adlı yeni üretim ardışık düzeni YAML dosyasından bir ardışık düzen oluşturmak üzere deploy-validation-ALMAcceleratorSampleSolution ve deploy-test-ALMAcceleratorSampleSolution için önceki bölümdeki 11 ile 20 adım arasındaki işlemleri tekrarlayın.

Dağıtım ardışık düzen değişkenlerini ayarlama

Daha önce yapılandırdığınız her dağıtım ardışık düzeni için EnvironmentName ve ServiceConnection değişkenlerinin değerlerini ardışık düzenin dağıttığı ortama göre ayarlamanız gerekir. Ayrıca EnableFlows değişkenini dağıtımın parçası olarak Power Automate akışlarını kapatmak için de ayarlayabilirsiniz.

Ortam ve hizmet bağlantısı değişkenleri oluşturma (gerekli)

Her dağıtım ardışık düzeni EnvironmentName ortam değişkenini ve ServiceConnection hizmet bağlantısı değişkenini gerektirir.

  • EnvironmentName, dağıtım geçmişi izlemesini etkinleştirmek ve belirli ortamlara dağıtım için izinleri ve onayları ayarlamak üzere dağıtılmakta olan Azure DevOps ortamını belirtir. Bu değeri Doğrulama, Test veya Üretim (uygun şekilde) olarak ayarlayın.

  • ServiceConnection, dağıtım ardışık düzeninin Power Platform'a nasıl bağlandığını belirtir. İzin verilen değerler, daha önce oluşturduğunuz hizmet bağlantılarının adlarıdır.

  1. Dağıtım ardışık düzenlerinin her birinde Düzenle seçeneğini belirleyin.

  2. Değişkenler düzenleyicisini açmak için dağıtım ardışık düzeni tanımında Değişkenler'i seçin.

  3. Bir değişken eklemek için (+) öğesini seçin. Değişkenin adını ve uygun değeri girin.

EnvironmentName ve ServiceConnection değişkenlerini oluşturmak için bu adımları tekrarlayın.

EnableFlows değişkeni oluşturma (isteğe bağlı)

EnableFlows adlı ardışık düzen değişkenin değerini Yanlış olarak ayarlayarak dağıtımınızın parçası olarak Power Automate akışlarını otomatik olarak etkinleştiren adımları atlayabilirsiniz. EnableFlows değişkeni için varsayılan değer Doğru'dur.

Çekme isteği doğrulaması için dal ilkelerini ayarlama

Bir çekme isteği oluşturulduğunda önceden oluşturduğunuz ardışık düzeni işlemek için bir dal ilkesi oluşturun.

  1. Azure DevOps'ta Depolar'a gidin ve Dallar klasörünü seçin.

  2. Çekme isteği ilkesini oluşturmak istediğiniz dalı bulun. Dalın sağında (…) öğesini ve ardından Dal İlkeleri'ni seçin.

  3. Dal İlkeleri sayfasında Derleme Doğrulaması'na gidin.

  4. Yeni bir dal ilkesi eklemek için + öğesini seçin.

  5. Derleme ardışık düzeni listesinde, daha önce oluşturduğunuz ardışık düzeni seçin.

  6. Yalnızca belirtilen yoldaki değişikliklerin, çekme isteği için ardışık düzeni tetiklediğinden emin olmak için geçerliyse bir Yol filtresi belirtin.

  7. Tetikleyici'yi Otomatik olarak ayarlayın.

  8. İlke gereksiniminiGerekli olarak ayarlayın.

  9. Derleme süre sonu'nu Hemen olarak ayarlayın.

  10. Dal ilkeniz için bir Görünen ad ayarlayın; örneğin PR Derleme Doğrulaması.

  11. Kaydet'i seçin.

Doğrulama derleme ilkesi için ayarları seçme ekran görüntüsü.

Ardışık düzenler için kaynak erişim izinlerini ayarlama

Ardışık düzenlerin çalışmak için depolar, değişken grupları ve hizmet bağlantıları gibi gerekli kaynaklara erişmesi gerekir. Erişime izin vermek için üç seçeneğiniz vardır.

İlk çalıştırma sırasında erişime izin verme

Ardışık düzenin ilk çalıştırıldığı sırada gerekli bir kaynağa erişime izin verebilirsiniz.

  1. Ardışık düzeni tetiklemek ve ardışık düzen çalıştırmasını Azure DevOps'ta açmak.
  2. "İzin gerekli" başlığında Görüntüle'yi seçin.
  3. Gerekli her kaynak için İzin ver'i seçin.

Açık izin verme

Bir ardışık düzenin gerekli depolara erişim sağlaması için açık izin verebilirsiniz.

  1. Azure DevOps'ta Proje ayarları'nı açın.
  2. Depolar'ı ve ardından bir depo seçin.
  3. Güvenlik sekmesini seçin.
  4. Ardışık düzen izinleri'ne gidin ve + simgesini seçin.
  5. Depoya erişim vermek istediğiniz işlem hattını seçin.

Bir ardışık düzenin gerekli değişken gruplarına erişim sağlaması için açık izin verebilirsiniz.

  1. Azure DevOps'da Ardışık düzenler>Kitaplık seçeneğini belirleyin ve ardından bir değişken grubu seçin.
  2. İşlem hattı izinleri'ni seçin.
  3. + öğesini seçin ve değişken grubuna erişim vermek istediğiniz ardışık düzeni seçin.

Bir ardışık düzenin gerekli hizmet bağlantılarına erişim sağlaması için açık izin verebilirsiniz.

  1. Azure DevOps'ta Proje ayarları'nı açın.
  2. Hizmet bağlantıları'nı ve ardından bir hizmet bağlantısını seçin.
  3. Diğer eylemler (…) ve ardından Güvenlik öğesini seçin.
  4. Ardışık düzen izinleri'ne gidin ve + simgesini seçin.
  5. Hizmet bağlantısına erişim vermek istediğiniz ardışık düzeni seçin.

Tüm ardışık düzenlere erişim izni verme

Hem şu an sahip olduklarınıza hem de gelecekte oluşturacağınız tüm ardışık düzenlere gerekli depolara erişim izni verebilirsiniz.

  1. Azure DevOps'ta Proje ayarları'nı açın.
  2. Depolar'ı ve ardından bir depo seçin.
  3. Güvenlik sekmesini seçin.
  4. İşlem hattı izinleri'ne gidin.
  5. Diğer eylemler (…) öğesini, Açık erişim'i seçin ve istendiğinde onaylayın.

Tüm ardışık düzenlere gerekli değişken gruplarına erişme izni verebilirsiniz.

  1. Azure DevOps'da Ardışık düzenler>Kitaplık seçeneğini belirleyin ve ardından bir değişken grubu seçin.
  2. İşlem hattı izinleri'ni seçin.
  3. Diğer eylemler (…) öğesini, Açık erişim'i seçin ve istendiğinde onaylayın.

Tüm ardışık düzenlere gerekli hizmet bağlantılarına erişme izni verebilirsiniz.

  1. Azure DevOps'ta Proje ayarları'nı açın.
  2. Hizmet bağlantıları'nı ve ardından bir hizmet bağlantısını seçin.
  3. Diğer eylemler (…) ve ardından Güvenlik öğesini seçin.
  4. Bir hizmet bağlantısı seçin, Diğer eylemler'i (…) ve ardından Güvenlik'i seçin.
  5. İşlem hattı izinleri'ne gidin.
  6. Diğer eylemler (…) öğesini, Açık erişim'i seçin ve istendiğinde onaylayın.

İş yetkilendirme kapsamını ayarlayın

İş yetkilendirme kapsamı, tüm Azure DevOps kuruluşu için veya belirli bir proje için ayarlanabilir. Yayın ardışık düzenleri için iş yetkilendirme kapsamını mevcut projeyle sınırlandırın ayarını devre dışı bırakın, şablonları yüklemek için farklı bir Azure DevOps projesi seçtiyseniz.

Tüm projeler için iş yetki kapsamını organizasyon düzeyinde ayarlamak

  1. Azure DevOps'ta, Kuruluş ayarları > Ardışık düzenler > Ayarlar'ı seçin.
  2. Yayın ardışık düzenleri için iş yetkilendirme kapsamını mevcut projeyle sınırlandırın ayarını devre dışı bırakın.

Dağıtım yapılandırması oluşturma (isteğe bağlı)

Bir çözüm dağıtıldıktan sonra, hedef ortamda birkaç yapılandırma oluşturmanız gerekir. Bu yapılandırmalar ortama özeldir ve Power Automate akışları gibi çözüm bileşenlerinin sahipliği güncelleştirme ve tuval uygulamalarını paylaşmaya ek olarak Microsoft Entra grupları ve Dataverse ekipleri için bağlantı başvurularını, ortam değişkenlerini ve izinleri içerir. Bu yapılandırmalarla birlikte, uçtan uca bir ALM deneyimi sağlamak için bir hedef ortamın genellikle çözümdeki Dataverse tablolarıyla ilişkili örnek veya yapılandırma verilerine ihtiyacı vardır.

Çözümünüz bu diğer yapılandırmaları veya verileri gerektiriyorsa, dağıtmakta olduğunuz ortamlara göre ardışık düzenleri yapılandırmak için dağıtım yapılandırma kılavuzunu izleyin.

Çözümü içeri aktarma ve uygulamayı yapılandırma

ALM Accelerator tuval uygulamasını Power Platform ortamınıza aktarın ve ardından Azure DevOps için dahil edilen özel bağlayıcıyı yapılandırın.

Dataverse'e ALM Accelerator yükleme

  1. ALM Accelerator çözümü Oluşturucu Seti'ne bağlıdır. Oluşturucu Setini yükleyin.

  2. GitHub'dan en son yönetilen çözüm dosyasını indirin. Varlıklar'a gidin ve CenterofExcellenceALMAccelerator_<latest version>_managed.zip öğesini seçin.

  3. Power Apps'te oturum açın ve ardından ALM Accelerator uygulamasını barındırmak istediğiniz ortamı seçin.

  4. Sol panelde Çözümler'ı seçin.

  5. Çözümü içeri aktar>Gözat'ı seçin ve indirdiğiniz yönetilen çözümün konumuna göz atıp dosyayı seçin.

  6. İleri'yi ve sonra tekrar İleri'yi seçin.

  7. Bağlantılar sayfasında CDS DevOps bağlantısını Dataverse'e bağlamak için bir bağlantı seçin veya oluşturun.

    Microsoft Entra ile HTTP için bağlantı oluştururken her iki parametre için Microsoft Graph kullanın.

  8. İçeri aktar'ı seçin.

DevOps özel bağlayıcısını yapılandırma

  1. Veriler>Özel Bağlayıcılar>CustomAzureDevOps öğesini seçin.

  2. Düzenle'yi seçin. Güvenlik sayfasında, Düzenle'yi seçin ve aşağıdaki alanları ayarlayın:

    Adı Değer
    Kimlik Doğrulaması Türü OAuth 2.0
    Kimlik sağlayıcısı Azure Active Directory
    İstemci kimliği Uygulama kaydını oluştururken kopyaladığınız Uygulama (istemci) kimliği
    İstemci gizli anahtarı Uygulama kaydını oluştururken kopyaladığınız Uygulama (istemci) gizli anahtar değeri
    Kiracı Kimliği Varsayılan değeri bırakın, ortak
    Kaynak URL Uygulama kaydınıza izinleri eklerken kopyaladığınız DevOps Uygulama (istemci) kimliği
    Yeniden Yönlendirme URL'si Otomatik oluşturur. 'Yeniden Yönlendirme URL'si'nin altındaki 'Benzersiz yeniden yönlendirme URL'sini güncelleştir' onay kutusu görürseniz, lütfen onay kutusuna bakın.

  3. Bağlayıcıyı güncelle'yi seçin.

"Yeniden Yönlendirme URL'si"ni "Yeniden Yönlendirme URI'sı" olarak ekleyin

Yukarıdaki bölümden otomatik olarak oluşturulacak "Yeniden Yönlendirme URL'si"nin uygulama kaydına "Yeniden Yönlendirme URI'sı" olarak eklenmesi gerekir.

  1. Oluşturduğunuz uygulama kaydına geri dönün.

  2. Sol panelde Genel bakış'ı seçin.

  3. Bir Yeniden yönlendirme URI'si ekle'yi seçin.

  4. + Platform ekleyin'i ve ardından Web'i seçin.

  5. Yeniden Yönlendirme URI'leri metin kutusu altında, yukarıdaki bölümden kopyalanan otomatik olarak üretilen "Yönlendirme URL'si"ni yapıştırın.

  6. Yapılandır'ı seçin.

Özel bağlayıcıyı test etme

  1. Test menüsünü açın.

  2. Yeni bağlantı'yı seçin ve bağlantı oluşturmak için istemleri izleyin.

  3. Power Apps'te ortamınızı seçin ve Dataverse>Özel Bağlayıcılar>CustomAzureDevOps'u seçin.

  4. Düzenle'yi seçin, Test sayfasına gidin ve GetOrganizations işlemini bulun.

  5. Test İşlemi'ni seçin.

  6. Döndürülen Yanıt Durumunun200 olduğunu ve Yanıt Gövdesinin Azure DevOps kuruluşunuzun bir JSON gösterimi olduğunu doğrulayın.

    Özel Azure DevOps bağlayıcısı için güvenlik ayarlarını test etme ekran görüntüsü.

Oluşturucuları ALM Accelerator uygulamasını kullanmak üzere ayarlama

Daha fazla bilgi edinin