Beschikbare GitHub Actions voor Microsoft Power Platform-ontwikkeling
GitHub-acties voor Microsoft Power Platform worden in de volgende secties beschreven. Daarnaast worden ook voorbeelden van GitHub-workflows getoond. Voor meer informatie over GitHub-acties en hoe u deze kunt downloaden, gaat u naar GitHub-acties voor Microsoft Power Platform.
Referenties configureren voor gebruik met GitHub-acties met Microsoft Power Platform
Voor veel van de acties moet u verbinding maken met een Microsoft Dataverse-omgeving. U kunt referenties voor service-principals of gebruikers als geheimen toevoegen aan uw GitHub-opslagplaats en deze vervolgens in uw werkstromen gebruiken.
Zie Versleutelde geheimen voor informatie over het instellen van geheimen in GitHub
Zie DevOps Build-tools voor informatie over het instellen van verificatie van de service-principal voor Microsoft Power Platform
Eenmaal geconfigureerd kunt u de service-principal aanroepen vanuit uw actiescripts.
Parameters om in uw GitHub-actiescript te te definiëren als omgevingsvariabelen:
- Toepassings-id zoals
WF_APPLICATION_ID:<your application id> - Tenant-id zoals
WF_TENANT_ID:<your tenant id>
Het clientgeheim wordt toegevoegd en opgeslagen als een GitHub-geheim en er wordt vanuit de werkstroom naar verwezen met een parameter zoals: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Help-taken
De beschikbare helpertaak wordt hieronder beschreven.
whoAmI
Verifieert de serviceverbinding door verbinding te maken met de service en een WhoAmI-aanvraag [SDK/Web-API]. Deze taak kan handig zijn om vroeg in uw GitHub-werkstroom op te nemen, om de connectiviteit te verifiëren voordat de verwerking begint.
| Parameter | Beschrijving |
|---|---|
| environment-url | De URL voor de omgeving waarmee u verbinding maakt. |
| user-name | De gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | Het wachtwoord voor user-name. GitHub-wachtwoorden zijn gedefinieerd in Instellingen onder Geheimen. U kunt een geheim niet meer ophalen nadat het is gedefinieerd en opgeslagen. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
Oplossingstaken
Deze taken voeren acties uit voor oplossingen en omvatten het volgende.
import-solution
Importeert een oplossing in een doelomgeving.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de doelomgeving waarin u de oplossing wilt importeren (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| solution-file | (Vereist) Het pad en de naam van het oplossingsbestand dat u wilt importeren. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
export-solution
Exporteert een oplossing vanuit een bronomgeving.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waaruit u de oplossing wilt exporteren (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor user-name. GitHub-wachtwoorden zijn gedefinieerd in Instellingen onder Geheimen. U kunt een geheim niet meer ophalen nadat het is gedefinieerd en opgeslagen. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| solution-name | (Vereist) De naam van de te exporteren oplossing. Gebruik altijd de naam van de oplossing, niet de weergavenaam. |
| solution-output-file | (Vereist) Het pad en de naam van het bestand solution.zip om uit de bronomgeving te exporteren. |
| managed | (Vereist) Stel in op waar om te exporteren als een beheerde oplossing; de standaard (onwaar) is om te exporteren als een onbeheerde oplossing. |
unpack-solution
Neemt een gecomprimeerd oplossingsbestand en pakt dit uit in meerdere XML-bestanden en andere bestanden, zodat deze bestanden eenvoudiger kunnen worden gelezen en beheerd door een bronbeheersysteem.
| Parameter | Beschrijving |
|---|---|
| solution-file | (Vereist) Het pad en de bestandsnaam van het bestand solution.zip dat u wilt uitpakken. |
| solution-folder | (Vereist) Het pad en de doelmap waarin u de oplossing wilt uitpakken. |
| solution-type | (Vereist) Het type oplossing dat u wilt uitpakken. Opties zijn onder meer: Onbeheerd (aanbevolen), Beheerd en Beide. |
pack-solution
Hiermee wordt een oplossing verpakt die wordt weergegeven in bronbeheer in het bestand solution.zip, dat in een andere omgeving kan worden geïmporteerd.
| Parameter | Beschrijving |
|---|---|
| solution-file | (Vereist) Het pad en de bestandsnaam van het solution.zip-bestand waarin de oplossing moet worden verpakt (bijvoorbeeld out/CI/ALMLab.zip). |
| solution-folder | (Vereist) Het pad en de bronmap van de in te pakken oplossing. |
| solution-type | (Optioneel) Het type oplossing voor het verpakken. Opties zijn onder meer: Onbeheerd (aanbevolen), Beheerd en Beide. |
publish-solution
Hiermee publiceert u de oplossingsaanpassingen.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waarin u de oplossing wilt publiceren (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| solution-file | (Vereist) Het pad en de naam van het oplossingsbestand dat u wilt importeren. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
clone-solution
Hiermee kloont u de oplossing voor een bepaalde omgeving.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waaruit u de oplossing wilt klonen (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| solution-file | (Vereist) Het pad en de naam van het oplossingsbestand dat u wilt importeren. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| solution-name | (Vereist) Het pad en de naam van het solution.zip-bestand dat nodig is om te klonen (bijvoorbeeld out/CI/ALMLab.zip). |
| solution-version | Versie van de oplossing die moet worden gekloond. |
| target-folder | Doelmap om de uitgepakte oplossing in te plaatsen. (bijvoorbeeld Git-repository\target-solution-folder). |
| Working-directory | Tijdelijke map voor onderhanden artefacten die nodig zijn voor het klonen van de oplossing. De standaardwaarde is root of the repository |
check-solution
Hiermee controleert u het oplossingsbestand om inconsistenties te detecteren.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waaruit u de oplossing wilt klonen (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| path | (Vereist) Het pad en de naam van het oplossingsbestand dat u wilt controleren. |
| geo | Welke geolocatie van de Microsoft Power Platform-controleservice moet worden gebruikt. De standaardwaarde is 'united states'. |
| rule-level-override | Pad naar bestand met een JSON-array met regels en hun niveaus. Geaccepteerde waarden zijn: Kritiek, Hoog, Laag en Informatief. Voorbeeld: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | De naam van de artefactmap waarvoor Microsoft Power Platform-controlelogboeken worden geüpload. De standaardwaarde is 'CheckSolutionLogs'. |
upgrade-solution
Biedt de mogelijkheid om de oplossing te upgraden.
| Parameter | Beschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waaruit u de oplossing wilt klonen (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| solution-file | (Vereist) Het pad en de naam van het oplossingsbestand dat u wilt importeren. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| solution-name | (Vereist) Naam van de te upgraden oplossing. |
| async | Hiermee wordt de oplossing asynchroon bijgewerkt. |
| max-async-wait-time | Maximale asynchrone wachttijd in minuten. De standaardwaarde is 60 minuten. |
Pakkettaken
Met deze taken worden acties uitgevoerd op pakketten en deze omvatten het volgende.
deploy-package
Biedt de mogelijkheid om een pakket-DLL-bestand of een zipbestand met een pakket te implementeren.
Notitie
Deze actie wordt alleen ondersteund in Windows.
| Parameter | Omschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waaruit u de oplossing wilt klonen (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| user-name | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, de gebruikersnaam van het account waarmee u verbinding maakt. |
| password-secret | (Vereist) Als u gebruikersnaam-/wachtwoordverificatie gebruikt, het wachtwoord voor het account waarmee u verbinding maakt. |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| package | (Vereist) Het pad naar het pakket-DLL-bestand of zipbestand met een pakket. |
Portaltaken
Deze taken voeren de volgende acties uit op Power Pages.
upload-paportal
Uploadt gegevens naar Power Pages.
| Parameter | Omschrijving |
|---|---|
| environment-url | (Vereist) De URL voor de omgeving waarin u de oplossing wilt importeren (bijvoorbeeld https://YourOrg.crm.dynamics.com). |
| app-id | De toepassings-id voor verificatie. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| client-secret | Het clientgeheim dat wordt gebruikt om de GitHub-pijplijn te verifiëren. Deze parameter is verplicht bij verificatie met Service Principal-referenties. |
| tenant-id | De tenant-id voor verificatie met app-id en client-secret. |
| upload-pad | Pad waarnaar de inhoud van de website wordt opgeslagen (alias: -p). |
| implementatieprofiel | Upload portalgegevens met omgevingsdetails die zijn gedefinieerd via profielvariabelen in het bestand deployment-profiles/[profile-name].depoyment.yaml. |
GitHub-werkstroom ontwerpen
Voltooi de GitHub-acties voor Microsoft Power Platform-labs voor meer informatie over het samenstellen van GitHub-werkstromen met GitHub-acties.
Meer informatie: Info over GitHub Actions