Dostupné akcie GitHub pre vývoj služby Microsoft Power Platform

Nasledujúce časti popisujú GitHub Actions Microsoft Power Platform. V sekciách sa tiež zobrazujú ukážkové GitHub pracovné postupy. Ďalšie informácie o GitHub Actions a spôsobe ich sťahovania nájdete v téme GitHub Actions o Microsoft Power Platform.

Nakonfigurujte prihlasovacie údaje na použitie s akciami GitHub prostredníctvom Microsoft Power Platform

Mnoho akcií vyžaduje pripojenie k prostrediu Microsoft Dataverse. Pridajte objekt služby alebo prihlasovacie údaje používateľa ako tajné kódy do odkladacieho priestoru GitHub a potom ich použite vo svojich pracovných postupoch.

Po nakonfigurovaní poverení môžete volať objekt služby zo skriptov akcie.

Definujte v rámci GitHub skriptu akcií nasledujúce parametre ako premenné prostredia:

  • ID aplikácie, napríklad: WF_APPLICATION_ID:<your application id>
  • ID nájomníka, napríklad: WF_TENANT_ID:<your tenant id>

Pridajte tajný kľúč klienta ako tajný kľúč GitHub. Odkazujte naň z pracovného postupu pomocou parametra, ako je napríklad: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Úlohy pomocníka

K dispozícii je nasledujúca úloha pomocníka.

akcie-inštalácia

Keď GitHub Actions pracovný postup vynúti inštaláciu rozhrania Power Platform CLI v kontexte bežca, a vyskytne sa chyba časového limitu, použite verziu 1 (@v1) s dodatočnou akciou (actions-install), ako je znázornené v nasledujúcom príklade.

Dôležité

  • Použitie verzie 1 (@v1) môže viesť k aktualizáciám existujúcich akcií GitHubu, čo môže viesť k aktualizácii aktuálnych pracovných postupov.
  • Pridajte úlohu Inštalovať nástroje Power Platformy ako prvú úlohu v pracovnom postupe pred ktorýmkoľvek iným GitHub Actions pre 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'

Ďalšie ukážky GitHub Actions nájdete v akciách Power Platformy.

whoAmI

Overí pripojenie k službe prostredníctvom pripojenia k službe a odoslania žiadosti WhoAmI [SDK/Webové rozhranie API]. Táto úloha môže byť užitočná, ak chcete pred začatím spracovania zahrnúť už na začiatku pracovného postupu GitHub overiť pripojenie.

Parameter Popis
url adresa-prostredia Adresa URL prostredia, ku ktorému sa pripájate.
meno-používateľa Používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo Heslo pre používateľské meno. V časti Nastavenia v časti Tajné kódy definujte GitHub heslá. Po definovaní a uložení tajného kódu nemôžete načítať tajný kód.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.

Úlohy riešenia

Tieto úlohy vykonávajú akcie proti riešeniam a zahŕňajú nasledujúce.

import-solution

Importuje riešenie do cieľového prostredia.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, do ktorého chcete importovať riešenie (napríklad, https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
súbor-riešenia (Povinné) Cesta a názov súboru riešenia, ktorý chcete importovať.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.

export-solution

Exportuje riešenie zo zdrojového prostredia.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, z ktorého chcete exportovať riešenie (napríklad, https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu používateľským menom/heslom, heslo pre user-name. V časti Nastavenia v časti Tajné kódy definujte GitHub heslá. Po definovaní a uložení tajného kódu nemôžete načítať tajný kód.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
názov-riešenia (Povinné) Názov riešenia, ktoré sa má exportovať. Vždy používajte Názov riešenia, nie jeho zobrazovaný názov.
výstupný-súbor-riešenia (Požadované) Cesta a názov súboru solution.zip, ktorý sa má exportovať do zdrojového prostredia.
spravované (Povinné) Nastavte na true na export ako spravované riešenie; predvolená možnosť (false) slúži na exportovanie v podobe nespravovaného riešenia.

unpack-solution

Vezme komprimovaný súbor riešenia a rozloží ho na viacero súborov XML. Tieto súbory môžete jednoduchšie čítať a spravovať v systéme správy zdrojov.

Parameter Popis
súbor-riešenia (Povinné) Cesta a názov súboru riešenia.zip určeného na rozbalenie.
priečinok-riešenia (Povinné) Cesta a cieľový priečinok, kde chcete rozbaliť riešenie.
typ-riešenia (Povinné) Typ riešenia, ktoré chcete rozbaliť. Možnosti zahŕňajú Nespravované (odporúčané), Spravované a Oba.

pack-solution

Zbalí riešenie zastúpené v ovládaní zdroja do solution.zip súboru, ktorý môžete importovať do iného prostredia.

Parameter Popis
súbor-riešenia (Povinné) Cesta a názov súboru solution.zip súboru na zbalenie riešenia do súboru (napríklad out/CI/ALMLab.zip).
priečinok-riešenia (Povinné) Cesta a zdrojový priečinok riešenia, ktoré sa má zabaliť.
typ-riešenia (Voliteľné) Typ riešenia, ktoré sa má zabaliť. Možnosti zahŕňajú Nespravované (odporúčané), Spravované a Oba.

publish-solution

Publikuje prispôsobenia riešenia.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre prostredie, do ktorého chcete publikovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
súbor-riešenia (Povinné) Cesta a názov súboru riešenia, ktorý chcete importovať.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.

clone-solution

Klonuje riešenie pre dané prostredie.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, z ktorého chcete klonovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
súbor-riešenia (Povinné) Cesta a názov súboru riešenia, ktorý chcete importovať.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
názov-riešenia (Povinné) Cesta a názov súboru solution.zip potrebné na klonovanie (napríklad out/CI/ALMLab.zip).
solution-version Verzia riešenia na klonovanie.
target-folder Cieľový priečinok, do ktorého sa má vložiť extrahované riešenie. (napríklad odkladací priestor Git\target-solution-folder).
Working-directory Dočasný priečinok pre rozpracované artefakty potrebné na klonovanie riešenia.
predvolené: root of the repository

check-solution

Skontroluje súbor riešenia na zistenie nezrovnalostí.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, z ktorého chcete klonovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
cesta (Povinné) Cesta a názov súboru riešenia, ktorý chcete skontrolovať.
geografická oblasť Ktorá geografická oblasť služby Kontrola v rámci platformy Microsoft Power Platform sa má použiť. Predvolená hodnota je „Spojené štáty“.
rule-level-override Cesta k súboru obsahujúcemu pole pravidiel JSON a ich úrovne. Prijímané hodnoty sú: kritické, vysoké, nízke a informačné. Príklad: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name Názov priečinka artefaktov, pre ktorý sa nahrajú denníky kontroly Microsoft Power Platform. Predvolená hodnota 'CheckSolutionLogs'.

upgrade-solution

Inovuje riešenie.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, z ktorého chcete klonovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
súbor-riešenia (Povinné) Cesta a názov súboru riešenia, ktorý chcete importovať.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
názov-riešenia (Povinné) Názov riešenia, ktoré sa inovuje.
asynchrónny Inovuje riešenie asynchrónne.
max-async-wait-time Maximálna doba asynchrónneho čakania v minútach. Predvolená hodnota je 60 minút.

Balenie úloh

Tieto úlohy vykonávajú akcie v balíkoch.

deploy-package

Nasadzuje balík DLL alebo súbor ZIP s balíkom.

Poznámka

Táto akcia sa podporuje len v Windows.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre cieľové prostredie, z ktorého chcete klonovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
meno-používateľa (Povinné) Ak používate autentifikáciu pomocou používateľského mena/hesla, používateľské meno účtu, ktorý používate na pripojenie.
tajné-heslo (Povinné) Ak používate autentifikáciu pomocou hesla účtu, ktorý používate na pripojenie.
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
balík (Povinné) Cesta k balíku DLL alebo ZIP súboru s balíkom.

Úlohy portálu

Tieto úlohy vykonávajú nasledujúce akcie v Power Pages.

upload-paportal

Odošle údaje do Power Pages.

Parameter Popis
url adresa-prostredia (Požadované) Adresa URL pre prostredie, do ktorého chcete importovať riešenie (napríklad https://YourOrg.crm.dynamics.com).
app-id ID aplikácie, ktoré sa má použiť na overenie. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
tajný kľúč klienta Tajné údaje klienta použité na autentifikáciu kanálu GitHub. Tento parameter je požadovaný pri autentifikácii pomocou prihlasovacích údajov subjektu služby.
id nájomníka ID nájomníka pri autentifikácii pomocou app-id a client-secret.
upload-path Cesta, kam sa uloží obsah webovej lokality (alias: -p).
deployment-profile Odovzdajte údaje portálu s podrobnosťami prostredia definovanými prostredníctvom premenných profilu v súbore deployment-profiles/[názov-profilu].deployment.yaml.
model-verzia Udáva, či údaje lokality, ktoré sa majú nahrať, používajú štandardný (1) alebo vylepšený dátový model (2). Predvolená hodnota je 1.

Prečítajte si viac o Microsoft Power Platform podpore CLI pre Power Pages.

Katalógové úlohy (verzia Preview)

Tieto úlohy vykonávajú akcie v katalógu v službe Power Platform.

Poznámka

V súčasnosti sú úlohy katalógu pre Power Platform v režime ukážky.

inštalovať

Nainštalujte položku katalógu do cieľového prostredia.

Parameter Popis
katalóg-položka-id (Povinné) Položka katalógu, ktorá sa má nainštalovať do cieľového prostredia.
target-url (Povinné) URL adresa cieľového prostredia pre inštaláciu položky katalógu (napríklad https://YourOrg.crm.dynamics.com).
nastavenie (Povinné) balík režimu runtime nastavenia pre spustenie inštalačného rámca. Formát reťazca musí byť key=value|key=value.
Cieľová verzia Cieľová verzia na inštaláciu. Ak nezadáte verziu, vyberie sa publikovaná verzia.
Stav ankety Anketa na kontrolu stavu vašej žiadosti.

odoslať

Uveďte všetky publikované položky katalógu z aktuálneho Dataverse prostredia (organizácie).

Parameter Popis
cesta (Povinné) Cesta k dokumentu predloženia katalógu.
balíček-zip Cesta k súboru .zip balíka.
roztok-zips Cesta k súboru .zip riešenia.
Stav ankety Anketa na kontrolu stavu vašej žiadosti.

stav

Získanie stavu inštalácie katalógu alebo odoslania žiadosti.

Parameter Popis
tracking-id (Povinné) Vyžiadať ID sledovania.
typ (Povinné) Typ požiadavky. Platné hodnoty sú Install a Submit.

Tvorba pracovných postupov GitHub

Ak chcete získať ďalšie informácie o vytváraní pracovných postupov GitHub pomocou GitHub Actions, dokončite GitHub Actions pre Microsoft Power Platform cvičenia.

Ďalšie informácie nájdete v téme Informácie o GitHub Actions.

Pozrite si tiež

Akcie GitHub pre Microsoft Power Platform