Tutorial: Mengotomatiskan penyebaran solusi dengan menggunakan GitHub Actions untuk Microsoft Power Platform

Dalam tutorial ini, Anda akan belajar cara:

  • Membuat repositori GitHub baru
  • Membuat dua alur kerja GitHub dengan menggunakan GitHub Actions untuk Microsoft Power Platform

Alur kerja dapat secara otomatis mengekspor aplikasi Anda (sebagai solusi tidak terkelola) dari lingkungan pengembangan, menghasilkan artefak build (solusi terkelola), dan menerapkan aplikasi ke lingkungan produksi Anda. Tutorial ini menggunakan solusi ALMLab yang Anda buat dan lingkungan yang Anda konfigurasikan di tutorial sebelumnya.

Tutorial terkait: Memulai, dan membuat aplikasi berbasis model.

Membuat akun GitHub

  1. Buka https://github.com dan pilih Daftar atau Mulai uji coba gratis (atau masuk jika Anda memiliki akun yang sudah ada).

    Buat akun

  2. Setelah Anda membuat akun, buat repositori dengan memilih Buat repositori atau Baru.

    Buat repositori

    Anda mungkin melihat layar awal alternatif berikut:

    Buat repositori baru

  3. Buat repositori baru Anda dan beri nama poweractionslab. Pastikan Anda memilih Tambahkan file README untuk memulai repositori dan pilih Buat repositori.

    Mulai repo.

Membuat rahasia baru untuk Otentikasi Service Principal

  1. Buka repositori Anda dan pilih Pengaturan . Perluas Secrets, lalu pilih Actions.

  2. Pada halaman Rahasia , beri nama rahasia PowerPlatformSPN. Masukkan rahasia klien dari pendaftaran aplikasi yang Anda buat di Microsoft Entra ke bidang Nilai, lalu pilih Tambahkan rahasia. Anda akan mereferensikan rahasia klien dalam file YML yang menentukan alur kerja GitHub nanti dalam tutorial ini.

    Buat rahasia prinsipal layanan

    Rahasia klien sekarang disimpan dengan aman sebagai rahasia GitHub.

Buat workflow untuk mengekspor dan mengekstrak file solusi ke cabang baru

  1. Pilih Tindakan, lalu pilih siapkan alur kerja sendiri. Atau, pilih Konfigurasikan dalam kotak Alur kerja sederhana di bawah bagian yang disarankan untuk repositori ini .

    Siapkan alur kerja.

  2. Anda melihat file YAML baru dengan alur kerja dasar untuk membantu Anda mulai menggunakan GitHub Actions.

    Sampel file YML

  3. Hapus konten yang dibuat sebelumnya, lalu tempelkan konten dari file export-and-branch-solution-with-spn-auth.yml . Ganti nama file menjadi export-and-branch-solution.yml.

    Ubah nama dan ganti konten.

  4. Perbarui <ENVIRONMENTURL> dengan URL untuk lingkungan pengembangan yang ingin Anda ekspor darinya (misalnya: https://poweractionsdev.crm.dynamics.com).

  5. Perbarui <APPID> dan <TENANT ID> dengan nilai Anda.

    • Jika Anda menggunakan kredensial, tempelkan file export-and-branch-solution.yml alih-alih konten file export-and-branch-solution-with-spn-auth.yml . Perbarui <USERNAME> dengan nama pengguna yang Anda gunakan untuk menyambungkan ke lingkungan.

      Mengubah nama dan mengganti konten

    Tip

    Jika Anda tidak terbiasa dengan GitHub Actions dan ingin mempelajari lebih lanjut, lihat dokumentasi resmi di https://docs.github.com/en/actions.

  6. Anda sekarang siap untuk melakukan commit pada perubahan Anda. Pilih mulai commit, ketik buat ekspor yml di bidang judul, lalu tambahkan deskripsi (opsional). Selanjutnya, pilih commit file baru.

    Mulai commit.

Selamat, Anda baru saja membuat alur kerja GitHub pertama dengan menggunakan tindakan berikut:

  • Siapa saya: Memastikan bahwa Anda berhasil terhubung ke lingkungan tempat Anda ingin mengekspor.
  • Ekspor Solusi: Mengekspor file solusi dari lingkungan pengembangan Anda.
  • Solusi Terbongkar : File solusi yang diekspor server adalah file terkompresi (zip) dengan file konfigurasi terkonsolidasi. File awal ini tidak cocok untuk manajemen kode sumber karena tidak terstruktur untuk membuatnya layak bagi sistem manajemen kode sumber untuk melakukan pembedaan dengan benar pada file dan menangkap perubahan yang ingin Anda lakukan ke kontrol sumber. Anda harus membongkar file solusi agar sesuai untuk penyimpanan dan pemrosesan sumber kontrol.
  • Solusi Cabang: Membuat cabang baru untuk menyimpan solusi yang diekspor.

Uji alur kerja ekspor dan bongkar

  1. Selanjutnya, uji bahwa alur kerja berjalan. Buka Aksi, pilih Jalankan alur kerja, dan pilih Jalankan alur kerja. Jika Anda menggunakan nama solusi yang berbeda dari ALMLab, ubah nilai di sini tetapi pertahankan nilai lain tetap sama.

    Jalankan alur kerja.

  2. Setelah 5–10 detik, alur kerja dimulai. Anda dapat memilih alur kerja yang sedang berjalan untuk memantau kemajuan.

    Klik untuk melihat alur kerja.

    Pilih dan tampilkan alur kerja.

  3. Setelah alur kerja selesai, periksa apakah cabang baru dibuat dengan solusi yang diekstrak ke folder solutions/ALMLab. Buka tab Kode lalu perluas drop-down cabang.

  4. Pilih cabang yang dibuat oleh tindakan.

  5. Periksa apakah solutions/ALMLab folder dibuat di cabang baru. Kemudian, buat pull request untuk menggabungkan perubahan ke cabang utama. Pilih Contribute dan di flyout pilih Open Pull request.

  6. Pada layar Buka pull request, tambahkan judul dan deskripsi jika Anda mau, lalu pilih Buat pull request.

  7. Layar diperbarui untuk menampilkan pull request baru. Saat Anda membuat pull request, Anda mendapatkan konfirmasi bahwa cabang Anda tidak memiliki konflik dengan cabang utama. Konfirmasi ini berarti Anda dapat menggabungkan perubahan ke cabang utama secara otomatis. Pilih Gabungkan permintaan pull lalu pilih Konfirmasi penggabungan. Opsional, pilih Hapus cabang untuk menghapus cabang yang kini sudah tidak aktif.

    Lihat cabang

  8. Kembali ke cabang default (utama) dan periksa apakah solusi tersedia di sana.

Buat alur kerja yang dapat digunakan kembali untuk menghasilkan artefak build dan mengimpor ke lingkungan produksi

Di bagian ini, buat alur kerja tambahan yang:

  • Membuat solusi terkelola dan menerbitkannya sebagai artefak GitHub
  • Mengimpor artefak Build ke lingkungan produksi

  1. Buka Tindakan lalu pilih Alur kerja baru.

    Buat alur kerja baru.

  2. Pilih siapkan alur kerja sendiri.

    Siapkan alur kerja.

  3. Ganti nama judul alur kerja menjadi release-solution-to-prod-with-inputs. Salin konten dari file release-solution-to-prod-with-inputs.yml dan tempelkan ke layar Edit file baru .

    Ganti nama dan tempel kode.

  4. Commit perubahan tersebut. Pilih mulai commit lalu tambahkan judul dan deskripsi (opsional). Selanjutnya, pilih commit file baru.

    Terapkan perubahan.

Panggil alur kerja yang dapat digunakan kembali pada aktivitas rilis

Di bagian ini, Anda akan memanggil alur kerja yang dapat digunakan kembali pada peristiwa rilis.

  1. Buka Tindakan lalu pilih Alur kerja baru.

    Buat alur kerja baru.

  2. Pilih konfigurasi alur kerja sendiri.

    Siapkan alur kerja.

  3. Ganti nama judul alur kerja menjadi release-action-call. Salin konten dari file release-action-call.yml dan tempelkan ke layar Edit file baru .

    Ganti nama dan tempel kode.

  4. Perbarui variabel berikut dalam file alur kerja baru:

    • Perbarui <BUILD_ENVIRONMENT> dengan URL untuk lingkungan build yang Anda gunakan untuk menghasilkan solusi terkelola. Misalnya: https://poweractionsbuild.crm.dynamics.com.
    • Perbarui <PROD_ENVIRONMENT> dengan URL untuk lingkungan produksi yang menjadi tujuan deployment Anda. Misalnya: https://poweractionsprod.crm.dynamics.com.
    • Perbarui <APP_ID> dengan ID Aplikasi (Klien) yang Anda temukan di bilah Pendaftaran aplikasi Microsoft portal Azure dengan memilih pendaftaran yang Anda buat sebelumnya dalam tutorial ini.
    • Perbarui <TENANT_ID> dengan ID Direktori (penyewa) yang Anda temukan di blade Pendaftaran aplikasi di Microsoft portal Azure dengan memilih pendaftaran yang Anda buat sebelumnya dalam tutorial ini.

  5. Commit perubahan tersebut. Pilih Start commit lalu tambahkan judul (opsional) dan deskripsi (opsional). Selanjutnya, pilih commit file baru.

    Terapkan perubahan.

Uji alur kerja rilis ke produksi

Anda sekarang siap untuk menguji alur kerja terakhir. Alur kerja ini dipicu ketika rilis baru disebarkan ke produksi.

  1. Buka Rilis.

    Buka halaman rilis.

  2. Pilih Buat draf rilis baru.

  3. Tambahkan tag rilis, judul, dan pilih Publikasikan rilis.

  4. Pilih tindakan untuk melihat alur kerja yang sedang berjalan.

    Pilih untuk melihat alur kerja.

  5. Pilih alur kerja yang sedang berjalan untuk melihat tindakan saat dijalankan.

    Lihat alur kerja.

  6. Tunggu hingga setiap tindakan selesai.

    Lihat cabang.

  7. Setelah alur kerja selesai, masuk ke lingkungan produksi Anda dan validasi bahwa solusi disebarkan sebagai solusi terkelola.

Terapkan pembaruan dan tinjau perubahan sebelum rilis produksi

Uji proses end-to-end, lalu lihat bagaimana Anda dapat melihat dan memvalidasi perubahan pada aplikasi sebelum menyebarkannya ke produksi.

  1. Masuk ke solusi ALMLab di lingkungan pengembangan Anda dan pilih Edit atau pilih nama tampilan solusi.

    Edit solusi.

  2. Pilih dan lihat tabel Permintaan Cuti.

    Lihat tabel.

  3. Pilih + Tambahkan kolom dan buat kolom baru seperti yang diperlihatkan dalam gambar berikut.

    Tambah kolom.

    Nilai Bidang yang Diperbarui:**

    • Nama tampilan: Disetujui
    • Jenis data: Ya/Tidak

  4. Pilih Selesai.

  5. Pilih Simpan Tabel. Tambahkan kolom.

  6. Kembali ke tab Tindakan repositori GitHub Anda, pilih Jalankan alur kerja, lalu pilih tombol Jalankan alur kerja.

    Jalankan alur kerja.

  7. Setelah 5–10 detik, alur kerja dimulai. Pilih alur kerja yang sedang berjalan untuk memantau kemajuannya.

    Pilih alur kerja.

    Lihat alur kerja.

  8. Setelah alur kerja selesai, buka cabang baru dengan memilih Kode lalu Cabang.

    Navigasikan ke cabang.

  9. Pilih cabang yang Anda buat dengan memperluas kontribusi lalu memilih Buka permintaan pull.

  10. Tambahkan judul (opsional) lalu pilih Buat permintaan pull.

  11. Setelah pembaruan konten, pilih tab File yang diubah .

  12. Perhatikan bahwa perubahan pada solusi disorot dengan warna hijau untuk menunjukkan bahwa bagian file ini ditambahkan jika dibandingkan dengan file yang sama di cabang utama.

  13. Kembali ke tab Percakapan. Pilih Permintaan pull, lalu pilih permintaan pull yang Anda buat sebelumnya.

  14. Pada halaman Pull request, pilih Squash and merge untuk menggabungkan file solusi yang diperbarui ke cabang utama Anda. Secara opsional, hapus cabang yang kini digabungkan ke cabang utama.

    Buka permintaan pull untuk cabang baru, lihat perubahan, dan gabungkan ke cabang default

  15. Ikuti langkah-langkah di bagian Alur kerja menguji rilis ke produksi untuk membuat rilis baru dan memvalidasi bahwa solusi yang diperbarui disebarkan ke lingkungan produksi Anda.

Selamat, Anda berhasil menyiapkan sampel alur kerja CI/CD dengan menggunakan GitHub Actions!

Lihat Juga

Otomatiskan alur kerja Anda dari ide hingga produksi

  • Terakhir diperbarui pada