Tillgängliga GitHub Actions för Microsoft Power Platform-utveckling
GitHub Actions 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.
Mer information om hur du skapar hemligheter i GitHub finns i Krypterade hemligheter
Mer information om hur du ställer in tjänstens huvudautentisering för Microsoft Power Platform, se DevOps Build-verktyg
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