Öğretici: Microsoft Power Platform için GitHub Actions'ı kullanarak çözüm dağıtımını otomatikleştirme

Bu öğreticide şunların nasıl yapılacağını öğreneceksiniz:

• Yeni GitHub deposu oluşturma
• Microsoft Power Platform için GitHub Actions'ı kullanarak iki GitHub iş akışı oluşturma

İş akışları bir geliştirme ortamından uygulamanızı (yönetilmeyen çözüm olarak) otomatik olarak dışarı aktarabilir, derleme yapıtı oluşturabilir (yönetilen çözüm) ve uygulamayı üretim ortamınıza dağıtabilir. Bu öğreticide, oluşturduğunuz ALMLab çözümü ve önceki öğreticilerde ayarladığınız ortamlar kullanılır.

İlgili öğreticiler: Kullanmaya başlayın ve Model temelli uygulama oluşturma.

GitHub Hesabı oluşturma

1. https://github.com adresine gidin Kaydol'a veya Ücretsiz deneme başlat'a tıklayın (veya zaten hesabınız varsa oturum açın).

   

2. Hesabınızı oluşturduktan sonra Depo oluştur'u veya Yeni'yi seçerek depo oluşturun.

   

   Aşağıdaki alternatif giriş ekranını görebilirsiniz:

   

3. Yeni deponuzu oluşturun ve "poweractionslab" olarak adlandırın. Depoyu başlatmak için README dosyası ekle'yi seçtiğinizden emin olun ve Depo oluştur'u seçin.

   

Hizmet Sorumlusu Kimlik Doğrulaması için yeni bir gizli anahtar oluşturma

1. Deponuza gidin ve Ayarlar'a tıklayın , ardından Gizli Diziler'i genişletin ve ardından Eylemler'e tıklayın.

2. Gizli Anahtarlar sayfasında, ''PowerPlatformSPN'' gizli anahtarını adlandırın. Microsoft Entra'de oluşturulan uygulama kaydındaki gizli anahtarı kullanın ve bunu Değer alanına girip ardından Gizli anahtar ekle'yi seçin. Bu laboratuvarda daha sonra GitHub iş akışlarını tanımlamak için kullanılan YML dosyalarında gizli anahtara başvurulur.

   

   Gizli anahtar artık daha güvenli bir GitHub gizli anahtarı olarak depolanır.

Çözüm dosyasını yeni bir dala dışarı aktarmak ve paketini açmak için iş akışı oluşturma

1. Eylemler'i tıklatın ve bir iş akışı kendiniz ayarlayın veya bu depo bölümü için önerilen altında Basit iş akışı kutusunda Yapılandır'ı tıklatın.

   

2. Bu, GitHub Actions kullanmaya başlamanıza yardımcı olması için temel iş akışı içeren yeni bir YAML dosyası başlatacaktır.

   

3. Önceden oluşturulmuş içeriği silin, export-and-branch-solution-with-spn-auth.yml dosyasından içeriği yapıştırın ve ardından dosyayı 'export-and-branch-solution'.yml olarak yeniden adlandırın.

   

4. <ENVIRONMENTURL> öğesini, dışa aktarma işlemini yapmak istediğiniz geliştirme ortamının URL'si (örneğin: https://poweractionsdev.crm.dynamics.com) ile güncelleştirin.

5. <APPID> ve <TENANT ID> öğelerini değerlerinizle güncelleştirin.

   • Kimlik bilgileri kullanıyorsanız, export-and-branch-solution-with-spn-auth.yml dosya içerikleri yerine export-and-branch-solution.yml dosyasını yapıştırın. <USERNAME> öğesini, ortama bağlanmak için kullandığınız kullanıcı adı ile güncelleştirin.

     

   Bahşiş

   GitHub Actions'a aşina değilseniz ve daha fazla bilgi edinmek istiyorsanız https://docs.github.com/en/actions adresinde resmi belgelere bakın.

6. Artık değişikliklerinizi göndermeye hazırsınız. Göndermeyi başlat'ı seçin, başlık alanına Dışarı aktarma yml'si oluştur yazın ve açıklama ekleyin (isteğe bağlı). Sonra, Yeni dosya gönder'e tıklayın.

   

Tebrikler, aşağıdaki eylemleri kullanarak ilk GitHub akışınızı oluşturdunuz:

• Ben Kimim: Dışa aktardığınız ortama başarılı bir şekilde bağlanabilmenizi sağlar.
• Çözümü Dışa Aktar: Çözüm dosyasını geliştirme ortamınızdan dışarı aktarır.
• Çözümü Aç: Sunucudan dışarı aktarılan çözüm dosyası, birleştirilmiş yapılandırma dosyalarına sahip sıkıştırılmış (zip) bir dosyadır. Bu başlangıç dosyaları, kaynak kodu yönetimine uygun değildir. Bunun nedeni dosyaların, kaynak kodu yönetim sistemlerinin dosyaları ayırt etmesini ve kaynak denetimine göndermek istediğiniz değişiklikleri yakalamasını mümkün kılmak için yapılandırılmamış olmalarıdır. Kaynak denetimi depolama ve işleme işlemlerine uygun hale getirmek için çözüm dosyalarını "paketten çıkarmanız" gerekir.
• Dal Çözümü: Dışarı aktarılan çözümü depolamak için yeni bir dal oluşturur.

Dışarı aktarma ve paketi açma iş akışını test etme

1. Sonra, iş akışının çalıştığını test edin. Eylemler'e ve İş akışını çalıştır'a gidin ve İş akışını çalıştır'ı seçin. "ALMLab" dışında farklı bir çözüm adınız varsa buradaki değeri değiştirin ancak diğer değerleri olduğu gibi bırakın.

   

2. 5-10 saniye sonra iş akışı başlar ve ilerleme durumunu izlemek için çalışan iş akışını seçebilirsiniz.

   

   

3. İş akışı tamamlandıktan sonra çözüm, çözümler/ALMLab klasörüne çıkarılmışken yeni bir dalın oluşturulduğunu doğrulayın. Kod sekmesine gidin ve dallar açılır menüsünü genişletin.

4. Eylem tarafından oluşturulan dalı seçin.

5. Yeni dalda solutions/ALMLab klasörünün oluşturulduğunu doğrulayın ve sonra değişiklikleri ana dalda birleştirmek için bir Çekme isteği oluşturun. Katkıda Bulun'a tıklayın ve açılır pencerede Çekme İsteği Aç'a tıklayın .

6. Çekme isteği açekranında, istediğiniz gibi bir başlık ve açıklama ekleyin ve sonra Çekme isteği oluştur'u tıklatın.

7. Ekran güncelleştirilir ve yeni çekme isteğini gösterir. Çekme isteği oluşturulurken, dalımızın ana dalla çelişmez gösterildiğine ilişkin onay verilir. Bu onay, değişikliklerin ana dalla otomatik olarak birleştirilebileceği anlamına gelir. Birleştirme çekme isteği'ne tıklayın ve ardından Birleştirmeyi onayla'ya tıklayın. İsteğe bağlı olarak, şimdi işlevsiz dalı temizlemek için dalı sile tıklayın.

   

8. Varsayılan (ana) dala gidin ve çözümün ana dalda da mevcut olduğunu doğrulayın.

Derleme yapıtı oluşturmak ve bunu üretime aktarmak için yeniden kullanılabilir bir iş akışı oluşturma

Bu bölümde aşağıdakileri yapan ek bir iş akışı oluşturacağız:

• Bir yönetilen çözüm oluşturur ve GitHub yapıtı olarak yayımlar
• Derleme yapıtını üretim ortamına aktarır

1. Eylemler'e gidin ve Yeni iş akışı'nı seçin.

   

2. kendiniz iş akışı ayarlayın'ı seçin.

   

3. İş akışının başlığını 'release-solution-to-prod-with-inputs' olarak yeniden adlandırın ve release-solution-to-prod-with-inputs.yml dosyasının içeriğini kopyalayıp Yeni dosya düzenle ekranına yapıştırın.

   

4. Değişiklikleri gönderin. Göndermeye başla'yı seçin ve ardından başlık ve açıklama ekleyin (isteğe bağlı). Ardından Yeni dosya gönder'i seçin.

   

Release olayında yeniden kullanılabilir iş akışını çağırma

Bu bölümde, release olayında yeniden kullanılabilir iş akışını çağıracağız.

1. Eylemler'e gidin ve Yeni iş akışı'nı seçin.

   

2. Kendiniz bir iş akışı ayarlayın'ı seçin.

   

3. İş akışının başlığını 'release-action-call' olarak yeniden adlandırın ve release-action-call.yml dosyasının içeriğini kopyalayıp Yeni dosya düzenle ekranına yapıştırın.

   

4. Yeni iş akışı dosyasında aşağıdaki değişkenleri güncelleştirin:

   • <BUILD_ENVIRONMENT> öğesini, yönetilen çözümü oluşturmak için kullandığınız derleme ortamı URL'siyle güncelleştirin. Örneğin: https://poweractionsbuild.crm.dynamics.com.
   • <PROD_ENVIRONMENT> öğesini, dağıtım işlemini yaptığınız üretim ortamının URL'si ile güncelleştirin. Örneğin: https://poweractionsprod.crm.dynamics.com.
   • Bu eğiticide daha önce oluşturulan kayda tıklayarak, <APP_ID> bulunabilecek olan Uygulama (İstemci) Kimliğini ile güncelleştirin.
   • Bu eğiticide daha önce oluşturulan kayda tıklayarak, <TENANT_ID> bulunabilecek olan Dizin (Kiracı) Kimliğini ile güncelleştirin.

5. Değişiklikleri gönderin. Göndermeye başla'yı seçin ve ardından başlık (isteğe bağlı) ve açıklama ekleyin (isteğe bağlı). Ardından Yeni dosya gönder'i seçin.

   

Üretime yayınlama iş akışını test etme

Şimdi son iş akışını test etmeye hazırsınız. Bu iş akışı, üretime yeni bir sürüm dağıtıldığında tetiklenir.

1. Sürümler'e gidin.

   

2. Yeni sürüm taslağı oluştur'u seçin.

3. Sürüm etiketi, başlığı ekleyin ve Sürümü yayımla'yı seçin.

4. Çalışan iş akışını görüntülemek için Eylemler'i seçin.

   

5. Çalışırken eylemleri görüntülemek için çalışmakta olan iş akışını seçin.

   

6. Her eylemin tamamlanmasını bekleyin.

   

7. İş akışı tamamlandıktan sonra üretim ortamınızda oturum açın ve çözümün yönetilen çözüm olarak dağıtıldığını doğrulayın.

Güncelleştirmeyi dağıtın ve üretim sürümünden önce değişiklikleri inceleyin

Şimdi uçtan uca işlemi test edeceğiz ve üretim için dağıtılmadan önce uygulama üzerinde yapılan değişiklikleri nasıl görebildiğimizi ve doğrulayabildiğimizi öğreneceğiz.

1. Geliştirme ortamınızda ALMLab çözümüne gidin ve Düzenle'yi veya görünen ad çözümlerini tıklatın.

   

2. İzin İsteği tablosunu seçin ve görüntüleyin.

   

3. Aşağıdaki şekilde gösterildiği gibi + Sütun ekle'yi tıklatın ve yeni sütunu oluşturun.

   

   Güncelleştirilmiş Alan değerleri:**

   • görünen ad: Onaylandı
   • Veri türü: Evet/Hayır

4. Bitti'ye tıklayın.

5. Tabloyu kaydet'i tıklayın

6. GitHub depoları Eylemler sekmesine dönüp İş akışını çalıştır'ı seçin ve İş akışını çalıştır düğmesini seçin.

   

7. 5-10 saniye sonra iş akışı başlar ve ilerleme durumunu izlemek için çalışan iş akışına tıklayabilirsiniz.

   

   

8. İş akışı tamamlandıktan sonra, Kod ve ardından Dallar'ı seçerek yeni dala gidin.

   

9. Katkı'yı genişlet tarafından oluşturulan dalı seçin ve Çekme isteğini aç'a tıklayın.

10. Başlık ekleyin (isteğe bağlı) ve sonra Çekme isteği oluştur'a tıklayın.

11. İçerik güncelleştirmelerinden sonra, Dosyalar değiştirildi sekmesini tıklatın.

12. Çözümdeki değişikliklerin, dosyanın bu bölümünün ana daldaki aynı dosyaya kıyasla eklendiğini belirtmek için yeşil renkle vurgulandığına dikkat edin.

13. Konuşma sekmesine dönün. Çekme istekleri'ni seçin ve sonra önceden oluşturulan çekme isteğini seçin.

14. Çekme isteği sayfasında, güncelleştirilmiş çözüm dosyasını ana dalla birleştirmek için Sıkıştır ve birleştir'i seçin; isteğe bağlı olarak, artık ana dalda birleştirilmiş olan silin.

    

15. Yeni bir sürüm oluşturmak ve güncelleştirilmiş çözümün üretim ortamınıza dağıtıldığını doğrulamak için Üretime yayımlama iş akışını test etme bölümündeki adımları izleyin.

Tebrikler, GitHub eylemlerini kullanarak örnek bir CI/CD iş akışını başarıyla ayarladınız!

Ayrıca Bkz.

Fikir'den üretime kadar iş akışınızı otomatikleştirin