Poznámka
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete sa skúsiť prihlásiť alebo zmeniť adresáre.
Na prístup k tejto stránke sa vyžaduje oprávnenie. Môžete skúsiť zmeniť adresáre.
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.
Podrobnosti o tom, ako nastaviť tajomstvo v GitHub, nájdete v časti Šifrované tajomstvá.
Podrobnosti o tom, ako nastaviť overovanie objektom služby pre Microsoft Power Platform, nájdete v téme Nástroje na vytváranie devOps.
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.