Dela via

Tillgängliga GitHub Actions för Microsoft Power Platform-utveckling

  • Artikel

GitHub-åtgärder för Microsoft Power Platform beskrivs i följande avsnitt. Dessutom kan du också prova GitHub-arbetsflöden. Mer information GitHub-åtgärder och hur du hämtar dem finns GitHub Actions för Microsoft Power Platform.

Konfigurera autentiseringsuppgifter som ska användas medHub-åtgärder med Microsoft Power Platform

Många av åtgärderna kräver att du ansluter till en Microsoft Dataverse-miljö. Du kan lägga till tjänstens huvud- eller användaruppgifter som hemligheter i ditt GitHub-arkiv och sedan använda dem i dina arbetsflöden.

När du är konfigurerad kan du ringa Service Principal från med i dina Action-skript.

Parametrar att definiera i ditt GitHub Action Script som miljövariabler:

  • Program-ID såsom: WF_APPLICATION_ID:<your application id>
  • Klientorganisations-ID såsom: WF_TENANT_ID:<your tenant id>

Klienthemlighet måste läggas till och lagras som en GitHub-hemlighet från arbetsflödet som använder en parameter såsom: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Assistentuppgifter

Den tillgängliga hjälparuppgiften beskrivs nedan.

actions-install

När ett GitHub Actions-arbetsflöde tvingar fram en installation av Power Platform CLI i samband med en löpare, och ett timeoutfel inträffar måste du använda version 1 (@v1) med en ytterligare åtgärd (actions-install) enligt nedan.

Viktigt!

  • Att använda version 1 (@v1) kan leda till uppdateringar av befintliga GitHub-åtgärder som kan resultera i att nuvarande arbetsflöden uppdateras.
  • Du måste lägga till Installera Power Platform Tools uppgift som en första uppgift i ditt arbetsflöde före alla andra GitHub-åtgärder för 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 hitta ytterligare prover på GitHub Actions på Power Platform-åtgärder.

vem är jag

Verifierar tjänsteanslutningen genom att ansluta till tjänsten och skicka en WhoAmI-förfrågan för [SDK/-webb-API]. Den här uppgiften kan vara bra att inkludera tidigt i ditt GitHub-arbetsflöde för att verifiera anslutning innan bearbetningen börjar.

Parameter Beskrivning
miljö-URL URL-adressen för den miljö som du ansluter till.
användarnamn Användarnamnet för kontot som du använder för att ansluta till.
lösenordshemlighet Lösenord för användarnamn. GitHub-lösenord definieras i Inställningar under Hemligheter. Du kan inte hämta en hemlighet efter att den har definierats och sparats.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.

Lösningsuppgifter

Dessa uppgifter utför åtgärder mot lösningar och omfattar följande.

importlösning

Importerar en lösning till en målmiljö.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för målmiljön som du vill importera lösningen till (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
lösningsfil (Obligatoriskt) Sökvägen och namnet på lösningsfilen du vill importera.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.

exportlösning

Exportera en lösning från en källmiljö.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill exportera lösningen från (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering används lösenordet för användarnamnet. GitHub-lösenord definieras i Inställningar under Hemligheter. Du kan inte hämta en hemlighet efter att den har definierats och sparats.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
lösningsnamn (Krävs) Namnet på lösningen som ska exporteras. Använd alltid lösningens namn, inte dess visningsnamn.
lösningens utdatafil (Obligatoriskt) Sökvägen och namnet på lösningen.zip-filen som källmiljön exporteras till.
hanterad (Obligatorisk) Ange till sant för att exportera hanterad lösning; standardvärdet (falsk) är att exportera som en ohanterad lösning.

packa upp lösningen

Tar en komprimerad lösningsfil och delar upp den i flera olika XML-filer så att dessa filer nklare kan läsas och hanteras av ett källkontrollsystem.

Parameter Beskrivning
lösningsfil (Krävs) Sökväg och filnamn för de lösnings-zip-filer som ska packas upp.
lösningsmapp (Krävs) Den sökväg och målmapp du vill packa upp lösningen i.
lösningstyp (Krävs) Den typ av lösning du vill packa upp. Alternativen är icke-hanterad (rekommenderas), hanteras och både.

pack-lösning

Packar en lösning som visas i källkontrollen i en lösnings-zip-fil som kan importeras till en annan miljö.

Parameter Beskrivning
lösningsfil (Obligatorisk) Sökväg och filnamn för filen solution.zip som lösningen ska packas i (till exempel out/CI/ALMLab.zip).
lösningsmapp (Krävs) Sökväg och källmapp för den lösning som ska packas.
lösningstyp (Valfritt) Typ av lösning att packa. Alternativen är icke-hanterad (rekommenderas), hanteras och både.

publicera-lösning

Publicerar lösningsanpassningarna.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill publicera lösningen i (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
lösningsfil (Obligatoriskt) Sökvägen och namnet på lösningsfilen du vill importera.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.

klonlösning

Klonar lösningen för en viss miljö.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill klona lösningen från (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
lösningsfil (Obligatoriskt) Sökvägen och namnet på lösningsfilen du vill importera.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
lösningsnamn (Obligatoriskt) Sökvägen och namnet på lösningen.zip-filen som behövs för att klona (till exempel ut/CI/ALMLab.zip).
lösningsversion Version av lösningen att klona.
målmapp Målmapp för att placera den extraherade lösningen i. (till exempel Git-arkiv\t arget-solution-folder).
Arbetskatalog Tillfällig mapp för pågående arbeten som behövs för att klona lösningen.
standard: root of the repository

check-lösning

Kontrollerar lösningsfilen för att upptäcka inkonsekvenser.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill klona lösningen från (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
path (Obligatoriskt) Sökvägen och namnet på lösningsfilen du vill kontrollera.
geo Vilken geografisk plats för Microsoft Power Platform kontrolltjänst som används. Standardvärdet är "USA".
åsidosätta regelnivå Sökväg till fil a som innehåller en JSON-uppsättning regler och deras nivåer. Godkända värden är: Kritisk, Hög, Låg och Informationsvärde. Exempel: [{"Id":"meta-ta bort-dup-reg","OverrideLevel":"Han"},{"Id":"--undvika-specialiserade-update-ops","OverrideLevel":"4."}]
checker-logs-artifact-name Namnet på artefaktmappen för vilken Microsoft Power Platform kontrolloggar laddas upp. Standardvärdet är 'CheckSolutionLogs'.

uppgraderingslösning

Ger möjlighet att uppgradera lösningen.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill klona lösningen från (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
lösningsfil (Obligatoriskt) Sökvägen och namnet på lösningsfilen du vill importera.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
lösningsnamn (Obligatoriskt) Namnet på lösningen som ska uppgraderas.
asynk Uppgraderar lösningen asynkront.
max-async-väntetid Maximal asynkron väntetid i minuter. Standardvärdet är 60 minuter.

Paketuppgifter

Dessa uppgifter utför åtgärder mot paket och inkluderar följande.

distribuera-paket

Ger möjlighet att distribuera en paketdll eller en zip-fil med ett paket.

Kommentar

Den här åtgärden stöds endast i Windows.

Parameter Beskrivning
miljö-URL (Obligatoriskt) Webbadressen för miljön som du vill klona lösningen från (till exempelhttps://YourOrg.crm.dynamics.com).
användarnamn (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är användarnamnet för kontot du använder för att ansluta med.
lösenordshemlighet (Obligatorisk) Om du använder användarnamn/lösenordsautentisering är lösenordet för kontot du använder för att ansluta med.
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
paket (Obligatoriskt) Sökvägen till paketet dll eller zip-fil med ett paket.

Portaluppgifter

Dessa uppgifter utför följande åtgärder mot Power Pages.

upload-paportal

Laddar upp data till Power Pages.

Parameter Beskrivning
miljö-URL (Obligatoriskt) URL-adressen för den miljö som du vill importera lösningen till (till exempel https://YourOrg.crm.dynamics.com).
app-id Applikations-ID som ska autentiseras med. Denna parameter krävs vid autentisering med Service Principal-referenser.
klienthemlighet Klienthemligheten som används för att autentisera GitHub-pipelinen. Denna parameter krävs vid autentisering med Service Principal-referenser.
klientorganisation-id Klientorganisation-ID vid autentisering medapp-id ochclient-secret.
upload-path Sökväg där webbplatsinnehållet lagras (alias: -p).
deployment-profile Överför portaldata med miljöinformation definierad via profilvariabler i deployment-profiles/[profile-name].deployment.yaml file.
model-version Anger om webbplatsdata som ska laddas upp kommer att använda standarddatamodellen (1) eller den förbättrade datamodellen (2). Standardvärdet är 1.

Mer information om Microsoft Power Platform CLI-stöd för Power Pages.

Kataloguppgifter (förhandsgranskning)

Dessa uppgifter utför åtgärder mot katalogen i Power Platform och omfattar följande.

Kommentar

För närvarande gäller kataloguppgifter Power Platform i förhandsversion.

installera

Installera ett catalog-objekt i målmiljön.

Parameter Beskrivning
catalog-item-id (Obligatoriskt) Katalogobjekt som ska installeras i målmiljön.
target-url (Obligatoriskt) Url för målmiljön för att installera katalogobjekt i (till exempel "https://YourOrg.crm.dynamics.com").
settings (Obligatoriskt) körningspaketinställningar för installationsprogrammet som ska köras. Formatet på strängen måste vara key=value|key=value.
target-version Målversion att installera. Om den publicerade versionen lämnas tom väljs den.
poll-status Undersökning för att kontrollera statusen för din förfrågan.

skicka

Lista alla publicerade katalogobjekt från den aktuella Dataverse miljön (organisation).

Parameter Beskrivning
path (Obligatoriskt) Sökväg till ett dokument för inlämning av katalogen.
package-zip Sökväg till ZIP-fil för paket.
solution-zip Sökväg till ZIP-fil för lösning.
poll-status Undersökning för att kontrollera status för din begäran.

status

Hämta status för begäran om installera/skicka för catalog.

Parameter Beskrivning
tracking-id (Krävs) Begär spårnings-id.
type (Obligatoriskt) Begäranstyp (Värden: Installera, Skicka)

GitHub arbetsflödesredigering

Om du vill veta mer om hur du skapar GitHub-arbetsflöden med hjälp av GitHub-åtgärder, slutför GitHub-åtgärderna för Microsoft Power Platform laboratorier.

Mer information: Om GitHub Actions

Se även

GitHub-åtgärder för Microsoft Power Platform