Mengonfigurasi Akselerator ALM secara manual (Tidak digunakan lagi)

Note

Akselerator ALM tidak digunakan lagi dan tidak ada fitur baru yang ditambahkan. Masalah tidak lagi ditinjau atau ditangani.

Jika Anda mengidentifikasi potensi masalah keamanan, silakan laporkan ke Microsoft Security Response Center.

Gunakan Pipelines di Power Platform untuk menghadirkan kemampuan otomatisasi ALM ke Power Platform dan layanan Dynamics 365. Alur dapat digunakan dengan integrasi kode sumber atau diperluas untuk berintegrasi dengan Azure DevOps, GitHub, dan penyedia lainnya.

Anda dapat mengonfigurasi komponen ALM Accelerator for Power Platform baik menggunakan aplikasi administrasi yang menyertainya atau secara manual. Artikel ini memandu Anda mengonfigurasi aplikasi secara manual dan disusun dalam tujuh bagian:

Prerequisites

Sebelum menginstal ALM Accelerator for Power Platform, pastikan Anda telah memenuhi prasyarat berikut.

  • Akselerator ALM harus diinstal di lingkungan Power Platform yang memiliki database Microsoft Dataverse. Semua lingkungan yang Anda gunakan ALM Accelerator untuk menyebarkan solusi juga memerlukan database Dataverse.

    Note

    ALM Accelerator tidak kompatibel dengan Dataverse for Teams. Aplikasi ALM Accelerator dan alur terkait mengasumsikan bahwa Anda menggunakan versi lengkap Dataverse di semua lingkungan.

    Kami sarankan Anda menginstal ALM Accelerator di lingkungan yang sama dengan solusi CoE Starter Kit lainnya. Pelajari lebih lanjut cara menentukan strategi terbaik untuk organisasi Anda:

  • Akselerator ALM menggunakan Azure DevOps untuk kontrol sumber dan penyebaran. Jika Anda tidak memiliki organisasi Azure DevOps, daftar gratis hingga lima pengguna di situs Azure DevOps.

  • Untuk menyelesaikan langkah-langkah di bagian ini, Anda memerlukan pengguna dan izin berikut di Azure, Azure DevOps, dan Power Platform:

    • Pengguna Azure berlisensi dengan izin untuk membuat dan melihat grup Microsoft Entra, membuat pendaftaran aplikasi, dan memberikan persetujuan admin untuk pendaftaran aplikasi di Microsoft Entra ID
    • Pengguna Azure DevOps berlisensi dengan izin untuk membuat dan mengelola alur, koneksi layanan, repositori, dan ekstensi
    • Pengguna Power Platform berlisensi dengan izin untuk membuat pengguna aplikasi dan memberikan izin administratif kepada mereka

  • Konektor berikut ini harus tersedia untuk digunakan bersamaan di lingkungan tempat ALM Accelerator diimpor:

  • Instal Kit Kreator di lingkungan tempat Anda menginstal ALM Accelerator.

Penyiapan Fondasi

Langkah-langkah ini bersifat umum terhadap fungsionalitas ALM Accelerator, dan tidak bersifat spesifik-proyek atau solusi.

Membuat pendaftaran aplikasi di lingkungan Microsoft Entra Anda

Buat pendaftaran aplikasi untuk Akselerator ALM untuk memberikan izin aplikasi dan alur terkait yang diperlukan untuk melakukan operasi di Azure DevOps dan Power Apps atau Dataverse. Anda hanya perlu melakukan ini sekali.

Langkah-langkah berikut menunjukkan cara membuat satu pendaftaran aplikasi dengan izin untuk Dataverse dan Azure DevOps. Namun, Anda mungkin ingin membuat pendaftaran aplikasi terpisah untuk membagi tanggung jawab. Anda harus mempertimbangkan bagaimana pendaftaran aplikasi terpisah memengaruhi pemeliharaan dan keamanan sebelum memutuskan strategi pendaftaran aplikasi.

Membuat pendaftaran aplikasi

  1. Masuk ke portal Azure.

  2. Pilih Microsoft Entra ID>Registrasi Aplikasi.

  3. Pilih + Pendaftaran baru, kemudian berikan nama pendaftaran, seperti ALMAcceleratorServicePrincipal.

  4. Biarkan semua pilihan lain pada nilai default, lalu pilih Mendaftar.

Menambahkan izin ke pendaftaran aplikasi

  1. Di panel sisi kiri, pilih Izin API.

  2. Pilih + Tambahkan izin.

  3. Pilih Dynamics CRM, lalu pilih izin Delegasi dan user_impersonation.

  4. Pilih Tambahkan izin untuk menambahkan izin Dynamics CRM API user_impersonation ke pendaftaran aplikasi.

  5. Pilih lagi + Tambahkan izin.

  6. Pilih tab API yang digunakan organisasi saya. Cari dan pilih PowerApps-Advisor, lalu pilih Izin yang didelegasikan dan Analysis.All (persetujuan admin tidak diperlukan).

    Izin ini diperlukan untuk menjalankan analisis statis melalui pemeriksa aplikasi.

  7. Pilih Tambahkan izin untuk menambahkan izin PowerApps-Advisor API Analysis.All ke pendaftaran aplikasi.

  8. Pilih lagi + Tambahkan izin.

  9. Pada tab Microsoft API atau APIs yang digunakan organisasi saya tab, pilih Azure DevOps, lalu pilih izin Delegated dan user_impersonation.

    Izin ini diperlukan untuk menyambungkan ke Azure DevOps melalui konektor kustom di aplikasi ALM Accelerator.

  10. Jika Anda menambahkan izin Azure DevOps dari tab APIs yang digunakan organisasi saya, salin ID Application (klien) untuk digunakan nanti dalam prosedur ini.

    Anda akan menggunakannya sebagai ID Aplikasi (klien) DevOps, yang berbeda dari ID Aplikasi (klien) yang akan Anda salin nanti dalam prosedur ini.

    Cuplikan layar jendela Minta izin API, dengan tab API yang digunakan organisasi saya dan ID Aplikasi (klien) disorot.

    Jika Anda tidak dapat menemukan izin Azure DevOps pada tab APIs yang digunakan organisasi saya, ikuti langkah-langkah ini untuk mendapatkan ID Aplikasi DevOps (klien):

    1. Buka jendela browser privat dan buka https://dev.azure.com/<your devops organization>/_apis.
    2. Pada halaman login, salin nilai parameter client_id di URL.

    Cuplikan layar halaman masuk organisasi Azure DevOps, dengan parameter client_id di URL disorot.

  11. Pilih Tambahkan izin untuk menambahkan izin user_impersonation API Azure DevOps ke pendaftaran aplikasi.

  12. Pilih Berikan Izin Admin untuk <penyewa Anda>.

Mengonfigurasi rahasia klien dan mengalihkan URI

  1. Di panel sisi kiri, pilih Sertifikat & rahasia.

  2. Pilih + Rahasia klien baru.

  3. Pilih tanggal kedaluwarsa, lalu pilih Tambahkan.

  4. Salin Nilai rahasia klien untuk digunakan nanti. Ini adalah satu-satunya saat Anda dapat menyalin nilai. Pastikan untuk melakukannya sebelum Anda meninggalkan halaman.

  5. Di panel sisi kiri, pilih gambaran umum.

  6. Salin ID Aplikasi (klien) dan ID Direktori (penyewa).

  7. Pilih Konfigurasikan.

Berikan izin Power App Management untuk pendaftaran aplikasi Anda

Berikan izin Power App Management ke pendaftaran aplikasi Anda sehingga alur dapat melakukan tindakan yang mereka butuhkan di lingkungan Anda. Untuk melakukannya, jalankan cmdlet PowerShell berikut sebagai pengguna interaktif yang memiliki hak istimewa administratif Power Apps. Anda hanya perlu menjalankan perintah ini satu kali, setelah membuat pendaftaran aplikasi.

Important

Cmdlet PowerShell berikut memberikan izin yang ditingkatkan pendaftaran aplikasi seperti Admin Power Platform. Kebijakan keamanan organisasi Anda mungkin tidak mengizinkan jenis izin ini. Pastikan mereka diizinkan sebelum Anda melanjutkan. Jika tidak diizinkan, kemampuan tertentu tidak berfungsi di alur ALM Accelerator.

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>

Menginstal ekstensi Azure DevOps

Akselerator ALM menggunakan beberapa ekstensi Azure DevOps, termasuk beberapa ekstensi pihak ketiga yang tersedia di marketplace Azure DevOps. Situs web setiap ekstensi pihak ketiga dan tautan ke kode sumbernya disediakan dalam petunjuk berikut. Pelajari cara mengevaluasi penerbit ekstensi Marketplace.

  1. Masuk ke Azure DevOps.

  2. Pilih Pengaturan organisasi.

  3. Pilih Umum>Ekstensi.

  4. Cari dan instal ekstensi berikut:

Mengkloning alur YAML dari GitHub ke instans Azure DevOps Anda

  1. Buka https://aka.ms/coe-alm-accelerator-templates-latest-release dan salin URL rilis terbaru.

  2. Masuk ke Azure DevOps.

  3. Buat proyek atau pilih proyek yang sudah ada.

  4. Pilih Repositori, lalu pilih Apor repositori dalam daftar repositori.

  5. Tempelkan URL yang Anda salin di langkah 1 sebagai URL Kloning, lalu pilih Impor.

  6. Konfirmasikan cabang default untuk repositori adalah utama. Pilih Repositori dan Branches dan pastikan cabang main ditandai sebagai default.

    Jika tidak, pilih tiga titik vertikal (⋮) yang sesuai dengan cabang utama , dan dari menu Opsi lainnya, pilih Tetapkan sebagai cabang default.

    Note

    Repo adalah tempat dijalankannya template alur solusi dan alur ekspor/impor. Nantinya, saat membuat alur untuk solusi, Anda mungkin perlu mereferensikan proyek dan repo khusus ini jika Anda memilih untuk menggunakan repo lain untuk kontrol sumber solusi Anda.

Membuat alur untuk impor, penghapusan, dan ekspor solusi

Buat alur impor, hapus, dan ekspor berdasarkan YAML di repositori Azure DevOps. Alur ini berjalan saat Anda menggunakan aplikasi untuk menerapkan solusi ke Git, mengimpor solusi, atau menghapus solusi.

Note

Jika Anda berharap semua ekspor Anda melakukan tindakan yang sama, apa pun solusi yang digunakan untuk menjalankan alur, Anda dapat membuat satu alur ekspor seperti yang dijelaskan di bagian ini. Namun, Anda mungkin memerlukan tindakan ekspor yang berbeda berdasarkan solusinya. Dalam hal ini, Anda dapat menambahkan nama solusi ke alur export-solution-to-git, seperti export-solution-to-git-SampleSolution, agar aplikasi mengeksekusi alur solusi spesifik saat Anda melakukan tindakan di aplikasi.

Tabel berikut menunjukkan korespondensi antara file YAML di repositori dan alur yang menyertainya.

File YAML Nama alur
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. Di Azure DevOps, buka Pipelines>Buat Alur Baru.

  2. Pilih Azure Repos Git untuk repositori kode Anda, lalu arahkan ke repositori Azure DevOps yang Anda buat dan seeding dengan templat alur di langkah-langkah sebelumnya.

  3. Pada halaman Konfigurasi alur Anda, pilih File YAML Azure Pipelines yang ada dan arahkan ke /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml atau /Pipelines/delete-unmanaged-solution-and-components.yml.

  4. Pilih Lanjutkan lalu pilih Simpan.

  5. Pilih menu Lainnya (...) di samping Jalankan Alur, lalu pilih Ganti Nama/Pindahkan.

  6. Ubah nama alur menjadi export-solution-to-git, import-unmanaged-to-dev-environment, atau delete-unmanaged-solution-and-components, sebagaimana mestinya.

  7. Pilih Simpan.

Membuat variabel alur ekspor (opsional)

Anda dapat mengatur variabel alur opsional pada alur ekspor-solusi-ke-git untuk mengontrol informasi yang disimpan ke kontrol sumber. Untuk menerapkan pengaturan ini secara global, atur variabel pada alur export-solution-to-git. Untuk menerapkan pengaturan ke solusi tertentu saat ekspor, buat alur ekspor untuk solusi Anda seperti yang dijelaskan dalam catatan di bagian sebelumnya, dan atur variabel pada alur tersebut.

Untuk memastikan nilai variabel lingkungan saat ini tidak pernah dilakukan ke kontrol sumber selama proses ekspor, buat variabel DoNotExportCurrentEnvironmentVariableValues pada alur export-solution-to-git Anda dan atur nilainya ke True.

Important

Variabel alur ini direkomendasikan agar Anda dapat menggunakan fungsionalitas konfigurasi penyebaran dalam aplikasi ALM Accelerator.

Untuk memastikan nilai variabel lingkungan default tertentu diatur selama ekspor solusi, buat variabel VerifyDefaultEnvironmentVariableValues pada alur export-solution-to-git Anda dan atur nilainya ke True. Atur nilai variabel lingkungan default dalam customDeploymentSettings.json seperti yang dijelaskan dalam panduan konfigurasi penyebaran.

  1. Di Azure DevOps, pilih Pipelines>Library>Buat Grup Variabel baru.

  2. Beri nama grup variabel baru alm-accelerator-variable-group, persis seperti yang diberikan di sini.

    Alur akan merujuk ke grup variabel khusus ini, jadi namanya harus sama persis dengan yang ditunjukkan. Jika Anda memutuskan untuk menggunakan konvensi penamaan yang berbeda untuk grup variabel, Anda harus memodifikasi bagian alur agar merujuk ke nama yang Anda gunakan.

  3. Tambahkan variabel berikut ke grup variabel:

    Name Deskripsi Value
    AADHost Titik akhir otorisasi Microsoft Entra Untuk cloud publik, gunakan login.microsoftonline.com. Untuk cloud pemerintah, gunakan URL otorisasi yang sesuai.
    Aplikasi ProcessCanvas Apakah aplikasi kanvas dibongkar selama ekspor atau dikemas selama build Jika False, aplikasi kanvas tidak dibongkar selama ekspor atau dikemas selama build. Fungsionalitas pembongkaran dan pengemasan aplikasi kanvas sedang dalam pratinjau dan tidak disarankan untuk digunakan di lingkungan produksi saat ini. Namun, Anda tidak dapat melihat kode sumber kanvas di kontrol sumber kecuali Anda mengatur variabel ini ke True.

  4. (Opsional) Jika Anda menggunakan otomatisasi pengujian studio kanvas di alur, tambahkan variabel berikut ke grup variabel:

    Name Value
    TestAutomationLoginMethod CloudIdentity
    TestAutomationMakerPortalUrl URL dari portal pembuat Power Apps, biasanya *https://make.powerapps.com*
    TestAutomationUsername Akun pengguna yang digunakan untuk menjalankan pengujian otomatis
    TestAutomationPassword Kata sandi akun pengguna yang digunakan untuk menjalankan pengujian otomatis

  5. (Opsional) Secara default, variabel global dibatasi dan Anda harus mengonfigurasikan akses untuk setiap alur. Anda dapat menyederhanakannya dan mengizinkan akses untuk alur apa pun. Di bawah grup variabel (Alur>Pustaka>alm-accelerator-variable-group), pilih Izin alur di menu atas, pilih (…), , lalu pilih Akses terbuka.

Atur Izin untuk layanan build proyek

Important

Azure DevOps berisi sejumlah akun "Build Service", dan mungkin membingungkan saat Anda mengikuti langkah-langkah di bagian ini. Perhatikan dengan baik nama dan format yang disebutkan pada langkah 3 dan 5. Anda mungkin perlu mencari akun tertentu jika tidak ada dalam daftar awal.

  1. Di Azure DevOps, pilih pengaturan Proyek.

  2. Pilih Repositori>Keamanan.

  3. Di bawah Pengguna, cari dan pilih Layanan Build Kumpulan Proyek (Nama Organisasi Anda).

    Note

    Anda mungkin tidak melihat Nama Organisasi Anda setelah pengguna Layanan Build Kumpulan Proyek. Ini mungkin hanya pengenal unik. Dalam hal ini, gunakan fungsi pencarian untuk menemukan pengguna, lalu pilih.

  4. Atur izin berikut untuk pengguna layanan build:

    Persetujuan Value
    Berikan kontribusi Allow
    Berkontribusi menarik permintaan Allow
    Membuat cabang Allow
    Mengedit kebijakan Allow

  5. Di bawah Pengguna, cari dan pilih Nama Proyek Anda Layanan Build (Nama organisasi Anda).

  6. Tetapkan nilai yang sama seperti pada langkah 4.

  7. Pilih Alur, pilih tiga titik (...) di sudut kanan atas, lalu pilih Kelola Keamanan.

  8. Tetapkan izin berikut untuk pengguna Nama Proyek Layanan Build (Nama Organisasi Anda):

    Persetujuan Value
    Mengedit alur build Allow
    Mengedit kualitas bangunan Allow
    Mengelola antrean build Allow
    Menimpa validasi check-in dengan build Allow
    Memperbarui Informasi build Allow
    Melihat alur build Allow
    Melihat build Allow

  9. Pilih Pengaturan proyek>kumpulan agen, pilih Keamanan, lalu pilih Tambahkan.

  10. Cari dan pilih Nama Proyek Anda Layanan Build (Nama organisasi Anda).

  11. Atur peran ke Pembaca.

  12. Pilih Tambahkan.

  13. (Opsional) Default-nya, izin alur untuk setiap repositori dibatasi dan Anda harus mengonfigurasikan satu per satu. Anda dapat menyederhanakannya dan mengizinkan akses untuk alur apa pun. Di bawah Pengaturan Proyek>Repositori, pilih setiap repositori secara bergantian. Pilih Keamanan di menu bagian atas. Temukan blok Izin alur, pilih (...), lalu pilih Buka akses.

Konfigurasi proyek pengembangan

Bagian berikut memandu Anda dalam melakukan langkah-langkah konfigurasi yang diperlukan untuk mengatur setiap proyek pengembangan yang akan Anda dukung. Dalam konteks ini, proyek pengembangan terdiri dari infrastruktur dan konfigurasi yang mendukung manajemen siklus hidup aplikasi (ALM) yang sehat, termasuk konfigurasi lingkungan Dataverse yang mendukung proses ALM itu sendiri.

Membuat koneksi layanan untuk Azure DevOps mengakses Power Platform

Setiap lingkungan Dataverse—pengembangan, validasi, pengujian, dan produksi—harus memiliki koneksi layanan Power Platform dalam Azure DevOps. Lakukan langkah-langkah berikut untuk setiap lingkungan Anda.

Note

Pengguna aplikasi ALM Accelerator hanya melihat lingkungan di mana mereka memiliki peran pengguna atau administrator pada koneksi layanan di Azure DevOps. Jika mereka bekerja di lingkungan pengembangan pribadi, pembuat harus memiliki peran pengguna atau administrator di koneksi layanan untuk lingkungan pengembangan pribadi mereka. Koneksi layanan lingkungan validasi, pengujian, dan produksi seperti layanan build, hanya memerlukan izin yang diberikan ke alur.

  1. Masuk ke Azure DevOps, lalu pilih proyek Anda.

  2. Pilih Pengaturan proyek>Koneksi layanan, lalu pilih Buat koneksi layanan.

  3. Cari dan pilih jenis koneksi layanan Power Platform.

  4. Pilih Selanjutnya.

  5. Untuk URL Server, masukkan URL lingkungan Anda; misalnya, https://myorg.crm.dynamics.com/.

    Important

    Anda harus menyertakan garis miring ke depan (/) di URL; yaitu, setelah .com dalam contoh ini.

  6. Untuk Nama Koneksi Layanan, masukkan URL yang sama dengan yang Anda masukkan di langkah 4, termasuk garis miring ke depan pelatihan (/).

  7. Masukkan ID Tenant, ID Aplikasi (klien), dan Rahasia Client yang Anda salin dari Microsoft Entra saat Anda membuat pendaftaran aplikasi.

  8. Pilih Berikan izin akses ke semua alur.

  9. Pilih Simpan.

Koneksi layanan harus memberikan izin pengguna kepada semua pengguna di semua lingkungan yang harus dapat diakses pengguna dari aplikasi (misalnya, lingkungan pembuat).

  1. Dalam daftar Koneksi Layanan, pilih koneksi layanan yang akan dibagikan dengan pengguna.

  2. Pilih Lainnya(...) di sudut kanan atas, lalu pilih Keamanan .

  3. Dalam daftar Grup atau Pengguna, pilih pengguna atau grup yang ingin Anda berikan izin pengguna.

  4. Pilih Pengguna, pilih Peran, lalu pilih Tambah.

Ulangi langkah-langkah dalam bagian ini untuk setiap lingkungan pengembangan, validasi, pengujian, dan produksi.

Atur izin untuk layanan build proyek agar dapat menggunakan Koneksi Layanan

  1. Di Azure DevOps, pilih Pengaturan Proyek>Koneksi Layanan.

  2. Pilih (...) di sudut kiri atas, lalu pilih Keamanan, lalu pilih Tambahkan..

  3. Cari dan pilih Nama Proyek Anda Layanan Build (Nama organisasi Anda).

  4. Atur Peran ke Administrator, lalu pilih Tambahkan.

Buat pengguna aplikasi di lingkungan Dataverse Anda

Buat pengguna aplikasi di lingkungan Anda untuk memungkinkan alur terhubung ke Dataverse. Lakukan ini di setiap lingkungan yang Anda rencanakan untuk menggunakan ALM Accelerator untuk disebarkan.

  1. Masuk ke pusat admin Power Platform.

  2. Pilih lingkungan pengembangan Anda, lalu pilih Pengaturan.

  3. Pilih Pengguna + izin>Pengguna aplikasi.

  4. Pilih + pengguna baru.

  5. Pilih + Tambahkan aplikasi, pilih pendaftaran aplikasi yang Anda buat sebelumnya, lalu pilih Tambahkan.

  6. Pilih Unit Bisnis.

  7. Pilih ikon pensil di sebelah kanan Peran keamanan, lalu pilih peran keamanan untuk pengguna aplikasi.

    Sebaiknya berikan hak istimewa peran keamanan kepada administrator sistem pengguna aplikasi, agar pengguna dapat menjalankan fungsi yang diperlukan di setiap lingkungan.

  8. Pilih Buat.

Ulangi langkah-langkah ini di lingkungan validasi, pengujian, dan produksi Anda.

Konfigurasi solusi

Saat membuat solusi di Dataverse, Anda harus membuat alur khusus untuk solusi tersebut. Alur sampel berikut disertakan dalam direktori Alur di repositori coe-alm-templates:

Alur sampel memberikan fleksibilitas bagi organisasi untuk menyimpan template alur mereka dalam proyek atau repo terpisah dari alur solusi khusus YAML. Ikuti langkah-langkah di bagian ini untuk mengonfigurasi alur solusi Anda. Ulangi langkah-langkah ini untuk setiap solusi yang menggunakan ALM Accelerator untuk kontrol sumber.

Important

YAML untuk alur solusi Anda selalu disimpan dalam repo yang sama dengan yang Anda gunakan untuk kontrol sumber solusi Anda. Namun, template alur—yakni folder Pipeline\Templates—dapat berada di repo yang sama dengan YAML alur solusi Anda atau dalam repo atau proyek terpisah.

Membuat alur pembangunan dan penyebaran solusi

Alur solusi digunakan untuk membangun dan menyebarkan solusi yang dikontrol sumber Anda ke lingkungan di penyewa Anda. Alur sampel mengasumsikan Anda hanya menggunakan tiga lingkungan: validasi, pengujian, dan produksi. Namun, Anda dapat membuat alur solusi sebanyak yang diperlukan berdasarkan strategi lingkungan organisasi Anda.

Alur penyebaran sampel dipicu oleh perubahan pada cabang (yaitu, pengujian dan produksi) atau sebagai bagian dari kebijakan cabang di Azure DevOps (yaitu validasi). Pelajari selengkapnya tentang menetapkan kebijakan cabang untuk validasi penarikan permintaan. Anda juga dapat menjalankan alur secara manual, tanpa pemicu.

Ikuti langkah-langkah di bagian ini untuk membuat alur penyebaran dari alur sampel YAML. Tabel berikut menjelaskan konfigurasi alur.

Important

Nama alur harus persis seperti yang ditunjukkan dalam tabel berikut, dengan nama solusi Anda sebagai pengganti MyNewSolution.

Nama file YAML alur Nama alur Kebijakan cabang diaktifkan Required
build-deploy-validation-MyNewSolution.yml deploy-validation-MyNewSolution Yes Yes
build-deploy-test-MyNewSolution.yml deploy-test-MyNewSolution No Yes
build-deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No Tidak (Buka bagian berikutnya)

Note

Langkah-langkah berikut membuat dan menyebarkan alur untuk lingkungan validasi, pengujian, dan produksi. Namun, Anda mungkin ingin membangun dan menyebarkan untuk validasi dan pengujian, lalu menyebarkan artefak dari build uji ke produksi. Jika demikian, ikuti langkah-langkah di bagian ini hanya untuk lingkungan validasi dan pengujian Anda. Kemudian, lewati ke Membuat alur penyebaran solusi untuk mengonfigurasi alur rilis Anda.

Membuat file alur

  1. Di Azure DevOps, buka repositori dengan folder pipelines yang Anda kirimkan, dan pilih folder Pipelines.

  2. Buka salah satu dari tiga alur penyebaran sampel dan salin YAML untuk digunakan di alur baru Anda.

  3. Perhatikan nama repo yang akan digunakan di alur Anda.

  4. Buka repo yang ingin Anda gunakan untuk kontrol sumber solusi Anda.

  5. Buat cabang berdasarkan cabang default Anda dan beri nama untuk solusi Anda; misalnya, MyNewSolution.

    Cabang ini menjadi cabang versi Anda berikutnya (v-next) untuk solusi. Semua pekerjaan pengembangan harus dicabangkan dari cabang ini ke cabang kerja pribadi pengembang, kemudian digabungkan ke cabang v-next untuk mendorong proses ke validasi dan pengujian. Nantinya, setelah rilis siap, cabang v-next dapat digabungkan ke cabang utama atau default.

  6. Pilih Baru dari menu atas, lalu pilih Folder.

  7. Beri folder baru nama yang sama dengan solusi Anda.

  8. Beri nama file YAML alur baru, seperti build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml, atau build-deploy-prod-SampleSolution.yml.

  9. Pilih Buat.

Perbarui dan simpan file

  1. Tempelkan YAML yang Anda salin pada langkah 2 di bagian sebelumnya ke file alur baru.

  2. Ubah nilai berikut dalam YAML alur baru Anda:

    • Ubah Sumber daya>Repositori>nama ke nama repo yang berisi templat alur Anda.

      Pada contoh ini, repo diberi nama coe-alm-accelerator-templates dan berada di proyek yang sama dengan repo MyNewSolution. Jika repositori templat Anda berada dalam proyek Azure DevOps yang berbeda, gunakan format ProjectName/RepoName. Anda juga dapat menentukan cabang tempat templat Anda berada dengan menggunakan parameter ref jika perlu.

    • Ubah nilai apa pun yang mengacu pada SampleSolutionName ke nama unik solusi Anda; misalnya, MyNewSolution.

  3. Pilih Terapkan untuk menyimpan perubahan.

  4. Di Azure DevOps, buka Pipelines, lalu pilih Buat Alur Baru.

  5. Pilih Azure Repos Git untuk repositori kode Anda.

  6. Pilih repo DevOps yang berisi YAML alur penyebaran.

  7. Pada halaman Konfigurasi alur Anda, pilih Eksisting Azure Pipelines file YAML, arahkan ke file YAML dalam repositori yang Anda buat sebelumnya, lalu pilih Kontinue.

  8. Pilih Simpan, pilih (...) di samping Jalankan Alur, lalu pilih Ganti Nama/Pindahkan.

  9. Ubah nama alur menjadi deploy-validation-MyNewSolution, deploy-test-MyNewSolution, atau deploy-prod-MyNewSolution, di mana MyNewSolution adalah nama solusi Anda.

  10. Pilih Simpan.

  11. Jika alur baru Anda tidak dibuat di cabang default repositori: Pilih Edit di alur. Pilih (...) di sudut kanan atas, lalu pilih Pemicu. Pilih tab YAML, lalu pilih Dapatkan Sumber. Ubah cabang Default untuk build manual dan terjadwal untuk mengarah ke cabang solusi Anda. Pelajari selengkapnya tentang cara mengonfigurasi pemicu alur.

  12. Ulangi langkah-langkah sebelumnya untuk membuat alur penyebaran untuk setiap lingkungan Anda yang merujuk YAML alur penyebaran sampel dari repo coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml, dan deploy-prod-SampleSolution.yml).

  13. Pilih Simpan dan Antrekan, lalu pilih Simpan.

Membuat alur penyebaran solusi (opsional)

Seperti disebutkan sebelumnya, langkah-langkah dalam bagian sebelumnya membuat dan menyebarkan untuk lingkungan validasi, pengujian, dan produksi. Namun, Anda dapat membuat alur penyebaran solusi terpisah jika Anda ingin membangun dan menyebarkan hanya untuk validasi dan pengujian, lalu menyebarkan artefak dari build pengujian ke produksi.

Ikuti langkah-langkah di bagian ini untuk membuat alur penyebaran solusi dari alur sampel YAML. Tabel berikut menjelaskan konfigurasi alur.

Important

Nama alur harus persis seperti yang ditunjukkan dalam tabel berikut, dengan nama solusi Anda sebagai pengganti MyNewSolution.

Nama file YAML alur Nama alur Kebijakan cabang diaktifkan
deploy-prod-MyNewSolution.yml deploy-prod-MyNewSolution No

  1. Di Azure DevOps, buka repositori yang berisi folder pipelines yang Anda lakukan dan pilih folder Pipelines.

  2. Buka alur penyebaran sampel deploy-prod-pipelineartifact-SampleSolution.yml, dan salin YAML untuk digunakan dalam alur baru Anda.

  3. Perhatikan nama repo yang akan digunakan di alur Anda.

  4. Buka repo yang ingin Anda gunakan untuk kontrol sumber solusi Anda.

  5. Pilih Baru dari menu atas, lalu pilih File.

  6. Beri nama file YAML alur baru; misalnya, deploy-prod-MyNewSolution.yml, di mana MyNewSolution adalah nama solusi Anda.

  7. Pilih Buat.

  8. Tempelkan YAML yang Anda salin di langkah 2 ke dalam file alur baru.

  9. Ubah nilai berikut dalam YAML alur baru Anda:

    • Ubah Pemicu>Cabang>Sertakan ke cabang di mana perubahan harus memicu penyebaran ke produksi.

    • Ubah Sumber daya>Repositori>nama ke nama repo yang berisi templat alur Anda.

      Pada contoh ini, repo diberi nama coe-alm-accelerator-templates dan berada di proyek yang sama dengan repo MyNewSolution. Jika repositori templat Anda berada dalam proyek Azure DevOps yang berbeda, gunakan format ProjectName/RepoName. Anda juga dapat menentukan cabang tempat templat Anda berada dengan menggunakan parameter ref jika perlu.

    • Perbarui Sumber Daya>Alur>Sumber untuk menentukan alur build yang berisi artefak yang harus disebarkan alur ini. Dalam kasus ini, Anda akan menyebarkan artefak dari alur pengujian yang dibuat sebelumnya, yang membangun dan menyebarkan solusi Anda ke lingkungan pengujian.

    • Ubah nilai apa pun yang mengacu pada SampleSolutionName ke nama unik solusi Anda; misalnya, MyNewSolution.

  10. Ulangi langkah 11 hingga 20 di bagian sebelumnya untuk deploy-validation-ALMAcceleratorSampleSolution dan deploy-test-ALMAcceleratorSampleSolution, untuk membuat alur dari YAML alur produksi baru bernama deploy-prod-ALMAcceleratorSampleSolution.

Atur variabel alur penyebaran

Untuk setiap alur penyebaran yang telah Anda konfigurasi sebelumnya, Anda harus mengatur nilai variabel EnvironmentName dan ServiceConnection berdasarkan lingkungan tempat alur Anda disebarkan. Anda juga dapat mengatur variabel EnableFlows untuk menonaktifkan alur Power Automate sebagai bagian dari penyebaran.

Membuat variabel koneksi lingkungan dan layanan (wajib)

Setiap alur penyebaran memerlukan variabel lingkungan EnvironmentName dan variabel koneksi layanan ServiceConnection.

  • EnvironmentName menentukan lingkungan Azure DevOps yang sedang disebarkan untuk mengaktifkan riwayat penyebaran pelacakan dan menetapkan izin dan persetujuan untuk penyebaran ke lingkungan tertentu. Atur nilai ini ke Validasi, Uji, atau Produksi, sebagaimana mestinya.

  • ServiceConnection menentukan bagaimana alur penyebaran terhubung ke Power Platform. Nilai yang diizinkan adalah nama koneksi layanan yang Anda buat sebelumnya.

  1. Pilih Edit di setiap alur penyebaran.

  2. Pilih Variabel pada definisi alur penyebaran untuk membuka editor variabel.

  3. Untuk menambahkan variabel, pilih (+). Masukkan nama variabel dan nilai yang sesuai.

Ulangi langkah-langkah ini untuk membuat variabel EnvironmentName dan ServiceConnection.

Membuat variabel EnableFlows (opsional)

Anda dapat mengatur nilai variabel alur bernama EnableFlows ke False untuk melewati langkah-langkah yang secara otomatis mengaktifkan alur Power Automate sebagai bagian dari penyebaran. Nilai default variabel EnableFlows adalah True.

Atur kebijakan cabang untuk validasi penarikan permintaan

Buat kebijakan cabang untuk menjalankan alur yang Anda buat sebelumnya saat permintaan pull dibuat.

  1. Di Azure DevOps, buka folder Repositori, lalu pilih folder Branches.

  2. Temukan cabang yang ingin Anda buat kebijakan permintaan pull-nya. Pilih (...) di sebelah kanan cabang, lalu pilih Kebijakan Cabang.

  3. Di halaman Kebijakan Cabang, buka Validasi Build.

  4. Pilih + untuk menambahkan kebijakan cabang baru.

  5. Dalam daftar Alur build, pilih alur yang Anda buat sebelumnya.

  6. Tentukan filter Jalur jika berlaku untuk memastikan bahwa hanya perubahan pada jalur yang ditentukan yang memicu alur untuk permintaan pull.

  7. Atur Pemicu ke Otomatis.

  8. Atur Persyaratan kebijakan ke Diperlukan.

  9. Atur Waktu kedaluwarsa build ke Segera.

  10. Tentukan Nama tampilan kebijakan cabang Anda, misalnya Validasi Build PR.

  11. Pilih Simpan.

Cuplikan layar memilih pengaturan untuk kebijakan build validasi.

Atur izin akses sumber daya untuk alur

Alur memerlukan akses ke sumber daya yang diperlukan, seperti repositori, grup variabel, dan koneksi layanan, untuk berjalan. Untuk mengizinkan akses, Anda memiliki tiga opsi.

Berikan akses selama eksekusi pertama

Anda dapat mengizinkan akses ke sumber daya yang diperlukan selama eksekusi pertama alur.

  1. Picu alur dan buka alur yang dijalankan di Azure DevOps.
  2. Pilih Lihat di spanduk "izin diperlukan".
  3. Pilih Izin untuk setiap sumber daya yang diperlukan.

Berikan izin eksplisit

Anda dapat memberikan izin eksplisit untuk alur untuk mengakses repositori yang diperlukan.

  1. Di Azure DevOps, buka pengaturan Proyek.
  2. Pilih Repositori, lalu pilih repositori.
  3. Pilih tab Keamanan.
  4. Gulir ke bawah ke Izin alur dan pilih +.
  5. Pilih alur yang ingin Anda beri akses ke repositori.

Anda dapat memberikan izin eksplisit untuk alur untuk mengakses grup variabel yang diperlukan.

  1. Di Azure DevOps, pilih Pipelines>Library, lalu pilih grup variabel.
  2. Pilih Izin alur.
  3. Pilih +, lalu pilih alur yang akan diberi akses ke grup variabel.

Anda dapat memberikan izin eksplisit untuk alur untuk mengakses koneksi layanan yang diperlukan.

  1. Di Azure DevOps, buka pengaturan Proyek.
  2. Pilih Koneksi Layanan, lalu pilih koneksi layanan.
  3. Pilih tindakan lainnya (…), lalu pilih Keamanan.
  4. Gulir ke bawah ke Izin alur dan pilih +.
  5. Pilih alur yang ingin Anda berikan akses ke koneksi layanan.

Berikan akses ke semua alur

Anda dapat mengizinkan semua alur, baik yang Anda miliki sekarang maupun yang Anda buat di masa mendatang, untuk mengakses repositori yang diperlukan.

  1. Di Azure DevOps, buka pengaturan Proyek.
  2. Pilih Repositori, lalu pilih repositori.
  3. Pilih tab Keamanan.
  4. Gulir turun ke Izin alur.
  5. Pilih Tindakan lainnya (...), pilih Buka akses, lalu konfirmasi saat diminta.

Anda dapat mengizinkan semua alur mengakses grup variabel yang diperlukan.

  1. Di Azure DevOps, pilih Pipelines>Library, lalu pilih grup variabel.
  2. Pilih Izin alur.
  3. Pilih Tindakan lainnya (...), pilih Buka akses, lalu konfirmasi saat diminta.

Anda dapat mengizinkan semua alur mengakses koneksi layanan yang diperlukan.

  1. Di Azure DevOps, buka pengaturan Proyek.
  2. Pilih Koneksi Layanan, lalu pilih koneksi layanan.
  3. Pilih tindakan lainnya (…), lalu pilih Keamanan.
  4. Pilih koneksi layanan, pilih Tindakan lainnya (...), lalu pilih Keamanan.
  5. Gulir turun ke Izin alur.
  6. Pilih Tindakan lainnya (...), pilih Buka akses, lalu konfirmasi saat diminta.

Mengatur cakupan otorisasi pekerjaan

Cakupan otorisasi pekerjaan dapat diatur untuk seluruh organisasi Azure DevOps atau untuk proyek tertentu. Nonaktifkan pengaturan Batasi cakupan otorisasi pekerjaan ke proyek saat ini untuk jalur rilis, jika Anda memilih proyek Azure DevOps yang berbeda untuk menginstal templat.

Untuk mengatur cakupan otorisasi pekerjaan di tingkat organisasi untuk semua proyek

  1. Di Azure DevOps, pilih pengaturan Organisasi > Alur > Pengaturan.
  2. Nonaktifkan pengaturan Batasi cakupan otorisasi pekerjaan ke proyek saat ini untuk pengaturan alur rilis.

Membuat konfigurasi penyebaran (opsional)

Anda harus membuat beberapa konfigurasi dalam lingkungan target setelah solusi disebarkan. Konfigurasi ini khusus untuk lingkungan dan mencakup referensi koneksi, variabel lingkungan, dan izin untuk grup Microsoft Entra dan tim Dataverse, selain berbagi aplikasi kanvas dan memperbarui kepemilikan komponen solusi seperti alur Power Automate. Bersama konfigurasi ini, lingkungan target sering membutuhkan data konfigurasi atau sampel yang terkait dengan tabel Dataverse dalam solusi untuk memberikan pengalaman ALM yang menyeluruh.

Jika solusi Anda memerlukan konfigurasi atau data lain ini, ikuti panduan konfigurasi penyebaran untuk mengonfigurasi alur Anda berdasarkan lingkungan tempat Anda menyebarkan.

Impor solusi dan konfigurasi aplikasi

Impor aplikasi kanvas ALM Accelerator ke lingkungan Power Platform Anda, lalu konfigurasikan konektor kustom yang disertakan untuk Azure DevOps.

Menginstal ALM Accelerator di Dataverse

  1. Solusi ALM Accelerator bergantung pada Creator Kit. Instal Creator Kit sekarang.

  2. Unduh file solusi terkelola terbaru dari GitHub. Gulir ke bawah menuju Assets dan pilih CenterofExcellenceALMAccelerator_<versi> terbaru_managed.zip.

  3. Masuk ke Power Apps, lalu pilih lingkungan yang ingin Anda host aplikasi ALM Accelerator.

  4. Di panel sisi kiri, pilih Solusi.

  5. Pilih Impor solusi>Jelajahi, lalu jelajahi lokasi solusi terkelola yang telah Anda unduh dan pilih file.

  6. Pilih Selanjutnya, kemudian pilih Selanjutnya lagi.

  7. Pada halaman Koneksi, pilih atau buat koneksi untuk menyambungkan koneksi CDS DevOps ke Dataverse.

    Saat Anda membuat koneksi untuk HTTP dengan Microsoft Entra, gunakan Microsoft Graph untuk kedua parameter.

  8. Pilih Import.

Mengonfigurasi konektor kustom DevOps

  1. Pilih Data>Konektor Kustom>KustomAzureDevOps.

  2. Pilih Edit. Pada halaman Keamanan, pilih Edit, lalu atur bidang berikut:

    Name Value
    Jenis Autentikasi OAuth 2.0
    Penyedia identitas Azure Active Directory
    ID Pelanggan Application (client) ID yang Anda salin saat Anda membuat pendaftaran aplikasi
    Rahasia klien Nilai rahasia (klien) aplikasi yang Anda salin saat Anda membuat pendaftaran aplikasi
    ID Penyewa Biarkan nilai default, umum
    URL Sumber Daya ID (klien) Aplikasi DevOps yang Anda salin saat Anda menambahkan izin ke pendaftaran aplikasi Anda
    URL pengalihan Menghasilkan otomatis. Jika Anda melihat kotak centang "Perbarui ke URL pengalihan unik" di bawah "URL pengalihan", silakan centang kotaknya.

  3. Pilih Perbarui konektor.

Tambahkan 'URL pengalihan' sebagai 'URI pengalihan'

'URL pengalihan' yang dibuat secara otomatis dari bagian di atas perlu ditambahkan sebagai 'URI pengalihan' ke pendaftaran aplikasi.

  1. Kembali ke pendaftaran aplikasi yang Anda buat.

  2. Di panel sisi kiri, pilih gambaran umum.

  3. Pilih Tambahkan URI Pengalihan.

  4. Pilih + Tambahkan Platform dan pilih Web.

  5. Di bawah kotak teks URI Pengalihan, tempel 'URL pengalihan' yang dibuat secara otomatis yang disalin dari bagian di atas.

  6. Pilih Konfigurasikan.

Uji konektor kustom

  1. Buka menu Uji.

  2. Pilih Koneksi Baru, lalu ikuti petunjuk untuk membuat koneksi.

  3. Di Power Apps, pilih lingkungan Anda, lalu pilih Dataverse>Konektor Kustom>CustomAzureDevOps.

  4. Pilih Edit, buka halaman Pengujian, lalu temukan operasi GetOrganizations.

  5. Pilih Uji operasi.

  6. Konfirmasikan Response Status yang dikembalikan 200 dan bahwa isi Response adalah representasi JSON dari organisasi Azure DevOps Anda.

    Cuplikan layar pengaturan keamanan pengujian untuk konektor kustom Azure DevOps.

Menyiapkan pembuat untuk menggunakan aplikasi ALM Accelerator

Baca selengkapnya

  • Last updated on