Dostupné akcie GitHub pre vývoj služby Microsoft Power Platform
Akcie GitHubu pre Microsoft Power Platform sú popísané v nasledujúcich častiach. Okrem toho sú zobrazené aj vzorové pracovné postupy GitHub. Ďalšie informácie o akciách GitHub a o tom, ako ich stiahnuť, nájdete v časti Akcie GitHub pre 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. Poverenia objektu služby alebo používateľa môžete pridať ako tajné údaje do svojho úložiska GitHub a potom ich použiť vo svojich pracovných postupoch.
Podrobnosti o tom, ako nastaviť tajné údaje v GitHub, nájdete v Šifrované tajné údaje
Podrobnosti, ako nastaviť autentifikáciu objektu služby pre Microsoft Power Platform, nájdete v Nástroje na zostavenie DevOps
Po nakonfigurovaní môžete zavolať servisnému technikovi z vašich akčných skriptov.
Parametre, ktoré musíte definovať vo svojom skripte akcií GitHub ako Premenné prostredia:
- ID aplikácie, napr:
WF_APPLICATION_ID:<your application id> - ID nájomníka, napr:
WF_TENANT_ID:<your tenant id>
Tajné údaje klienta musia byť pridané a uložené ako tajné údaje GitHub a bude sa na ne odkazovať z pracovného postupu pomocou parametra ako: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Úlohy pomocníka
Ďalej je popísaná dostupná pomocná úloha.
akcie-inštalácia
Keď si pracovný postup akcií GitHub vynúti inštaláciu Power Platform CLI v kontexte spúšťača a dôjde k chybe časového limitu, musíte použiť verziu 1 (@v1) s dodatočnou akciou (actions-install), ako je uvedené nižšie.
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.
- Úlohu Inštalovať Power Platform Nástroje musíte pridať ako prvú úlohu vo svojom pracovnom postupe pred akýmikoľvek ďalšími akciami GitHub 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 akcií GitHub nájdete na Power Platform Akcie.
whoAmI
Overí pripojenie k službe prostredníctvom pripojenia k službe a odoslania žiadosti WhoAmI [SDK/Webové rozhranie API]. Túto úlohu môže byť užitočné zahrnúť na začiatok vášho pracovného postupu GitHub, aby ste pred začatím spracovania overili 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. Heslá GitHub sú uvedené v možnosti Nastavenia pod položkou Tajné kľúče. Po definovaní a uložení tajných údajov ich nemôžete získať. |
| 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. Heslá GitHub sú uvedené v možnosti Nastavenia pod položkou Tajné kľúče. Po definovaní a uložení tajných údajov ich nemôžete získať. |
| 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 zbalený súbor riešenia a rozdelí ho na viaceré súbory XML, vďaka čomu možno tieto súbory jednoduchšie čítať a spravovať zo strany zdrojového ovládacieho systému.
| 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, do ktorého 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 predstavované v riadení zdroja do súboru solution.zip, ktorý sa dá importovať do ďalšieho prostredia.
| Parameter | Popis |
|---|---|
| súbor-riešenia | (Povinné) Cesta a názov súboru solution.zip, do ktorého sa má zabaliť riešenie (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ť. |
| geo | 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
Poskytuje možnosť inovovať 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. |
| async | 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 proti balíkom a zahŕňajú nasledujúce.
deploy-package
Poskytuje možnosť nasadiť dll balíka alebo zip súboru s balíkom.
Poznámka
Táto akcia je podporovaná iba v systéme Windows.
| Parameter | Description |
|---|---|
| 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 súboru .dll balíka alebo súboru .zip 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 | Description |
|---|---|
| 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 | Označuje, či údaje lokality, ktoré sa majú nahrať, budú používať š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 proti katalógu v Power Platform a zahŕňajú nasledujúce.
Poznámka
V súčasnosti sú katalógové úlohy pre Power Platform vydanie verzia Preview .
Inštalovať
Nainštalujte položku katalógu do cieľového prostredia.
| Parameter | Description |
|---|---|
| katalóg-položka-id | (Povinné) Položka katalógu, ktorá sa má nainštalovať v cieľovom prostredí. |
| target-url | (Povinné) Adresa URL cieľového prostredia pre inštaláciu položky katalógu do (napríklad "https://YourOrg.crm.dynamics.com"). |
| nastavenia | (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 zostane prázdne, 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 | Description |
|---|---|
| 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ískajte stav žiadosti o inštaláciu/odoslanie katalógu.
| Parameter | Description |
|---|---|
| tracking-id | (Povinné) Vyžiadať ID sledovania. |
| type | (Povinné) Typ požiadavky (Hodnoty: Inštalovať, Odoslať) |
Tvorba pracovných postupov GitHub
Ak sa chcete dozvedieť viac o vytváraní pracovných postupov GitHub pomocou akcií GitHub, vyplňte Akcie GitHub pre laboratóriá Microsoft Power Platform.
Ďalšie informácie: Informácie o akciách GitHub