Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
I følgende afsnit beskrives GitHub Actions for Microsoft Power Platform. Afsnittene viser også eksempel GitHub arbejdsprocesser. Du kan få flere oplysninger om GitHub Actions, og hvordan du downloader dem, se GitHub Actions for Microsoft Power Platform.
Konfigurer legitimationsoplysninger til brug med GitHub-handlinger med Microsoft Power Platform
Mange af handlingerne kræver, at du opretter forbindelse til et Microsoft Dataverse-miljø. Tilføj service principal eller brugerlegitimationsoplysninger som hemmeligheder i dit GitHub-lager, og brug dem derefter i dine workflows.
Du kan finde oplysninger om, hvordan du konfigurerer secrets i GitHub, under Krypterede secrets.
Du kan finde flere oplysninger om, hvordan du konfigurerer godkendelse af tjenesteprincipaler for Microsoft Power Platform, under DevOps Build-værktøjer.
Når du har konfigureret legitimationsoplysningerne, kan du kalde service principal fra dine handlingsscripts.
Definer følgende parametre i GitHub Handlingsscript som miljøvariabler:
- Program-id, f.eks.:
WF_APPLICATION_ID:<your application id> - Lejer-id, f.eks.:
WF_TENANT_ID:<your tenant id>
Tilføj klienthemmeligheden som en GitHub hemmelighed. Referer til den fra arbejdsprocessen ved hjælp af en parameter som f.eks.: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Hjælpeopgaver
Følgende hjælpeopgave er tilgængelig.
actions-install
Når et GitHub Actions workflow gennemtvinger en installation af Power Platform CLI i forbindelse med en runner, og der opstår en timeoutfejl, skal du bruge version 1 (@v1) med en ekstra handling (actions-install) som vist i følgende eksempel.
Vigtigt
- Hvis du bruger version 1 (@v1), kan det medføre opdateringer af eksisterende GitHub-handlinger, der kan resultere i, at aktuelle arbejdsprocesser opdateres.
- Tilføj opgaven Installér Power Platform Tools som den første opgave i arbejdsprocessen før andre GitHub Actions til 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 finde flere eksempler på GitHub Actions hos Power Platform Actions.
whoAmI
Kontrollerer tjenesteforbindelsen ved at oprette forbindelse til tjenesten og sende en WhoAmI [SDK/Web-API]-anmodning. Denne opgave kan være nyttig at inkludere tidligt i din GitHub arbejdsproces for at bekræfte forbindelsen, før behandlingen starter.
| Parameter | Beskrivelse |
|---|---|
| environment-url | Webadressen for det miljø, du opretter forbindelse til. |
| user-name | Brugernavnet på den konto, du bruger til at oprette forbindelse. |
| password-secret | Adgangskoden for brugernavn. Definer GitHub adgangskoder i Indstillinger under Secrets. Du kan ikke hente en hemmelig nøgle, når du har defineret og gemt den. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
Løsningsopgaver
Disse opgaver udfører handlinger i forhold til løsninger og omfatter følgende.
import-solution
Importerer en løsning til et målmiljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det destinationsmiljø, du vil importere løsningen til (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| solution-file | (Påkrævet) Stien til og navnet på den løsningsfil, du vil importere. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
export-solution
Eksporterer en løsning fra et kildemiljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil eksportere løsningen fra (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til brugernavn. Definer GitHub adgangskoder i Indstillinger under Secrets. Du kan ikke hente en hemmelighed, når du har defineret og gemt den. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| solution-name | (Påkrævet) Navnet på den løsning, der skal eksporteres. Brug altid løsningens navn, ikke det viste navn. |
| solution-output-file | (Påkrævet) Stien til og filnavnet på den løsnings-zip-fil, som kildemiljøet skal eksporteres til. |
| managed | (Påkrævet) Angiv til true for at eksportere som en administreret løsning. Standarden (false) eksporterer som en ikke-administreret løsning. |
pak løsning ud
Tager en komprimeret løsningsfil og opdeler den i flere XML-filer. Du kan nemmere læse og administrere disse filer i et kildekontrolsystem.
| Parameter | Beskrivelse |
|---|---|
| solution-file | (Påkrævet) Stien til og filnavnet på den løsnings-zip-fil, der skal udpakkes. |
| solution-folder | (Påkrævet) Stien og destinationsmappen, hvor du vil pakke løsningen ud. |
| solution-type | (Påkrævet) Den type løsning, du vil pakke ud. Indstillingerne omfatter Ikke-administreret (anbefales), Administreret og Begge. |
pack-solution
Pakker en løsning, der findes i versionsstyring, i en solution.zip-fil, som du kan importere til et andet miljø.
| Parameter | Beskrivelse |
|---|---|
| solution-file | (Påkrævet) Stien og filnavnet på den solution.zip-fil, som løsningen skal pakkes til (f.eks. out/CI/ALMLab.zip). |
| solution-folder | (Påkrævet) Stien og kildemappen for den løsning, der skal pakkes. |
| solution-type | (Valgfrit) Den type løsning, der skal pakkes. Indstillingerne omfatter Ikke-administreret (anbefales), Administreret og Begge. |
publish-solution
Udgiver løsningstilpasningerne.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil udgive løsningen til (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| solution-file | (Påkrævet) Stien til og navnet på den løsningsfil, du vil importere. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
clone-solution
Kloner løsningen for et givet miljø.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil klone løsningen fra (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| solution-file | (Påkrævet) Stien til og navnet på den løsningsfil, du vil importere. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| solution-name | (Påkrævet) Stien til og navnet på den solution.zip-fil, der skal klones (f.eks. out/CI/ALMLab.zip). |
| solution-version | Versionen af løsningen til kloning. |
| target-folder | Destinationsmappe, som den udpakkede løsning skal anbringes i. (f.eks. Git-lager\destinationsløsningsmappe). |
| Working-directory | Midlertidig mappe til igangværende artefakter, der skal bruges til at løse løsningen. Standard: root of the repository |
check-solution
Løsningsfilen kontrolleres for at registrere inkonsistens.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil klone løsningen fra (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| sti | (Påkrævet) Stien til og navnet på den løsningsfil, du vil kontrollere. |
| geo | Hvilken geografisk placering af Microsoft Power Platform-kontroltjenesten, der skal bruges. Standardværdien er 'USA'. |
| rule-level-override | Sti til fil en, der indeholder en JSON-matrix med regler og niveauer. Accepterede værdier er: Kritisk, Høj, Lav og Information. Eksempel: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Navnet på den mappe med artefakt, som Microsoft Power Platform-kontrollogfilerne overføres til. Standardværdien er 'CheckSolutionLogs'. |
upgrade-solution
Opgraderer løsningen.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil klone løsningen fra (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| solution-file | (Påkrævet) Stien til og navnet på den løsningsfil, du vil importere. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| solution-name | (Påkrævet) Navnet på den løsning, der skal opgraderes. |
| asynkron | Opgraderer løsningen asynkront. |
| max-async-wait-time | Maksimal asynkron ventetid i minutter. Standardværdien er 60 minutter. |
Pakkeopgaver
Disse opgaver udfører handlinger i forhold til pakker.
deploy-package
Udruller en pakke-DLL eller en ZIP-fil med en pakke.
Bemærk
Denne funktion understøttes kun i Windows.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil klone løsningen fra (f.eks. https://YourOrg.crm.dynamics.com). |
| user-name | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det brugernavnet for den konto, du bruger til at oprette forbindelse. |
| password-secret | (Påkrævet) Hvis du bruger godkendelse med brugernavn/adgangskode, er det adgangskoden til den konto, du bruger til at oprette forbindelse. |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| pakke | (Påkrævet) Stien til DLL- eller ZIP-filen for pakken. |
Portalopgaver
Disse opgaver udfører følgende handlinger i forhold til Power Pages.
upload-paportal
Uploader data til Power Pages.
| Parameter | Beskrivelse |
|---|---|
| environment-url | (Påkrævet) URL-adressen for det miljø, du vil importere løsningen til (f.eks. https://YourOrg.crm.dynamics.com). |
| app-id | Applikations-id at godkende med. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| client-secret | Den klients hemmelighed, der bruges til at godkende GitHub-pipelinen. Denne parameter kræves, når du godkender tjenestens hovedlegitimationsoplysninger. |
| tenant-id | Lejer-id under godkendelse med app-id og client-secret. |
| upload-path | Sti, hvor webstedsindholdet lagres (alias: -p). |
| deployment-profile | Upload portaldata med miljødetaljer, der er defineret via profilvariabler i filen deployment-profiles/[profilnavn].depoyment.yaml-fil. |
| model-version | Angiver, om de stedsdata, der skal uploades, bruger standarddatamodellen (1) eller den udvidede datamodel (2). Standardværdien er 1. |
Få mere at vide om Microsoft Power Platform CLI-understøttelse af Power Pages.
Katalog over opgaver (forhåndsversion)
Disse opgaver udfører handlinger mod kataloget i Power Platform.
Bemærk
Katalogopgaver for Power Platform er i øjeblikket i forhåndsvisning.
installere
Installer et catalog-element i destinationsmiljøet.
| Parameter | Beskrivelse |
|---|---|
| catalog-item-id | (Påkrævet) Katalogelement, der skal installeres i destinationsmiljøet. |
| target-url | (Påkrævet) URL-adressen til destinationsmiljøet for installationen af katalogelementet (f.eks. https://YourOrg.crm.dynamics.com). |
| indstillinger | (Påkrævet) Indstillinger for kørselspakke for den installationsstruktur, der skal udføres. Strengens format skal være key=value|key=value. |
| target-version | Den destinationsversion, der skal installeres. Hvis du ikke angiver en version, vælges den publicerede version. |
| poll-status | Polling for at tjekke status for din anmodning. |
submit
Vis alle publicerede katalogelementer fra det aktuelle Dataverse-miljø (organisation).
| Parameter | Beskrivelse |
|---|---|
| sti | (Påkrævet) Stien til katalogets afsendelsesdokument. |
| package-zip | Sti til zip-fil med pakke. |
| solution-zip | Sti til zip-fil med løsning. |
| poll-status | Poll for at kontrollere status for din anmodning. |
status
Hent status for installationen af kataloget eller indsendelsesanmodningen.
| Parameter | Beskrivelse |
|---|---|
| tracking-id | (Påkrævet) Anmod om sporings-id. |
| type | (Påkrævet) Anmodningstype. Følgende værdier er gyldige Install og Submit. |
GitHub-arbejdsproces authoring
Hvis du vil vide mere om at oprette GitHub arbejdsprocesser ved hjælp af GitHub Actions, kan du gennemføre GitHub Actions for Microsoft Power Platform-laboratorierne.
Du kan få flere oplysninger under Om GitHub Actions.