Del via


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.
model-version Angiver, om de webstedsdata, der skal overføres, bruger standarddatamodellen (1) eller den udvidede datamodel (2). Standardværdi 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 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

Se også

GitHub-handlinger til Microsoft Power Platform