ALM Accelerator'ı el ile yapılandırma

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
• Temel kurulum
• Geliştirme projesi kurulumu
• Çözüm kurulumu
• Çözümü içeri aktarın ve uygulamayı yapılandırın
• ALM Accelerator uygulamasını kullanmak için oluşturucuları ayarlama

Ö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:

  • için bir çevre stratejisi oluşturmak Microsoft Power Platform
  • ALM için çevre stratejisi

• 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:

  • Dataverse (Miras)
  • HTTP
  • Power Apps Maker'lar için
  • Kimlik Microsoft Entra ile HTTP (uç nokta erişimi https://graph.microsoft.com ile)
  • ALM Accelerator Custom DevOps (bu bağlayıcı, hızlandırıcı çözümünü içeri aktarmanın bir parçası olarak oluşturulur)
  • Office 365 Kullanıcı
  • HTTP

• Creator Kit'i , ALM Accelerator'ı kurduğunuz 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. API'ler Microsoft sekmesinde veya kuruluşumun kullandığı API'ler sekmesinde'yi seçin Azure DevOps ve ardından Temsilci izinleri ve user_impersonation'yi 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.

    

    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.

    

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.

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ısı 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:

   • Power Platform Derleme Araçları (gerekli): Bu uzantı, Microsoft derleme Power Platform görevlerini içerir. (https://marketplace.visualstudio.com/items?itemName=microsoft-IsvExpTools.PowerPlatform-BuildTools)

   • Belirteçleri Değiştir (gerekli): İşlem hatları, yapılandırma dosyalarındaki belirteçleri değiştirmek ve bir işlem hattı için yapılandırılan özel değişkenlerde güvenli değerleri depolamak için bu uzantıyı kullanır. (https://marketplace.visualstudio.com/items?itemName=qetza.replacetokens | https://github.com/qetza/vsts-replacetokens-task)

   • SARIF SAST Taramaları Sekmesi (isteğe bağlı): Çözüm denetleyicisinin bir derleme sırasında oluşturduğu SARIF dosyalarını görselleştirmek için bu uzantıyı kullanın. (SARIF SAST Taramaları Sekmesi - Visual Studio Market)

     

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.

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

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.

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	Bulut Kimliği
   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

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 işlem hattı izinleri sınırlıdır 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.

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:

• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml

Ö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.

Çö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 ilkelerini 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.

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. İşlem hattı tetikleyicilerini 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.

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şinin izlenmesini Azure DevOps etkinleştirmek ve belirli ortamlara dağıtım için izinleri ve onayları ayarlamak için dağıtılan ortamı belirtir. Bu değeri Doğrulama, Test veya Üretim (uygun şekilde) olarak ayarlayın.

• ServiceConnection Dağıtım ardışık düzeni'nin nasıl bağlanacağını belirtir Power Platform. İ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 gereksinimini Gerekli 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.

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. İçerik Üretici Kitini hemen 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.

   HTTP için Microsoft Entrabir bağlantı oluşturduğunuzda, her iki parametre için de Graph'ı Microsoft 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ğrulama Türü	OAuth 2.0
   Kimlik sağlayıcı	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'si	Uygulama kaydınıza izinleri eklerken kopyaladığınız DevOps Uygulama (istemci) kimliği
   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 Durumunun 200 olduğunu ve Yanıt Gövdesinin Azure DevOps kuruluşunuzun bir JSON gösterimi olduğunu doğrulayın.

   

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

• ve içinde Dataverse bir oluşturucunun hesabı için kullanıcı izinlerini Azure DevOpsyapılandırın.

• Uygulamanın kullanıcı deneyimini ayarlamak ve çözümlere ve dağıtım profillerine erişim vermek için dağıtım kullanıcı ayarlarını yapılandırın.

Daha fazla bilgi edinin

• ALM Accelerator for Power Platform
• Dağıtım profillerini yapılandırma
• İşlem hatlarında yapılandırma ve veri dağıtımı
• İşlem hatlarında yapılandırma ve veri dağıtımı
• İşlem hattı eşitlemesini yapılandırma