Tutorial: Automasi penyebaran penyelesaian menggunakan GitHub Actions untuk Microsoft Power Platform

Dalam tutorial ini, anda akan mengetahui tentang cara untuk:

  • Cipta repositori GitHub baharu
  • Cipta dua aliran kerja GitHub dengan menggunakan GitHub Actions untuk Microsoft Power Platform

Aliran kerja boleh mengeksport aplikasi anda secara automatik (sebagai penyelesaian yang tidak terurus) daripada persekitaran pembangunan, menjana membina artifak (penyelesaian terurus) dan menggunakan aplikasi tersebut ke dalam persekitaran pengeluaran anda. Tutorial ini menggunakan penyelesaian ALMLab yang anda bina dan persekitaran yang anda sediakan dalam tutorial sebelumnya.

Tutorial berkaitan: Mari mulakan dan Bina aplikasi berpandukan model.

Cipta akaun GitHub

  1. Pergi ke https://github.com dan pilih Daftar atauMulakan percubaan percuma (atau log masuk jika anda mempunyai akaun sedia ada).

    Cipta akaun

  2. Selepas anda mencipta akaun anda, cipta repositori dengan memilih Cipta repositori atau Baru.

    Cipta repositori

    Anda mungkin melihat skrin pendaratan alternatif berikut:

    Cipta repositori baharu

  3. Cipta repositori baru anda dan namakan ia poweractionslab. Pastikan anda memilih Tambah fail README untuk memulakan repo dan pilih Cipta repositori.

    Mulakan repo.

Mencipta rahsia baharu untuk Pengesahan Prinsipal Perkhidmatan

  1. Pergi ke repositori anda dan pilih Tetapan. Kembangkan Rahsia, kemudian pilih Tindakan.

  2. Di halaman Rahsia , sebutkan rahsia PowerPlatformSPNitu. Masukkan rahsia klien dari pendaftaran aplikasi yang anda cipta dalam Microsoft Entra ke dalam medan Nilai, kemudian pilih Tambah rahsia. Anda akan merujuk rahsia klien dalam fail YML yang mentakrifkan aliran kerja GitHub kemudian dalam tutorial ini.

    Cipta rahsia prinsipal perkhidmatan baharu

    Rahsia klien kini disimpan dengan selamat sebagai rahsia GitHub.

Cipta aliran kerja untuk mengeksport dan membuka fail penyelesaian ke cawangan baharu

  1. Pilih Tindakan, kemudian pilih tetapkan aliran kerja sendiri. Atau, pilih Konfigurasikan dalam kotak Aliran kerja Mudah di bawah bahagian cadangan untuk repositori ini .

    Aliran kerja persediaan.

  2. Anda akan melihat fail YAML baru dengan aliran kerja asas untuk membantu anda memulakan tindakan GitHub.

    Fail sampel YML

  3. Padamkan kandungan yang telah dicipta, kemudian tampal kandungan tersebut dari fail export-and-branch-solution-with-spn-auth.yml . Tukar nama fail kepada export-and-branch-solution.yml.

    Namakan semula dan gantikan kandungan.

  4. Kemas kini <ENVIRONMENTURL> dengan URL untuk persekitaran pembangunan yang anda mahu eksportkan (contohnya: https://poweractionsdev.crm.dynamics.com).

  5. Kemas kini <APPID> dan <TENANT ID> dengan nilai anda.

    • Jika anda menggunakan kelayakan, tampal fail export-and-branch-solution.yml dan bukannya kandungan fail export-and-branch-solution-with-spn-auth.yml . Kemas kini <USERNAME> dengan nama pengguna yang anda gunakan untuk menyambung ke persekitaran.

      Namakan semula dan ganti kandungan

    Tip

    Jika anda tidak biasa dengan GitHub Actions dan ingin mengetahui lebih lanjut, sila semak dokumentasi rasmi di https://docs.github.com/en/actions.

  6. Anda kini bersedia untuk membuat perubahan. Pilih Mula laksanakan, taipkan Cipta eksport yml dalam medan tajuk dan kemudian tambah perihalan (pilihan). Seterusnya, pilih Laksanakan fail baharu.

    Mulakan komitmen.

Tahniah, anda telah mencipta aliran kerja GitHub pertama anda dengan menggunakan tindakan berikut:

  • Siapa Saya: Memastikan anda boleh berjaya menyambung ke persekitaran yang anda ingin eksport.
  • Penyelesaian Eksport: Mengeksport fail penyelesaian daripada persekitaran pembangunan anda.
  • Unpack Solution: Fail penyelesaian yang dieksport oleh pelayan adalah fail termampat (zip) dengan fail konfigurasi yang disatukan. Fail awal ini tidak sesuai untuk pengurusan kod sumber kerana ia tidak disusun untuk membolehkan sistem pengurusan kod sumber melakukan pembezaan dengan betul pada fail dan menangkap perubahan yang anda mahu komitkan ke kawalan sumber. Anda perlu membuka fail penyelesaian supaya sesuai untuk kawalan sumber, penyimpanan dan pemprosesan.
  • Penyelesaian Cawangan: Mencipta cawangan baharu untuk menyimpan penyelesaian yang dieksport.

Uji aliran kerja eksport dan membuka

  1. Seterusnya, uji jalanan aliran kerja. Pergi ke Tindakan, pilih Jalankan aliran kerja, dan pilih Jalankan aliran kerja. Jika anda menggunakan nama penyelesaian yang berbeza daripada ALMLab, tukar nilai di sini tetapi kekalkan nilai lain sama.

    Jalankan aliran kerja.

  2. Selepas 5–10 saat, aliran kerja bermula. Anda boleh memilih aliran kerja yang sedang berjalan untuk memantau kemajuan.

    Klik untuk melihat aliran kerja.

    Pilih dan lihat aliran kerja.

  3. Selepas aliran kerja selesai, periksa bahawa cawangan baru telah dicipta dengan penyelesaian telah dibuka ke solutions/ALMLab dalam folder. Pergi ke tab Kod dan kembangkan juntai bawah cabang.

  4. Pilih cabang yang dicipta oleh tindakan tersebut.

  5. Periksa bahawa solutions/ALMLab folder telah dicipta dalam cawangan baru. Kemudian, cipta permintaan tarik untuk menggabungkan perubahan ke dalam cawangan utama. Pilih Contribute dan dalam flyout pilih Open Pull request.

  6. Pada skrin Buka permintaan tarik , tambah tajuk dan penerangan jika anda mahu, kemudian pilih Cipta permintaan tarik.

  7. Skrin dikemas kini untuk menunjukkan permintaan tarik baru. Apabila anda membuat permintaan tarik, anda akan mendapat pengesahan bahawa cawangan anda tiada konflik dengan cawangan utama. Pengesahan ini bermakna anda boleh menggabungkan perubahan ke dalam cawangan utama secara automatik. Pilih Gabungkan permintaan tarik dan kemudian pilih Sahkan gabung. Secara pilihan, pilih padam cabang untuk membuang cabang yang kini sudah tidak berfungsi.

    Lihat cawangan

  8. Kembali ke cawangan lalai (utama) dan periksa sama ada penyelesaian tersedia di sana.

Cipta aliran kerja yang boleh diguna semula untuk menjana bina artifak dan mengimport ke pengeluaran

Dalam bahagian ini, cipta aliran kerja tambahan yang:

  • Mencipta penyelesaian terurus dan menerbitkannya sebagai GitHub artifak
  • Import artifak yang dibina ke dalam persekitaran pengeluaran

  1. Pergi ke Tindakan dan pilih Aliran kerja Baru.

    Buat aliran kerja baharu.

  2. Pilih tetapkan aliran kerja sendiri.

    Sediakan aliran kerja.

  3. Tukar nama tajuk aliran kerja kepada release-solution-to-prod-with-inputs. Salin kandungan dari fail release-solution-to-prod-with-inputs.yml dan tampal ke skrin Edit fail baru .

    Namakan semula dan tampal kod.

  4. Laksanakan perubahan. Pilih Mula laksanakan dan kemudian tambah tajuk dan perihalan (pilihan). Seterusnya, pilih Laksanakan fail baharu.

    Buat perubahan.

Panggil aliran kerja yang boleh diguna semula pada peristiwa keluaran

Dalam bahagian ini, anda memanggil aliran kerja boleh guna semula pada acara pelepasan.

  1. Pergi ke Tindakan dan pilih Aliran kerja Baru.

    Buat aliran kerja baharu.

  2. Pilih sediakan aliran kerja sendiri.

    Sediakan aliran kerja.

  3. Tukar nama tajuk aliran kerja kepada release-action-call. Salin kandungan dari fail release-action-call.yml dan tampal ke skrin Edit fail baru .

    Namakan semula dan tampal kod.

  4. Kemas kini pemboleh ubah berikut dalam fail aliran kerja baharu:

    • Kemas kini <BUILD_ENVIRONMENT> dengan URL untuk persekitaran binaan yang anda gunakan untuk menjana penyelesaian terurus. Sebagai contoh: https://poweractionsbuild.crm.dynamics.com.
    • Kemas kini <PROD_ENVIRONMENT> dengan URL untuk persekitaran produksi yang anda gunakan. Sebagai contoh: https://poweractionsprod.crm.dynamics.com.
    • Kemas kini <APP_ID> dengan ID Aplikasi (Klien) yang anda temui dalam blade App registrations Microsoft Azure Portal dengan memilih pendaftaran yang anda cipta sebelum ini dalam tutorial ini.
    • Kemas kini <TENANT_ID> dengan ID Direktori (tenant) yang anda temui dalam blade App registrations Microsoft Azure Portal dengan memilih pendaftaran yang anda cipta sebelum ini dalam tutorial ini.

  5. Laksanakan perubahan. Pilih Mula laksanakan dan kemudian tambah tajuk (pilihan) dan perihalan (pilihan). Seterusnya, pilih Laksanakan fail baharu.

    Buat perubahan.

Uji keluaran kepada aliran kerja pengeluaran

Anda kini bersedia untuk menguji aliran kerja terakhir. Aliran kerja ini akan dicetuskan apabila keluaran baharu dikeluarkan ke produksi.

  1. Pergi ke Releases.

    Navigasi ke keluaran.

  2. Pilih Draf keluaran baharu.

  3. Tambah tag keluaran, tajuk dan pilih Terbitkan keluaran.

  4. Pilih Tindakan untuk melihat aliran kerja yang berjalan.

    Pilih untuk melihat aliran kerja.

  5. Pilih aliran kerja yang berjalan untuk melihat tindakan apabila ia berjalan.

    Lihat aliran kerja.

  6. Tunggu setiap tindakan selesai.

    Lihat cawangan.

  7. Selepas aliran kerja selesai, log masuk ke persekitaran pengeluaran anda dan sahkan bahawa penyelesaian telah digunakan sebagai penyelesaian terurus.

Gunakan kemas kini dan semak perubahan sebelum keluaran pengeluaran

Uji proses hujung-ke-hujung, kemudian lihat bagaimana anda boleh melihat dan mengesahkan perubahan pada aplikasi sebelum anda melancarkannya ke produksi.

  1. Pergi ke penyelesaian ALMLab dalam persekitaran pembangunan anda dan pilih Edit atau pilih nama paparan penyelesaian.

    Edit penyelesaian.

  2. Pilih dan lihat Permintaan masa rehat.

    Lihat jadual.

  3. Pilih + Tambah lajur dan cipta lajur baru seperti yang ditunjukkan dalam rajah berikut.

    Tambah lajur.

    Nilai medan yang dikemas kini:**

    • Nama paparan: Diluluskan
    • Jenis data: Ya / Tidak

  4. Pilih Selesai.

  5. Pilih Simpan Jadual. Tambah lajur.

  6. Kembali ke tab Tindakan repositori GitHub anda, pilih Jalankan aliran kerja, dan pilih butang Jalankan aliran kerja.

    Jalankan aliran kerja.

  7. Selepas 5–10 saat, aliran kerja bermula. Pilih aliran kerja yang sedang berjalan untuk memantau kemajuannya.

    Pilih aliran kerja.

    Lihat aliran kerja.

  8. Selepas aliran kerja selesai, pergi ke cawangan baru dengan memilih Kod dan kemudian Cawangan.

    Navigasi ke cawangan.

  9. Pilih cabang yang anda cipta dengan mengembangkan contribute dan memilih Open pull request.

  10. Tambah tajuk (pilihan) dan kemudian pilih Cipta permintaan tarik.

  11. Selepas kemas kini kandungan, pilih tab Fail yang diubah .

  12. Perhatikan bahawa perubahan pada penyelesaian diserlahkan dengan hijau untuk menunjukkan bahawa bahagian fail ini ditambah apabila dibandingkan dengan fail yang sama dalam cawangan utama.

  13. Kembali ke tab Perbualan . Pilih Permintaan tarik dan kemudian pilih permintaan tarik yang anda buat sebelum ini.

  14. Pada halaman Pull request , pilih Squash and merge untuk menggabungkan fail penyelesaian yang dikemas kini ke cawangan utama anda. Secara pilihan, padam yang kini digabungkan ke main.

    Buka permintaan tarik untuk cawangan baharu, lihat perubahan dan gabungkan ke cawangan lalai

  15. Ikuti langkah-langkah dalam bahagian Aliran kerja Uji keluaran ke pengeluaran untuk mencipta keluaran baru dan sahkan bahawa penyelesaian yang dikemas kini telah digunakan ke persekitaran pengeluaran anda.

Tahniah, anda berjaya menyediakan aliran kerja CI/CD contoh menggunakan tindakan GitHub!

Lihat Juga

Automatikkan aliran kerja anda daripada idea kepada pengeluaran

  • Kali terakhir dikemas kini pada