Tilgjengelige GitHub-handlinger for Microsoft Power Platform-utvikling
GitHub Actions for Microsoft Power Platform er beskrevet i avsnittene nedenfor. I tillegg vises eksempelarbeidsflyter i GitHub. Hvis du vil ha mer informasjon om GitHub-handlinger og hvordan du laster dem ned, kan du gå til GitHub-handlinger for Microsoft Power Platform.
Konfigurere legitimasjon til å bruke med GitHub-handlinger med Microsoft Power Platform
Mange av handlingene krever at du kobler til et Microsoft Dataverse-miljø. Du kan legge til tjenestekontohaver eller brukerlegitimasjon som hemmeligheter i GitHub-lageret, og deretter bruke dem i arbeidsflytene.
Hvis du vil ha mer informasjon om hvordan du konfigurerer hemmeligheter i GitHub, kan du se Krypterte hemmeligheter
Hvis du vil ha mer informasjon om hvordan du konfigurerer godkjenning for Microsoft Power Platform, kan du se DevOps Build Tools
Når du har konfigurert, kan du kalle opp tjenestekontohaveren fra handlingsskriptene.
Parametere som skal defineres i GitHub-handlingsskriptet som miljøvariabler:
- Program-ID, for eksempel:
WF_APPLICATION_ID:<your application id> - Leier-ID, for eksempel:
WF_TENANT_ID:<your tenant id>
Klienthemmeligheten må legges til og lagres som en GitHub-hemmelighet, og det refereres til fra arbeidsflyten ved hjelp av en parameter som følgende: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Hjelpeoppgaver
Den tilgjengelige hjelpeoppgaven er beskrevet nedenfor.
actions-install
Når en arbeidsflyt for GitHub-handlinger fremtvinger en installasjon av Power Platform CLI i sammenheng med en kjører og det oppstår tidsavbruddsfeil, må du bruke versjon 1 (@v1) med en ekstra handling (actions-install) som nedenfor.
Viktig
- Når du bruker versjon 1 (@v1), kan dette føre til oppdatering av eksisterende GitHub-handlinger som i sin tur kan gjøre at gjeldende arbeidsflyter oppdateres.
- Du må legge til oppgaven Installer Power Platform Tools som en første oppgave i arbeidsflyten før andre GitHub-handlinger for 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'
Du kan finne flere eksempler på GitHub-handlinger i Power Platform-handlinger.
whoAmI
Kontrollerer tjenestetilkoblingen ved å koble til tjenesten og sende en WhoAmI [SDK/Web API]-forespørsel. Denne oppgaven kan være nyttig å inkludere tidlig i GitHub-arbeidsflyten for å kontrollere tilkoblingen før behandlingen begynner.
| Parameter | Beskrivelse |
|---|---|
| environment-url | URL-adressen for miljøet du kobler til. |
| user-name | Brukernavnet for kontoen du bruker til å koble til. |
| password-secret | Passordet for user-name. GitHub-passord defineres i Innstillinger under Hemmeligheter. Du kan ikke hente en hemmelighet etter at den er definert og lagret. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
Løsningsoppgaver
Disse oppgavene utfører handlinger mot løsninger og inkluderer følgende:
import-solution
Importerer en løsning til et målmiljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for målmiljøet du vil importere løsningen til (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| solution-file | (Obligatorisk) Banen til og navnet på løsningsfilen du vil importere. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
export-solution
Eksporterer en løsning fra et kildemiljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for miljøet du vil eksportere løsningen fra (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for user-name. GitHub-passord defineres i Innstillinger under Hemmeligheter. Du kan ikke hente en hemmelighet etter at den er definert og lagret. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| solution-name | (Obligatorisk) Navnet på løsningen som skal eksporteres. Bruk alltid løsningens navn, ikke visningsnavnet. |
| solution-output-file | (Obligatorisk) Banen og filnavnet til zip-filen med løsningen som kildemiljøet skal eksporteres til. |
| administrert | (Obligatorisk) Sett til sann for å eksportere som en administrert løsning. Standarden (usann) er å eksportere som en uadministrert løsning. |
unpack-solution
Tar en komprimert løsningsfil og bryter den opp i flere XML-filer og andre filer, slik at disse filene kan leses og håndteres på en enklere måte av et kildekontrollsystem.
| Parameter | Beskrivelse |
|---|---|
| solution-file | (Obligatorisk) Banen og filnavnet til løsningsfilen (zip-fil) som skal pakkes ut. |
| solution-folder | (Obligatorisk) Banen og målmappen der du vil pakke ut løsningen. |
| solution-type | (Oblikatorisk) Typen løsning du vil pakke ut. Alternativene inkluderer Uadministrert (anbefales), Administrert og Begge. |
pack-solution
Pakker en løsning som representeres i kildekontrollen, til en løsningsfil (zip-fil) som kan importeres til et annet miljø.
| Parameter | Beskrivelse |
|---|---|
| solution-file | (Obligatorisk) Banen og filnavnet til solution.zip-filen som løsningen skal pakkes inn i (for eksempel out/CI/ALMLab.zip). |
| solution-folder | (Obligatorisk) Banen og kildemappen for løsningen som skal pakkes. |
| solution-type | (Valgfritt) Løsningstypen som skal pakkes. Alternativene inkluderer Uadministrert (anbefales), Administrert og Begge. |
publish-solution
Publiserer løsningstilpassingene.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for målmiljøet du vil publisere løsningen til (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| solution-file | (Obligatorisk) Banen til og navnet på løsningsfilen du vil importere. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
clone-solution
Kloner løsningen for et bestemt miljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for miljøet du vil klone løsningen fra (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| solution-file | (Obligatorisk) Banen til og navnet på løsningsfilen du vil importere. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| solution-name | (Obligatorisk) Banen og navnet på solution.zip-filen som kreves for å klone (for eksempel ut/CI/ALMLab.zip). |
| solution-version | Versjonen til løsningen som skal klones. |
| target-folder | Målmappen som den utpakkede løsningen skal plasseres i. (for eksempel Git-repositorium\target-solution-folder). |
| Working-directory | Midlertidig mappe for arbeid som pågår, artefakter som er nødvendige for kloning av løsningen. standard: root of the repository |
check-solution
Kontrollerer løsningsfilen for å finne inkonsekvenser.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for miljøet du vil klone løsningen fra (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| path | (Obligatorisk) Banen til og navnet på løsningsfilen du vil kontrollere. |
| geo | Hvilken geografisk plassering av tjenesten Microsoft Power Platform-kontroller som skal brukes. Standardverdien er "USA". |
| rule-level-override | Bane til fil som inneholder en JSON-matrise med regler og deres nivåer. Godtatte verdier er: Kritisk, Høy, Lav og Informativ. Eksempel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Navnet på artefaktmappen som Microsoft Power Platform-kontrollloggene skal lastes opp for. Standardverdien er "CheckSolutionLogs". |
upgrade-solution
Gir mulighet til å oppgradere løsningen.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for miljøet du vil klone løsningen fra (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| solution-file | (Obligatorisk) Banen til og navnet på løsningsfilen du vil importere. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| solution-name | (Obligatorisk) Navnet på løsningen som skal oppgraderes. |
| async | Oppgraderer løsningen asynkront. |
| max-async-wait-time | Maksimal asynkron ventetid i minutter. Standardverdien er 60 minutter. |
Pakkeoppgaver
Disse oppgavene utfører handlinger mot pakker og inkluderer følgende:
deploy-package
Gir mulighet til å distribuere en pakke-DLL eller en ZIP-fil med en pakke.
Merk
Denne handlingen støttes bare i en Windows-versjon.
| Parameter | Bekrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for miljøet du vil klone løsningen fra (for eksempel https://YourOrg.crm.dynamics.com). |
| user-name | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette brukernavnet for kontoen du bruker til å koble til. |
| password-secret | (Obligatorisk) Hvis du bruker godkjenning av brukernavn/passord, er dette passordet for kontoen du bruker til å koble til. |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| pakke | (Obligatorisk) Banen til en pakke-DLL-en eller ZIP-filen med en pakke. |
Oppgaver i portalen
Disse oppgavene utfører følgende handlinger mot Power Pages.
upload-paportal
Laster opp data til Power Pages.
| Parameter | Bekrivelse |
|---|---|
| environment-url | (Obligatorisk) URL-adressen for målmiljøet du vil importere løsningen til (for eksempel https://YourOrg.crm.dynamics.com). |
| app-id | Program-ID-en det skal godkjennes med. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| client-secret | Klienthemmeligheten som brukes til å godkjenne GitHub-pipelinen. Denne parameteren kreves ved godkjenning med legitimasjon for tjenestekontohaver. |
| tenant-id | Leierens ID under autentisasjon med app-id og client-secret. |
| upload-path | Banen der nettstedsinnholdet lagres (alias: -p). |
| deployment-profile | Last opp portaldata med miljødetaljer som er definert via profilvariabler i filen deployment-profiles/[profilnavn].deployment.yaml. |
| modellversjon | Angir om nettstedsdataene som skal lastes opp, bruker standard (1) eller forbedret datamodell (2). Standardverdien er 1. |
Finn ut mer om Microsoft Power Platform CLI-støtte for Power Pages.
Katalogoppgaver (forhåndsversjon)
Disse oppgavene utfører handlinger mot katalogen i Power Platform og inkluderer følgende.
Merk
Katalogoppgaver for Power Platform er for øyeblikket en forhåndsversjon.
install
Installer et catalog-element i målmiljøet.
| Parameter | Bekrivelse |
|---|---|
| catalog-item-id | (Obligatorisk) Katalogelement som skal installeres i målmiljøet. |
| target-url | (Obligatorisk) Nettadressen til målmiljøet for installasjonen av katalogelement i (for eksempel "https://YourOrg.crm.dynamics.com"). |
| innstillinger | (Obligatorisk) Innstillinger for kjøretidspakke for installasjonsrammeverket som skal kjøres. Formatet for strengen må være key=value|key=value. |
| target-version | Målversjon som skal installeres. Hvis du lar den stå tom, velges den publiserte versjonen. |
| poll-status | Avspørring for å kontrollere statusen for forespørselen. |
submit
Vis alle publiserte katalogelementer fra gjeldende Dataverse-miljø (organisasjon).
| Parameter | Bekrivelse |
|---|---|
| path | (Obligatorisk) Bane til dokument for kataloginnsending. |
| package-zip | Bane til ZIP-fil for pakke. |
| solution-zip | Bane til ZIP-fil for løsning. |
| poll-status | Avspørr for å kontrollere statusen for forespørselen. |
status
Få status for forespørselen om catalog-installasjon/-sending.
| Parameter | Bekrivelse |
|---|---|
| tracking-id | (Obligatorisk) Forespørselssporings-ID. |
| type | (Obligatorisk) Forespørselstype (Verdier: Installer, Send inn) |
Redigering av GitHub-arbeidsflyter
Hvis du vil lære mer om hvordan du skriver GitHub-arbeidsflyter ved hjelp av GitHub-handlinger, fullfører du GitHub-handlingene for Microsoft Power Platform-laboratoriumer.
Mer informasjon: GitHub-handlinger