Dostupné akce GitHub Actions pro vývoj Microsoft Power Platform
Akce GitHubu pro Microsoft Power Platform jsou popsány v následujících částech. Kromě toho jsou zobrazeny také ukázkové pracovní postupy GitHub. Další informace o akcích GitHub Actions a způsobu jejich stažení najdete v části GitHub Actions pro Microsoft Power Platform.
Konfigurace přihlašovacích údajů pro použití GitHub Actions s Microsoft Power Platform
Mnoho akcí vyžaduje připojení k prostředí Microsoft Dataverse. Pověření instančního objektu nebo uživatele můžete přidat jako tajné klíče do svého úložiště GitHub a poté je použít ve svých pracovních postupech.
Podrobnosti o tom, jak nastavit tajné klíče v GitHub, najdete v části Šifrované tajné klíče.
Podrobnosti o tom, jak nastavit ověřování instančního objektu pro Microsoft Power Platform, najdete v části DevOps Build Tools.
Po nakonfigurování můžete volat instanční objekt ze svých skriptů akcí.
Parametry, které je třeba definovat v rámci vašeho skriptu GitHub Action jako proměnné prostředí:
- ID aplikace, jako například:
WF_APPLICATION_ID:<your application id> - ID klienta, jako například:
WF_TENANT_ID:<your tenant id>
Tajný klíč klienta musí být přidán a uložen jako tajný klíč GitHub a bude na něj odkazováno z pracovního postupu pomocí parametru jako: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Úkoly asistenta
Níže je popsán dostupný úkol pomocníka.
actions-install
Když pracovní postup GitHub Actions vynutí instalaci Power Platform CLI v kontextu spuštění a dojde k chybě časového limitu, musíte použít verzi 1 (@v1) s další akcí (actions-install), jak je uvedeno níže.
Důležité
- Použití verze 1 (@v1) může vést k aktualizacím stávajících akcí GitHub, což může vést k aktualizaci aktuálních pracovních postupů.
- Musíte přidat úkol Instalovat Power Platform Tools jako první úkol ve vašem pracovním postupu před jakoukoli jinou akcí GitHub pro 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'
Další ukázky GitHub Actions najdete v tématu Akce Power Platform.
whoAmI
Ověří připojení ke službě připojením ke službě a odesláním požadavku WhoAmI [SDK/Webové rozhraní API]. Tento úkol může být užitečné brzy zahrnout do pracovního postupu GitHub, abyste ověřili připojení před zahájením zpracování.
| Parametr | Popis |
|---|---|
| environment-url | Adresa URL prostředí, ke kterému se připojujete. |
| user-name | Uživatelské jméno účtu, který používáte pro připojení. |
| password-secret | Heslo pro user-name. Hesla GitHub jsou definována v Nastavení pod Tajné kódy. Po definování a uložení tajného klíče jej nemůžete načíst. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
Úkoly řešení
Tyto úkoly provádějí akce s řešeními a zahrnují následující.
import-solution
Importuje řešení do cílového prostředí.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL cílového prostředí, do kterého chcete importovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| solution-file | (Povinné) Cesta a název souboru řešení, který chcete importovat. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
export-solution
Exportuje řešení ze zdrojového prostředí.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, ze kterého chcete exportovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování uživatelského jména / hesla, jde o heslo pro user-name. Hesla GitHub jsou definována v Nastavení pod Tajné kódy. Po definování a uložení tajného klíče jej nemůžete načíst. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| solution-name | (Povinné) Název řešení, které má být exportováno. Vždy používejte název řešení, ne jeho zobrazovaný název. |
| solution-output-file | (Povinné) Cesta a název souboru solution.zip, do kterého se má exportovat zdrojové prostředí. |
| spravované | (Povinné) Při nastavení na pravda proběhne export jako spravované řešení; ve výchozím nastavení (nepravda) proběhne export jako nespravované řešení. |
unpack-solution
Převezme komprimovaný soubor řešení a rozloží ho na více souborů XML a další soubory, aby bylo možné tyto soubory jednodušeji číst a spravovat zdrojovým řídicím systémem.
| Parametr | Popis |
|---|---|
| solution-file | (Povinné) Cesta a název souboru ZIP, který chcete rozbalit. |
| solution-folder | (Povinné) Cesta a cílová složka, do které chcete řešení rozbalit. |
| solution-type | (Povinné) Typ řešení, které chcete rozbalit. Možnosti zahrnují: Nespravované (doporučeno), Spravované a Oboje. |
pack-solution
Sbalí řešení představované v řízení zdroje do souboru solution.zip, který lze importovat do jiného prostředí.
| Parametr | Popis |
|---|---|
| solution-file | (Povinné) Cesta a název souboru solution.zip, do kterého se má zabalit řešení (například out/CI/ALMLab.zip). |
| solution-folder | (Povinné) Cesta a zdrojová složka řešení, které chcete zabalit. |
| solution-type | (Volitelně) Typ řešení, které se má zabalit. Možnosti zahrnují: Nespravované (doporučeno), Spravované a Oboje. |
publish-solution
Publikuje vlastní nastavení řešení.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, do kterého chcete publikovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| solution-file | (Povinné) Cesta a název souboru řešení, který chcete importovat. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
clone-solution
Klonuje řešení pro dané prostředí.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, ze kterého chcete klonovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| solution-file | (Povinné) Cesta a název souboru řešení, který chcete importovat. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| solution-name | (Povinné) Cesta a název souboru solution.zip potřebného ke klonování (například out/CI/ALMLab.zip). |
| solution-version | Verze řešení ke klonování. |
| target-folder | Cílová složka, do které se má extrahované řešení umístit. (například úložiště Git\target-solution-folder). |
| Working-directory | Dočasná složka pro rozpracované artefakty potřebné ke klonování řešení. výchozí: root of the repository |
check-solution
Zkontroluje soubor řešení za účelem zjištění nesrovnalostí.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, ze kterého chcete klonovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| path | (Povinné) Cesta a název souboru řešení, který chcete zkontrolovat. |
| geo | Geografická poloha služby Microsoft Power Platform Checker, která se má použít. Výchozí hodnota je „USA“. |
| rule-level-override | Cesta k souboru obsahujícímu pole pravidel JSON a jejich úrovně. Přípustné hodnoty jsou: kritická, vysoká, nízká a informační. Příklad: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Název složky artefaktu, pro kterou se nahrají protokoly kontroly Microsoft Power Platform. Výchozí hodnota „CheckSolutionLogs“. |
upgrade-solution
Poskytuje možnost upgradovat řešení.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, ze kterého chcete klonovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| solution-file | (Povinné) Cesta a název souboru řešení, který chcete importovat. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| solution-name | (Povinné) Název řešení k upgradu. |
| async | Upgraduje řešení asynchronně. |
| max-async-wait-time | Maximální asynchronní čekací doba v minutách. Výchozí hodnota je 60 minut. |
Balíček úkolů
Tyto úkoly provádějí akce s balíčky a zahrnují následující.
deploy-package
Poskytuje možnost nasadit knihovnu dll balíčku nebo soubor zip s balíčkem.
Poznámka:
Tato akce je podporována pouze v systému Windows.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, ze kterého chcete klonovat řešení (například https://YourOrg.crm.dynamics.com). |
| user-name | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o uživatelské jméno účtu, ke kterému se připojujete. |
| password-secret | (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, ke kterému se připojujete. |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| package | (Povinné) Cesta ke knihovně dll balíčku nebo souboru zip s balíčkem. |
Úkoly portálu
Tyto úkoly provádějí následující akce proti Power Pages.
upload-paportal
Nahraje data do Power Pages.
| Parametr | Popis |
|---|---|
| environment-url | (Povinné) Adresa URL prostředí, do kterého chcete importovat řešení (například https://YourOrg.crm.dynamics.com). |
| app-id | ID aplikace pro ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| client-secret | Tajný klíč klienta použitý k ověření kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu. |
| tenant-id | ID klienta při ověřování pomocí app-id a client-secret. |
| upload-path | Cesta, kam bude obsah webu uložen (alias: -p). |
| deployment-profile | Nahrání dat portálu s podrobnostmi o prostředí definovaných prostřednictvím proměnných profilu v souboru deployment-profiles/[profile-name].deployment.yaml. |
| model-version | Označuje, zda data webu, která mají být nahrána, budou používat standardní (1), nebo rozšířený datový model (2). Výchozí hodnota je „1“. |
Další informace o podpoře rozhraní příkazového řádku Microsoft Power Platform CLI pro Power Pages.
Úlohy katalogu (Preview)
Tyto úlohy provádějí akce s katalogem v Power Platform a zahrnují následující.
Poznámka:
V současné době jsou úlohy katalogu pro Power Platform ve verzi Preview.
install
Nainstalujte položku Catalogu do cílového prostředí.
| Parametr | Popis |
|---|---|
| catalog-item-id | (Povinné) Položka katalogu, která se má nainstalovat do cílového prostředí. |
| target-url | (Povinné) Adresa URL cílového prostředí pro instalaci položky katalogu (například „https://YourOrg.crm.dynamics.com"). |
| settings | (Povinné) Nastavení balíčku modulu runtime pro spuštění rámce instalace. Formát řetězce musí být key=value|key=value. |
| target-version | Cílová verze k instalaci. Pokud ponecháte prázdné, vybere se publikovaná verze. |
| poll-status | Dotaz pro kontrolu stavu vaší žádosti. |
submit
Uvádí všechny publikované položky katalogu z aktuálního prostředí Dataverse (organizace).
| Parametr | Popis |
|---|---|
| path | (Povinné) Cesta k dokumentu pro odeslání katalogu. |
| package-zip | Cesta k souboru ZIP balíčku |
| solution-zip | Cesta k souboru ZIP řešení |
| poll-status | Dotaz pro kontrolu stavu vaší žádosti. |
stav
Získejte stav žádosti o instalaci nebo odeslání Catalogu.
| Parametr | Popis |
|---|---|
| tracking-id | (Povinné) ID sledování žádosti. |
| type | (Povinné) Typ požadavku (Hodnoty: Install, Submit) |
Tvorba pracovního postupu GitHub
Pokud se chcete dozvědět více informací o vytváření pracovních postupů GitHub pomocí akcí GitHub Actions, dokončete laboratoře GitHub Actions pro Microsoft Power Platform.
Další informace: O GitHub Actions