Mengonfigurasi alur ALM Accelerator
Pipeline adalah mesin dari ALM Accelerator. Mereka mengotomatiskan proses ALM untuk Power Platform. Mereka dibangun menggunakan Azure Pipelines, layanan Azure DevOps, dan disimpan dalam proyek Azure DevOps .
Empat pipa utama digunakan untuk mengotomatisasi proses ALM:
- Import
- Export
- Delete
- Bangun/Terapkan
Pipeline dirancang untuk digunakan dengan aplikasi kanvas ALM Accelerator. Anda tidak perlu menggunakan aplikasi ini, tetapi kami merekomendasikannya. Aplikasi ini menyediakan antarmuka sederhana untuk memanggil alur dan cara untuk mengonfigurasinya tanpa harus memahami parameter yang mendasarinya.
Skenario alur ALM Accelerator umum
Alur dan aplikasi ALM Accelerator memiliki konfigurasi default yang memungkinkan Anda memulai ALM dengan cepat Power Platform. Alur dapat mencakup banyak skenario ALM yang berbeda untuk memenuhi persyaratan organisasi Anda. Bagian berikut menjelaskan beberapa skenario umum dan bagaimana mereka dapat dicakup melalui konfigurasi alur, profil penyebaran, dan langkah-langkah di aplikasi ALM Accelerator atau melalui alur secara langsung.
Instal alur di satu proyek dan kode sumber di proyek lain
Di aplikasi ALM Accelerator dan di profil penyebaran, Anda dapat menentukan proyek alur dan proyek sumber. Opsi dalam wizard penyiapan memungkinkan Anda menentukan proyek alur dan repositori terpisah. Opsi ini berguna jika Anda ingin menyegmentasikan penyimpanan solusi berdasarkan pengguna, struktur perusahaan, atau faktor lainnya. Dalam kebanyakan kasus, file YAML alur disimpan dalam proyek alur dan alur ekspor, impor, dan hapus dibuat dalam proyek tempat solusi dikontrol sumber.
Jalankan pipeline tanpa ALM Accelerator
Aplikasi kanvas ALM Accelerator menyediakan lapisan tombol yang mudah untuk menjalankan alur. Namun, Anda tidak memerlukan aplikasi untuk menjalankannya. Jika Anda ingin menggunakan alur yang independen dari aplikasi, jalankan langsung dari baris perintah. Anda juga dapat membangun aplikasi Anda sendiri. Gunakan konektor kustom untuk API, yang Azure DevOps disertakan dalam solusi ALM Accelerator, untuk memanggil alur menggunakanatau teknologi lainnya Power Automate . Power Platform
Dalam kedua kasus, jika Anda ingin menggunakan pipa secara independen, kuncinya adalah memahami parameter yang diteruskan kepada mereka.
Parameter alur
Parameter untuk import-unmanaged-to-dev-environment: Gunakan pipeline solusi impor untuk mengimpor solusi tidak terkelola dari kontrol sumber ke lingkungan pengembangan.
Tabel berikut menjelaskan parameter pipeline impor.
| Parameter | Contoh | Description |
|---|---|---|
| Project | Proyek Saya Azure DevOps | Nama proyek untuk mengimpor solusi |
| Repo | Repo Saya Azure DevOps | Nama repo untuk mengimpor solusi |
| SolutionName | MySolutionName | Nama solusi yang akan diimpor |
| me@example.com | Alamat email pengguna yang mengimpor solusi | |
| UserName | Terakhir, Pertama | Nama pengguna dari pengguna yang mengimpor solusi |
| Cabang | main | Cabang untuk membangun solusi dan mengimpor |
| ServiceConnectionName | MyServiceConnection | Nama koneksi layanan untuk digunakan untuk impor |
| ServiceConnectionUrl | example.crm.dynamics.com | URL lingkungan pembuat untuk impor |
| EnvironmentName | MyDevEnvironment | Digunakan untuk menemukan pengaturan penyebaran di alur penyebaran; Mengembalikan nama folder di bawah direktori konfigurasi di sumber solusi |
Parameter untuk delete-unmanaged-solution-and-components: Gunakan alur solusi hapus untuk menghapus solusi tidak terkelola dan semua komponennya dari lingkungan pengembangan.
Tabel berikut menjelaskan parameter alur penghapusan.
| Parameter | Contoh | Description |
|---|---|---|
| SolutionName | MySolutionName | Nama solusi yang akan dihapus |
| ServiceConnectionName | MyServiceConnection | Nama koneksi layanan untuk digunakan untuk solusi yang akan dihapus |
| ServiceConnectionUrl | example.crm.dynamics.com | URL lingkungan pembuat untuk solusi yang akan dihapus |
Parameter untuk export-solution-to-git: Gunakan pipeline solusi ekspor untuk mengekspor solusi ke repositori Git.
Tabel berikut menjelaskan parameter pipeline ekspor.
| Parameter | Contoh | Description |
|---|---|---|
| Project | Proyek Saya Azure DevOps | Nama proyek untuk mengekspor kode sumber solusi |
| Repo | Repo Saya Azure DevOps | Nama repo untuk mengekspor kode sumber solusi |
| SolutionName | MySolutionName | Nama solusi yang akan diekspor |
| me@example.com | Alamat email pengguna yang mengekspor solusi | |
| UserName | Terakhir, Pertama | Nama pengguna dari pengguna yang mengekspor solusi |
| CommitMessage | Perbaikan bug #1234 | Deskripsi tentang perubahan untuk disimpan pada penerapan dalam repositori |
| Cabang | main | Baik cabang sumber untuk membuat cabang dari atau cabang yang ada untuk berkomitmen |
| BranchToCreate | feature-1234 | Nama unik cabang baru untuk dibuat berdasarkan Branch parameter, jika perlu |
| ServiceConnectionName | MyServiceConnection | Nama koneksi layanan untuk digunakan untuk ekspor solusi |
| ServiceConnectionUrl | example.crm.dynamics.com | URL lingkungan pembuat tempat solusi tidak terkelola yang akan diekspor ada |
| Data | [Pengaturan Penyebaran JSON] | String JSON yang berisi pengaturan penyebaran yang akan digunakan untuk mengekspor dan mengonfigurasi alur penyebaran |
| PortalSiteName | MyPortalSite | Nama situs web Power Pages yang terkait dengan solusi untuk diekspor |
Sesuaikan versi solusi saat Anda menggunakan alur ALM Accelerator untuk mengekspor atau menyebarkannya
Secara default, solusi yang diekspor dan disebarkan diberi versi menggunakan nama yang ditentukan dalam file YAML alur penyebaran. Namun, alur ALM Accelerator memungkinkan Anda menyesuaikan versi solusi saat mengekspor atau menyebarkannya. Bagian berikut menjelaskan metode yang dapat Anda gunakan.
Pembuatan versi yang diekspor
Gunakan nomor versi yang diekspor oleh alur sebagai nomor versi di semua lingkungan yang disebarkan. Buat variabel bernama UseSolutionVersionFromDataverse di alur ekspor Anda atau variabel global di pustaka variabel untuk ALM Accelerator. Berikan nilai Benar. Variabel memastikan bahwa nomor versi yang diekspor dalam solusi Anda dipertahankan di lingkungan hilir dan tercermin dalam kontrol sumber Anda saat sumber solusi dikomit.
Logika penerapan versi kustom
Gunakan kait ALM Accelerator untuk mengatur versi solusi. Tambahkan logika kustom Anda ke build-solution-pack-pre-hook.yml templat untuk memanipulasi secara Solution.xml langsung atau dengan menggunakan alat lain seperti versi solusi pac.
Pembuatan versi templat kustom bring-your-own-templates
Kemampuan untuk membawa templat Anda sendiri untuk menghasilkan alur penyebaran memberikan fleksibilitas untuk pembuatan versi selama ekspor awal solusi. Sebagai contoh, buat salinan build-deploy-validation/test/prod-SampleSolution.yml dan ubah nama build dari default ke strategi penerapan versi berdasarkan nomor run atau build konfigurasi:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Setelah templat Anda terpasang, perbarui langkah-langkah penyebaran di profil penyebaran Anda untuk menunjukkannya.
Sesuaikan jumlah langkah penyebaran di alur dan nama lingkungan target
Mirip dengan pembuatan versi kustom dengan templat, kemampuan untuk membawa templat Anda sendiri untuk menghasilkan alur penyebaran memberikan lebih banyak fleksibilitas selama ekspor awal solusi. Tentukan proyek tempat templat Anda ada dan jalur ke templat yang akan digunakan untuk menghasilkan alur penyebaran. Pengaturan untuk proyek dan jalur berada di profil penyebaran dan tabel Langkah-langkah Penyebaran di aplikasi administrasi ALM Accelerator.
Jalur ke template relatif terhadap akar lokasi alur ekspor. Misalnya, jalur ke templat alur penyebaran lingkungan validasi default adalah /Pipelines/build-deploy-validation-SampleSolution.yml. Untuk menggunakan templat dalam proyek yang sama dengan alur ekspor, tentukan jalur sebagai /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Tabel berikut ini menjelaskan tempat penampung dalam templat untuk nilai khusus solusi yang diganti saat alur penyebaran dibuat.
| Placeholder | Description |
|---|---|
| SampleSolutionName | Nama solusi yang akan disebarkan |
| RepositoryContainingTheBuildTemplates | Repositori yang berisi template build yang akan digunakan untuk alur penyebaran |
| BranchContainingTheBuildTemplates | cabang yang berisi template build yang akan digunakan untuk alur penyebaran |
| alm-akselerator-variabel-grup | Grup variabel global yang digunakan templat build untuk alur penyebaran |
Kami menyarankan Anda menyalin build-deploy-validation/test/prod-SampleSolution.yml templat alur untuk mulai menggunakan templat kustom Anda sendiri.
Jalankan langkah-langkah kustom di alur Anda tanpa memodifikasi templat default
Templat alur ALM Accelerator memiliki beberapa titik ekstensi, atau kait, yang dapat Anda gunakan untuk menyesuaikan alur sambil meminimalkan kebisingan dari konflik gabungan dalam skenario peningkatan. Pelajari lebih lanjut tentang kait ALM Accelerator.
Mengaktifkan atau menonaktifkan tindakan tertentu dalam alur
Pipeline menggunakan variabel untuk menentukan apakah suatu tugas harus dijalankan atau tugas mana dari beberapa kemungkinan yang harus dijalankan. Tabel berikut menjelaskan variabel yang dapat Anda atur untuk alur individual atau, melalui alm-accelerator-variable-group, semua alur.
Catatan
Untuk mengatur variabel-variabel ini untuk solusi spesifik pada ekspor, buat alur ekspor tertentu berdasarkan templat alur ekspor. Beri nama. export-solution-to-git-{SolutionName} Aplikasi ALM Accelerator menggunakan pipeline ekspor ini untuk solusi daripada pipeline export-solution-to-git tujuan umum.
| Variabel | Default | Pipa | Description |
|---|---|---|---|
| GenerateDeploymentSettings | True | Export | Jika false, pengaturan penyebaran tidak dihasilkan dan disimpan dalam kontrol sumber. |
| UseDeploymentSettingsPlaceholders | True | Export | Jika false, pengaturan penyebaran tidak menggunakan tempat penampung, dan semua nilai untuk pengaturan penyebaran disimpan dalam deploymentSettings.json file dan customDeploymentSettings.json .PENTING: Informasi sensitif dapat disimpan dalam teks biasa di pengaturan penyebaran Anda. Setiap pengguna dengan akses ke kontrol sumber dapat membaca nilai-nilai ini. Berhati-hatilah jika Anda menetapkan nilai untuk variabel ini. |
| DisableFlows | False | Export | Jika benar, semua alur dinonaktifkan dalam kode sumber yang belum dibongkar sebelum melakukan. |
| UseSolutionVersionFromDataverse | False | Export | Jika benar, nomor versi yang diekspor dalam solusi Anda dipertahankan di lingkungan hilir. Nomor versi tercermin dalam kontrol sumber Anda saat sumber solusi diterapkan. |
| DoNotExportCurrentEnvironmentVariableValues | False | Export | Jika benar, nilai variabel untuk lingkungan saat ini dihapus dari kode sumber untuk solusi yang belum dibongkar. |
| PublishCustomizationsBeforeExport | True | Export | Jika false, penyesuaian tidak dipublikasikan sebelum solusi diekspor. Opsi ini berguna jika Anda bekerja di lingkungan bersama dan hanya ingin mengekspor penyesuaian terbaru yang dipublikasikan. |
| CacheDiaktifkan | True | Ekspor/Deploy | Jika salah, cache modul PowerShell dinonaktifkan. Opsi ini berguna jika alur Anda menjalankan pembersihan direktori cache setelah alur dijalankan. |
| ProcessCanvasApps | True | Ekspor/Deploy | Jika salah, aplikasi kanvas tidak dibongkar selama ekspor atau dikemas selama build. CATATAN: Fungsi membongkar kanvas dan mengemas saat ini dalam pratinjau. Ini tidak direkomendasikan untuk digunakan di lingkungan produksi saat ini. Namun, Anda tidak dapat melihat kode sumber kanvas di kontrol sumber kecuali Anda menetapkan variabel ini ke True. |
| DisableSolutionChecker | False | Sebarkan | Jika benar, pemeriksa solusi tidak berjalan pada setiap build yang dimulai melalui pull request. |
| LewatiSolusiImpor | False | Sebarkan | Jika benar, langkah impor solusi dilewati selama penyebaran. Namun, kegiatan lain seperti aktivasi aliran dan berbagi masih dilakukan. |