Tilgængelige GitHub-handlinger til Microsoft Power Platform-udvikling
GitHub-handlinger for Microsoft Power Platform er beskrevet i følgende afsnit. Derudover kan du også se eksempler på GitHub-arbejdsprocesser. Du kan finde flere oplysninger om GitHub-handlinger, og hvordan du henter dem, ved at gå til GitHub-handlinger 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ø. Du kan tilføje tjenestens hovedlegitimationsoplysninger eller brugerlegitimationsoplysninger som hemmeligheder i GitHub-lageret og derefter bruge dem i dine arbejdsprocesser.
Du kan finde flere oplysninger om, hvordan du konfigurerer hemmeligheder i GitHub, under Krypterede hemmeligheder
Du kan finde flere oplysninger om, hvordan du konfigurerer tjenestens hovedgodkendelse for Microsoft Power Platform, under DevOps Build-værktøjer
Når du er konfigureret, kan du kalde servicechefen fra dine handlingsscripts.
Parametre, der kan defineres i GitHub-handlingsscriptet som miljøvariabler:
- Applikations-id som f.eks.
WF_APPLICATION_ID:<your application id> - Lejer-id som f.eks.
WF_TENANT_ID:<your tenant id>
Klientens hemmelighed skal tilføjes og gemmes som en GitHub-hemmelighed, og der refereres til den fra arbejdsprocessen ved hjælp af en parameter som f.eks.: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Hjælpeopgaver
Den tilgængelige hjælpeopgave beskrives nedenfor.
actions-install
Når en GitHub-arbejdsproces gennemtvinger en installation af Power Platform CLI i konteksten af en kørsel, og der opstår timeoutfejl, skal du bruge version 1 (@v1) med en ekstra handling (actions-install) som nedenfor.
Vigtigt
- Hvis du bruger version 1 (@v1), kan det medføre opdateringer af eksisterende GitHub-handlinger, der kan resultere i, at aktuelle arbejdsprocesser opdateres.
- Du skal tilføje opgaven Installér Power Platform Tools som den første opgave i arbejdsprocessen før eventuelle 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 finde flere eksempler på GitHub-handlinger under Power Platform-handlinger.
whoAmI
Kontrollerer tjenesteforbindelsen ved at oprette forbindelse til tjenesten og sende en WhoAmI [SDK/Web-API]-anmodning. Denne opgave kan være nyttig til at inkludere tidligt i GitHub-arbejdsprocessen for at kontrollere 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. GitHub-adgangskoder defineres i Indstillinger under Hemmeligheder. Du kan ikke hente en hemmelighed, når den er defineret og gemt. |
| 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. GitHub-adgangskoder defineres i Indstillinger under Hemmeligheder. Du kan ikke hente en hemmelighed, når den er defineret og gemt. |
| 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 kompimeret løsningsfil og opdeler den i flere XML-filer, så disse filer lettere kan læses og administreres af et versionstyringssystem.
| 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) Den sti og destinationsmappe, du vil pakke løsningen ud i. |
| 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 er repræsenteret i kildekontrollen, i en løsning.zip-fil, der kan importeres i et andet miljø.
| Parameter | Beskrivelse |
|---|---|
| solution-file | (Påkrævet) Stien til og filnavnet på filen solution.zip, som løsningen skal pakkes i (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\t-løsningsmappe). |
| Working-directory | Midlertidig mappe til igangværende artefakter, der skal bruges til at løse løsningen. default: 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. |
| path | (Påkrævet) Stien til og navnet på den løsningsfil, du vil kontrollere. |
| geo | Hvilken geografisk lokation 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 artefakter, som Microsoft Power Platform-kontrollogfilerne overføres til. Standardværdien er 'CheckSolutionLogs'. |
upgrade-solution
Giver mulighed for at opgradere 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. |
| async | Opgraderer løsningen asynkront. |
| max-async-wait-time | Maksimal asynkron ventetid i minutter. Standardværdien er 60 minutter. |
Pakkeopgaver
Disse opgaver udfører handlinger på pakker og inkluderer følgende.
deploy-package
Gør det muligt at installere en pakke-dll eller en zip-fil sammen med en pakke.
Bemærk
Denne handling understøttes kun i et 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. |
| package | (Påkrævet) sti til en pakke dll-fil eller zip-fil med en pakke. |
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. |
Katalog over opgaver (forhåndsversion)
Disse opgaver udfører handlinger i forhold til kataloget i Power Platform og omfatter følgende.
Bemærk
Katalogopgaver til Power Platform er i øjeblikket en forhåndsversion.
install
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 installation af katalogelement (f.eks. "https://YourOrg.crm.dynamics.com"). |
| settings | (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 den er tom, vælges den udgivne version. |
| poll-status | Polling for at tjekke status for din anmodning. |
submit
Vis alle publicerede katalogelementer fra det aktuelle Dataverse-miljø (organisation).
| Parameter | Beskrivelse |
|---|---|
| path | (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 anmodning om installation/afsendelse af catalog.
| Parameter | Beskrivelse |
|---|---|
| tracking-id | (Påkrævet) Anmod om sporings-id. |
| type | (Påkrævet) Anmodningstype (værdier: Install, Submit) |
GitHub-arbejdsproces authoring
Hvis du vil vide mere om, hvordan du opretter GitHub-arbejdsprocesser ved hjælp af GitHub-handlinger, skal du fuldføre GitHub-handlingerne for Microsoft Power Platform-labs.
Flere oplysninger: Om GitHub-handlinger