Piezīmes
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt pierakstīties vai mainīt direktorijus.
Lai piekļūtu šai lapai, ir nepieciešama autorizācija. Varat mēģināt mainīt direktorijus.
Turpmākajās sadaļās aprakstītas GitHub Actions for Microsoft Power Platform. Sadaļās ir arī parādīti GitHub darba plūsmas paraugi. Lai iegūtu vairāk informācijas par GitHub Actions un to lejupielādi, skatiet GitHub Actions for Microsoft Power Platform.
Konfigurēt akreditācijas datus izmantošanai ar GitHub darbībām ar Microsoft Power Platform
Daudzām darbībām ir nepieciešams savienojums ar Microsoft Dataverse vidi. Pievienojiet pakalpojuma galveno vai lietotāja akreditācijas datus kā noslēpumus savā GitHub repozitorijā un pēc tam izmantojiet tos savās darba plūsmās.
Sīkāku informāciju par to, kā izveidot noslēpumus GitHub, skatiet sadaļā Šifrētie noslēpumi.
Lai uzzinātu, kā iestatīt pakalpojuma galvenā autentifikāciju Microsoft Power Platform, skatiet DevOps Build rīkus.
Pēc akreditācijas konfigurēšanas varat izsaukt pakalpojuma galveno no saviem darbību skriptiem.
Definējiet šādus parametrus savā GitHub Action Script kā vides mainīgos:
- Lietojumprogrammas ID, piemēram:
WF_APPLICATION_ID:<your application id> - Īrnieka ID, piemēram:
WF_TENANT_ID:<your tenant id>
Pievieno klienta noslēpumu kā GitHub noslēpumu. Atsaucies uz to no darba plūsmas iekšienes, izmantojot parametru, piemēram: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Palīga uzdevumi
Pieejams šāds palīga uzdevums.
Darbības-instalēšana
Kad GitHub Actions darba plūsma piespiež instalēt Power Platform CLI skrējēja kontekstā un rodas laika limita kļūda, izmantojiet versiju 1 (@v1) ar papildu darbību (actions-install), kā parādīts nākamajā piemērā.
Svarīgi
- Izmantojot 1. (@v1) versiju, var tikt atjauninātas esošās GitHub darbības, kā rezultātā pašreizējās darbplūsmas var tikt atjauninātas.
- Pievienojiet uzdevumu Install Power Platform Tools kā pirmo uzdevumu savā darba plūsmā pirms jebkura cita GitHub Actions for Power Platform veikšanas.
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'
Vairāk GitHub Actions piemēru varat atrast Power Platform Actions vietnē.
WhoAmI
Pārbauda servisa savienojumu, izveidojot savienojumu ar servisu un nosūtot WhoAmI [SDK/Tīmekļa API] pieprasījumu. Šo uzdevumu var būt noderīgi iekļaut agrīnā GitHub darba plūsmā, lai pārbaudītu savienojamību pirms apstrādes sākuma.
| Parametrs | Apraksts |
|---|---|
| vides URL | Tās vides URL, ar kuru veidojat savienojumu. |
| lietotājvārds | Tā uzņēmuma lietotājvārds, ko izmantojat, lai izveidotu savienojumu. |
| parole-noslēpums | Parole lietotājvārdam. Definējiet GitHub paroles iestatījumos sadaļā Secrets. Tu nevari atgūt noslēpumu pēc tam, kad esi to definējis un saglabājis. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
Risinājuma uzdevumi
Šie uzdevumi veic darbības ar risinājumiem un ietver tālāk norādītās darbības.
import-solution
Importējot risinājumu mērķa vidē.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) Vietrādis URL mērķa videi, kurā vēlaties importēt risinājumu. (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| risinājuma fails | (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
export-solution
Eksportē risinājumu no avota vides.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) Vietrādis URL mērķa videi, no kuras vēlaties eksportēt risinājumu. (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | (Obligāts) Ja izmantojat lietotājvārdu/paroles autentifikāciju, parole lietotājvārdam. Definējiet GitHub paroles iestatījumos sadaļā Secrets. Tu nevari atgūt noslēpumu pēc tam, kad esi to definējis un saglabājis. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| risinājuma nosaukums | (Nepieciešams) Eksportējamā risinājuma nosaukums. Vienmēr izmantojiet risinājuma nosaukumu, nevis tā parādāmo nosaukumu. |
| risinājuma izvades fails | (Nepieciešams) Risinājuma .zip faila ceļš un faila nosaukums, uz kuru eksportēt avota vidi. |
| pārvaldītie | Nepieciešams iestatiet vērtību patiess, lai eksportētu kā pārvaldītu risinājumu; noklusējuma (nepatiess) iestatījums ir eksportēt kā nepārvaldītu risinājumu. |
unpack-solution
Ņem saspiestu risinājuma failu un sadala to vairākos XML failos. Šos failus ir vieglāk lasīt un pārvaldīt avota kontroles sistēmā.
| Parametrs | Apraksts |
|---|---|
| risinājuma fails | (Nepieciešams) solution.zip faila ceļš un faila nosaukums, kas jāatpako. |
| risinājuma mape | (Nepieciešams) Ceļš un mērķa mape, kur vēlaties izpakot risinājumu. |
| risinājuma tips | (Nepieciešams) Izpakojamā risinājuma veida izvēle. Ir šādas opcijas: Nepārvaldīts (ieteicams), Pārvaldīts un Abi. |
pack-solution
Iepako risinājumu, kas attēlots avota kontrolē, solution.zip failā, ko var importēt citā vidē.
| Parametrs | Apraksts |
|---|---|
| risinājuma fails | (Nepieciešams) Ceļš un faila nosaukums solution.zip failam, kurā iepakot risinājumu (piemēram, out/CI/ALMLab.zip). |
| risinājuma mape | (Nepieciešams) Risinājumu pakošanas ceļš un avota mape. |
| risinājuma tips | (Neobligāts) Risinājuma tips pakotnei. Ir šādas opcijas: Nepārvaldīts (ieteicams), Pārvaldīts un Abi. |
publish-solution
Publicē risinājumu pielāgojumus.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, kurā vēlaties publicét risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| risinājuma fails | (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
clone-solution
Tiek klonēts konkrētās vides risinājums.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| risinājuma fails | (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| risinājuma nosaukums | (Obligāti) Klonēt nepieciešamā solution.zip faila ceļu un nosaukumu (piemēram, out/CI/ALMZol.zip). |
| solution-version | Klonējamā risinājuma versija. |
| target-folder | Mērķa mape, kurā ievietot izvilkto risinājumu. (piemēram, Git krātuve\target-solution-folder). |
| Working-directory | Pagaidu mape darbam artefaktiem, kas nepieciešami risinājuma klonēšanai. noklusējums: root of the repository |
check-solution
Pārbauda risinājuma failu, lai noteiktu neatbilstības.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| ceļš | (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties pārbaudīt. |
| ģeogrāfisks apgabals | Kura Microsoft Power Platform pārbaudītāja pakalpojuma ģeogrāfiskā instance jāizmanto. Noklusējuma vērtība ir "ASV". |
| rule-level-override | Ceļš uz failu, kurā iekļauts JSON kārtulu masīvs un to līmeņi. Pieņemtās vērtības ir: Kritisks, Augsts, Zems un Informācijas. Piemērs: [{"Id":"metadati-remove-dup-re","OverrideLevel":"Vidējs"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Vidējs"}] |
| checker-logs-artifact-name | Tās artefaktētās mapes nosaukums, kurai Microsoft Power Platform tiks augšupielādēti pārbaudes lietojumprogrammas žurnāli. Noklusējuma vērtība ir 'CheckSolutionLogs'. |
upgrade-solution
Uzlabo risinājumu.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| risinājuma fails | (Obligāti) Tā risinājuma faila ceļš un nosaukums, ko vēlaties importēt. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| risinājuma nosaukums | (Nepieciešams) Jaunināmā risinājuma nosaukums. |
| asinhrons | Asinhroni jaunina risinājumu. |
| Maksimālais asinhronais gaidīšanas laiks | Maksimālais asinhronais gaidīšanas laiks minūtēs. Noklusējuma vērtība ir 60 minūtes. |
Pakotnes uzdevumi
Šie uzdevumi veic darbības pret pakotnēm.
izvietojuma pakotne
Izvieto pakotnes DLL vai ZIP failu kopā ar pakotni.
Note
Šī darbība ir atbalstīta tikai uz Windows.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, no kuras vēlaties klonét risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| lietotājvārds | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantots tā uzņēmuma lietotājvārds, ar kuru izveidosit savienojumu. |
| parole-noslēpums | Nepieciešams Ja izmantojat lietotājvārdu/paroles autentifikāciju, tiek izmantota tā uzņēmuma parole, ar kuru izveidosit savienojumu. |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| Pakotne | (Nepieciešams) Ceļš uz pakotnes DLL vai ZIP failu ar pakotni. |
Portāla uzdevumi
Šie uzdevumi izpilda sekojośas darbíbas attiecībā uz Power Pages.
upload-paportal
Augšupielādē datus uz Power Pages.
| Parametrs | Apraksts |
|---|---|
| vides URL | (Obligāts) URL videi, kurā vēlaties importēt risinājumu (piemēram, https://YourOrg.crm.dynamics.com). |
| app-id | Lietojumprogrammas ID, ar kuru autentificēties. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| client-secret | Klienta slepenie dati, kas tiek izmantoti GitHub konveijera autentificēšanā. Šis parametrs ir nepieciešams, ja tiek autentificēts pakalpojuma vadītāja akreditācijas dati. |
| tenant-id | Nomnieka ID, veicot autentificēšanu ar app-id un client-secret. |
| upload-path | Ceļš, kurā tiks lejupielādēts tīmekļa vietnes saturs (aizstājvārds: -p). |
| deployment-profile | Augšupielādējiet portāla datus ar vides detaļām, kuras definēti ar profila mainīgajiem izvietojuma profilos/[profile-name].deployment.yaml file. |
| Modeļa versija | Norāda, vai augšupielādējamie vietnes dati izmanto standarta (1) vai uzlaboto datu modeli (2). Noklusējuma vērtība ir 1. |
Uzziniet vairāk par Microsoft Power Platform CLI atbalstu Power Pages.
Kataloga uzdevumi (priekšskatījums)
Šie uzdevumi veic darbības pret katalogu Power Platform vidē.
Note
Pašlaik Power Platform kataloga uzdevumi ir priekšskatījumā.
instalēt
Instalējiet kataloga vienumu mērķa vidē.
| Parametrs | Apraksts |
|---|---|
| catalog-item-id | (Nepieciešams) Kataloga vienums, kas jāinstalē mērķa vidē. |
| target-url | (Nepieciešams) Kataloga vienuma instalācijas mērķa vides URL (piemēram, https://YourOrg.crm.dynamics.com). |
| iestatījumi | (Obligāti) izpildlaika pakotne instalācijas struktūras iestatījumi, kas jāizpilda. Virknes formātam jābūt key=value|key=value. |
| Mērķa versija | Instalējamā mērķa versija. Ja nenorādāt versiju, tiek izvēlēta publicētā versija. |
| Aptaujas statuss | Aptauja, lai pārbaudītu pieprasījuma statusu. |
iesniegt
Uzskaitiet visus publicētos kataloga vienumus no pašreizējās Dataverse vides (organizācijas).
| Parametrs | Apraksts |
|---|---|
| ceļš | (Obligāti) Ceļš uz kataloga iesniegšanas dokumentu. |
| iepakojums-zip | Ceļš uz pakotnes zip failu. |
| risinājums-zip | Ceļš uz risinājuma zip failu. |
| Aptaujas statuss | Aptauja, lai pārbaudītu pieprasījuma statusu. |
statuss
Iegūsti kataloga instalācijas statusu vai iesniedz pieprasījumu.
| Parametrs | Apraksts |
|---|---|
| Izsekošanas ID | (Obligāti) Pieprasīt izsekošanas ID. |
| type | (Nepieciešams) Pieprasījuma veids. Derīgās vērtības ir Install un Submit. |
GitHub darbplūsmas autorēšana
Lai uzzinātu vairāk par GitHub darba plūsmu veidošanu, izmantojot GitHub Actions, aizpildiet GitHub Actions Microsoft Power Platform laboratorijām.
Papildu informācijai skatiet sadaļu Par GitHub Actions.