Tindakan GitHub tersedia untuk pembangunan Microsoft Power Platform
Tindakan GitHub untuk Microsoft Power Platform diterangkan dalam bahagian berikut. Di samping itu, sampel aliran kerja GitHub juga ditunjukkan. Untuk maklumat lanjut tentang Tindakan GitHub dan cara memuat turunnya, pergi ke Tindakan GitHub untuk Microsoft Power Platform.
Konfigurasikan kelayakan untuk digunakan dengan Tindakan GitHub dengan Microsoft Power Platform
Kebanyakan tindakan memerlukan anda untuk bersambung ke persekitaran Microsoft Dataverse. Anda boleh menambahkan kelayakan prinsipal perkhidmatan atau pengguna sebagai rahsia dalam repositori GitHub anda dan kemudian gunakannya dalam aliran kerja anda.
Untuk butiran mengenai cara untuk menyediakan rahsia dalam GitHub, lihat Rahsia yang disulitkan
Untuk mendapatkan butiran tentang cara menyediakan pengesahan prinsipal perkhidmatan untuk Microsoft Power Platform, lihat alat Devops Build
Sebaik sahaja dikonfigurasikan, anda boleh memanggil Prinsipal Perkhidmatan daripada dalam skrip tindakan anda.
Parameter untuk mentakrifkan dalam skrip Tindakan GitHub anda sebagai Pemboleh Ubah Persekitaran:
- ID aplikasi seperti:
WF_APPLICATION_ID:<your application id> - ID penyewa seperti:
WF_TENANT_ID:<your tenant id>
Rahsia pelanggan mesti ditambah dan disimpan sebagai Rahsia GitHub, dan akan dirujuk daripada dalam aliran kerja menggunakan parameter seperti: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Tugas pembantu
Tugas pembantu tersedia diterangkan di bawah.
tindakan-pemasangan
Apabila aliran kerja Tindakan GitHub memaksa pemasangan Power Platform CLI dalam konteks pelari, dan ralat tamat masa berlaku maka anda mesti menggunakan versi 1 (@v1) dengan tindakan tambahan (actions-install) seperti di bawah.
Penting
- Menggunakan versi 1 (@v1) mungkin membawa kepada kemas kini kepada tindakan GitHub sedia ada yang boleh menyebabkan aliran kerja semasa dikemas kini.
- Anda mesti menambah tugas Alat Power Platform Pasang sebagai tugas pertama dalam aliran kerja anda sebelum sebarang Tindakan GitHub lain untuknya Power Platform.
jobs:
builds:
runs-on: windows-latest # alternate runner OS is: ubuntu-latest
steps:
- name: Install Power Platform Tools
uses: microsoft/powerplatform-actions/actions-install@v1
- name: Export Solution
uses: microsoft/powerplatform-actions/export-solution@v1
with:
environment-url: 'https://myenv.crm.dynamics.com'
user-name: 'me@myenv.onmicrosoft.com'
password-secret: ${{ secrets.MYPASSWORD }}
solution-name: aSolution
solution-output-file: 'aSolution.zip'
working-directory: 'out'
Anda boleh mencari sampel tambahan Tindakan GitHub di Power Platform Tindakan.
whoAmI
Sahkan sambungan perkhidmatan dengan menyambung ke perkhidmatan dan menghantar permintaan WhoAmI [SDK/API Web]. Tugas ini berguna untuk memasukkan awal dalam aliran kerja GitHub anda, untuk mengesahkan kesambungan sebelum pemprosesan bermula.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | URL untuk persekitaran yang anda sambungkan. |
| nama-pengguna | Nama pengguna akaun yang anda guna untuk disambungkan. |
| rahsia-kata laluan | Kata laluan untuk nama pengguna. Kata laluan GitHub ditakrifkan dalam Tetapan di bawah Rahsia. Anda tidak boleh mendapatkan rahsia selepas ia telah ditakrifkan dan disimpan. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
Tugas penyelesaian
Tugas ini melaksanakan tindakan terhadap penyelesaian dan memasukkan perkara berikut.
import-penyelesaian
Imports penyelesaian ke dalam persekitaran sasaran.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran sasaran yang anda mahu import penyelesaian (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian yang anda mahu import. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
eksport-penyelesaian
Export penyelesaian daripada persekitaran sumber.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran sasaran yang anda mahu eksport penyelesaian (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, kata laluan untuknama pengguna. Kata laluan GitHub ditakrifkan dalam Tetapan di bawah Rahsia. Anda tidak boleh mendapatkan rahsia selepas ia telah ditakrifkan dan disimpan. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| nama-penyelesaian | (Diperlukan) Nama penyelesaian untuk dieksport. Sentiasa gunakan nama penyelesaian, bukannya nama paparan. |
| Fail-output-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian.zip untuk dieksport ke dalam persekitaran sasaran. |
| terurus | (Diperlukan) Ditetapkan ke benar untuk mengeksport sebagai penyelesaian terurus; (palsu) lalai adalah untuk mengeksport sebagai penyelesaian tidak terurus. |
buka-penyelesaian
Mengambil fail penyelesaian dimampatkan dan menggubahnya ke dalam berbilang fail XML supaya fail ini lebih mudah dibaca dan diurus oleh sistem kawalan sumber.
| Parameter | Penerangan |
|---|---|
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail bagi fail solution.zip file untuk dibuka. |
| folder-penyelesaian | (Diperlukan) Laluan dan folder sasaran yang anda mahu penyelesaian dibuka. |
| jenis-penyelesaian | (Diperlukan) Jenis penyelesaian yang anda mahu buka. Pilihan termasuk Tidak terurus (disyorkan), Terurus dan Kedua-duanya. |
pek-penyelesaian
Pekkan penyelesaian yang diwakili dalam kawalan sumber ke dalam fail solution.zip yang boleh diimport ke dalam persekitaran lain.
| Parameter | Penerangan |
|---|---|
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail bagi fail solution.zip untuk membungkus penyelesaian ke dalam (contohnya, out/CI/ALMLab.zip). |
| folder-penyelesaian | (Diperlukan) Laluan dan folder sumber penyelesaian untuk dipek. |
| jenis-penyelesaian | (Pilihan) Jenis penyelesaian untuk dibungkus. Pilihan termasuk Tidak terurus (disyorkan), Terurus dan Kedua-duanya. |
terbitkan-penyelesaian
Menerbitkan penyesuaian penyelesaian.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin terbitkan penyelesaian di dalamnya (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian yang anda mahu import. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
klonkan-penyelesaian
Klonkan penyelesaian untuk persekitaran yang diberikan.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin klonkan penyelesaian daripadanya (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian yang anda mahu import. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| nama-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian.zip yang diperlukan untuk diklon (contohnya, out/CI/ALMLab.zip). |
| versi-penyelesaian | Versi penyelesaian untuk diklon. |
| folder-sasaran | Folder sasaran untuk menempatkan penyelesaian yang diekstrak. (contohnya, repositori Git\tfolder-penyelesaian-sasaran). |
| direktori-kerja | Folder sementara untuk artifak kerja sedang berlaku diperlukan untuk pengklonan penyelesaian. lala: root of the repository |
semak-penyelesaian
Semak fail penyelesaian untuk mengesan percanggahan.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin klonkan penyelesaian daripadanya (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| laluan | (Diperlukan) Laluan dan nama fail penyelesaian yang anda ingin semak. |
| geo | Lokasi geo bagi perkhidmatan Penyemak Microsoft Power Platform untuk digunakan. Nilai lalai ialah 'amerika syarikat'. |
| ganti-tahap-peraturan | Laluan ke fail yang mengandungi jujukan JSON bagi peraturan dan tahap mereka. Nilai yang diterima adalah: Kritikal, Tinggi, Rendah dan Bermaklumat. Contoh: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| nama-artifak-log-penyemak | Nama folder artifak yang log penyemak Microsoft Power Platform akan dimuat naik. Nilai lalai ialah 'CheckSolutionLogs'. |
naik taraf-penyelesaian
Menyediakan keupayaan untuk menaik taraf penyelesaian.
| Parameter | Penerangan |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin klonkan penyelesaian daripadanya (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| fail-penyelesaian | (Diperlukan) Laluan dan nama fail penyelesaian yang anda mahu import. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| nama-penyelesaian | (Diperlukan) Nama penyelesaian untuk dinaik taraf. |
| tak segerak | Naik taraf penyelesaian secara tak segerak. |
| masa-tunggu-tak segerak-maks | Masa tunggu tak segerak maksimum dalam minit. Nilai lalai ialah 60 minit. |
Tugas pakej
Tugas ini menjalankan tindakan terhadap pakej dan termasuk yang berikut.
laksanakan-pakej
Menyediakan keupayaan untuk melaksanakan pakej dll atau fail zip dengan pakej.
Nota
Tindakan ini hanya disokong oleh Windows.
| Parameter_ | Description |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin klonkan penyelesaian daripadanya (contohnya, https://YourOrg.crm.dynamics.com). |
| nama-pengguna | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| rahsia-kata laluan | (Diperlukan) Jika anda menggunakan pengesahan nama pengguna/kata laluan, nama pengguna akaun yang anda gunakan untuk bersambung. |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| pakej | (Diperlukan) Laluan ke pakej dll atau fail zip dengan pakej. |
Tugas portal
Tugasan ini melaksanakan tindakan berikut terhadap Power Pages.
muat naik-paportal
Memuat naik data ke Power Pages.
| Parameter_ | Description |
|---|---|
| url-persekitaran | (Diperlukan) URL untuk persekitaran yang anda ingin import penyelesaian ke dalamnya (contohnya, https://YourOrg.crm.dynamics.com). |
| id-aplikasi | ID aplikasi untuk penentusahan dengan, Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| rahsia-pelanggan | Rahsia pelanggan yang digunakan untuk mengesahkan saluran paip GitHub. Parameter ini diperlukan apabila mengesahkan dengan kelayakan Utama Perkhidmatan. |
| id-penyewa | Menggunakan ID penyewa apabila mengesahkan app-id dan client-secret. |
| laluan muat naik | Laluan: yang mana kandungan tapak web akan disimpan (alias: -p). |
| profil pelaksanaan | Muat naik data portal dengan butiran persekitaran yang ditakrifkan melalui pemboleh ubah profil dalam deployment-profiles/[profile-name].deployment.yaml file. |
| Versi model | Menunjukkan sama ada data tapak yang hendak dimuat naik akan menggunakan standard (1) atau model2 data yang dipertingkatkan(). Nilai lalai ialah '1'. |
Ketahui lebih lanjut tentang Microsoft Power Platform sokongan CLI untuk Power Pages.
Tugas katalog (pratonton)
Tugas ini melakukan tindakan terhadap katalog dalam Power Platform dan termasuk yang berikut.
Nota
Pada masa ini, tugas katalog ialah Power Platform keluaran pratonton .
pasang
Pasang item katalog ke persekitaran sasaran.
| Parameter_ | Description |
|---|---|
| katalog-item-id | (Diperlukan) Item katalog yang akan dipasang pada persekitaran sasaran. |
| sasaran-url | (Diperlukan) Url persekitaran sasaran untuk pemasangan item katalog ke dalam (contohnya, "https://YourOrg.crm.dynamics.com"). |
| tetapan | (Diperlukan) Tetapan pakej Runtime untuk rangka kerja pemasangan untuk dilaksanakan. Format rentetan mestilah key=value|key=value. |
| Versi sasaran | Versi sasaran untuk dipasang. Jika dibiarkan kosong, versi yang diterbitkan dipilih. |
| Status undian | Tinjauan pendapat untuk menyemak status permintaan anda. |
serah
Senaraikan semua item katalog yang diterbitkan dari persekitaran semasa Dataverse (organisasi).
| Parameter_ | Description |
|---|---|
| laluan | (Diperlukan) Laluan ke dokumen penyerahan katalog. |
| pakej-zip | Laluan ke fail zip pakej. |
| solution-zip | Laluan ke fail zip penyelesaian. |
| Status undian | Tinjauan pendapat untuk menyemak status permintaan anda. |
status
Dapatkan status permintaan pemasangan/penyerahan katalog.
| Parameter_ | Description |
|---|---|
| Tracking-ID | (Diperlukan) Minta id penjejakan. |
| jenis | (Diperlukan) Jenis permintaan (Nilai: Pasang, Serah) |
Menganggu aliran kerja GitHub
Untuk mengetahui lebih lanjut tentang menggubah aliran kerja GitHub menggunakan tindakan GitHub, lengkapkan maklam Tindakan GitHub untuk Microsoft Power Platform.
Maklumat lanjut: Tentang Tindakan GitHub