Dostupné akce GitHub Actions pro vývoj Microsoft Power Platform

Následující části popisují GitHub Actions pro Microsoft Power Platform. Oddíly také zobrazují ukázkové pracovní postupy GitHub. Další informace o GitHub Actions a o tom, jak je stáhnout, najdete v tématu GitHub Actions for 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. Přidejte do úložiště GitHub přihlašovací údaje instančního objektu služby nebo uživatele jako tajné klíče a pak je použijte ve svých pracovních postupech.

Po nakonfigurování přihlašovacích údajů můžete instanční objekt služby volat ze skriptů akcí.

V rámci skriptu akce GitHub definujte následující parametry jako proměnné prostředí:

  • ID aplikace, například: WF_APPLICATION_ID:<your application id>
  • ID tenanta, například: WF_TENANT_ID:<your tenant id>

Přidejte tajný klíč klienta jako tajný klíč GitHubu. Odkazujte na něj z pracovního postupu pomocí parametru, například: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Pomocné úkoly

K dispozici je následující pomocná úloha.

actions-install

Když pracovní postup GitHub Actions vynutí instalaci rozhraní příkazového řádku Power Platform v kontextu spouštěče a dojde k chybě časového limitu, použijte verzi 1 (@v1) s další akcí (actions-install), jak je znázorněno v následujícím příkladu.

Důležité

  • Použití verze 1 (@v1) může vést k aktualizacím stávajících GitHub Actions, což může vést k aktualizaci aktuálních pracovních postupů.
  • Před jakoukoli jinou GitHub Actions pro Power Platform přidejte úlohu Install Power Platform Tools jako první úkol v pracovním postupu.
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 Power Platform Actions.

whoAmI

Ověří připojení ke službě připojením ke službě a odesláním požadavku WhoAmI [SDK/Webové rozhraní API]. Tuto úlohu může být užitečné zařadit na začátku pracovního postupu GitHub k ověření 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. Definujte hesla GitHubu v Nastavení v části Tajné údaje. Tajný klíč nemůžete po definování a uložení načíst.
app-id ID aplikace používané k autentizaci. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů instančního objektu služby.
client-secret Tajný klíč klienta použitý k autentizaci kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.

Úlohy řešení

Tyto úkoly provádějí akce vůči řešením 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 a hesla, jde o uživatelské jméno účtu, který používáte pro připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte pro připojení.
solution-file (Povinné) Cesta a název souboru solution, který chcete importovat.
app-id ID aplikace používané k ověření. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů Service Principal.
client-secret Tajný klíč klienta použitý k autentizaci kanálu GitHub. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů instančního objektu zabezpečení.
tenant-id ID tenanta 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, který používáte k připojení.
password-secret (Povinné) Pokud používáte ověřování uživatelským jménem/heslem, heslo pro user-name. Definujte hesla GitHubu v nastavení v části Tajné údaje. Tajný údaj nemůžete po definování a uložení načíst.
app-id ID aplikace, kterým se ověřujete. Tento parametr je požadován při ověřování pomocí pověření objektu služby.
client-secret Tajný klíč klienta použitý k autentizaci kanálu GitHub. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů instančního objektu služby.
tenant-id ID tenanta 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á zdrojové prostředí exportovat.
spravováno (Povinné) Při nastavení na true proběhne export jako spravované řešení; ve výchozím nastavení (false) proběhne export jako nespravované řešení.

unpack-solution

Vezme komprimovaný soubor řešení a rozdělí ho do více souborů XML. Tyto soubory můžete snadněji číst a spravovat v systému správy zdrojového kódu.

Parametr Popis
solution-file (Povinné) Cesta a název souboru solution.zip, který chcete rozbalit.
složka řešení (Povinné) Cesta a cílová složka, do které chcete řešení rozbalit.
solution-type (Povinné) Typ řešení, které chcete extrahovat. Možnosti zahrnují: Nespravované (doporučeno), Spravované a Oboje.

pack-solution

Zabalí řešení reprezentované ve správě zdrojového kódu do souboru solution.zip, který můžete importovat do jiného prostředí.

Parametr Popis
soubor řešení (Povinné) Cesta a název souboru solution.zip, do kterého se má řešení zabalit (například out/CI/ALMLab.zip).
solution-folder (Povinné) Cesta a složka, ze které se balíček řešení vytvoří.
solution-type (Volitelně) Typ řešení, které se má zabalit. Možnosti zahrnují: Nespravované (doporučeno), Spravované a Oboje.

publish-solution

Publikuje přizpůsobení ř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, který používáte pro připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte pro připojení.
solution-file (Povinné) Cesta a název souboru solution, který chcete importovat.
app-id ID aplikace používané k autentizaci. Tento parametr je požadován při ověřování pomocí pověření instančního objektu služby.
client-secret Tajný klíč klienta použitý k autentizaci pipeline GitHubu. Tento parametr je požadován při ověřování pomocí pověření instančního objektu služby.
tenant-id ID tenanta 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, který používáte k připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte pro připojení.
soubor řešení (Povinné) Cesta a název souboru řešení (.sln), který chcete importovat.
app-id ID aplikace používané k autentizaci. 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 autentizaci kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.
solution-name (Povinné) Cesta a název souboru solution.zip potřebná ke klonování (například out/CI/ALMLab.zip).
solution-version Verze řešení určená ke klonování.
cílová složka Cílová složka, do které se má extrahované řešení umístit. (například repozitář Git\target-solution-folder).
Pracovní-adresář 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, který používáte k připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte pro připojení.
app-id ID aplikace používané k autentizaci. 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 autentizaci kanálu GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.
cesta (Povinné) Cesta a název souboru řešení, který chcete zkontrolovat.
geografická zóna Kterou zeměpisnou oblast služby Microsoft Power Platform Checker použít. Výchozí hodnota je „united states“.
přepsání na úrovni pravidla Cesta k souboru a obsahujícímu pole JSON s pravidly a jejich úrovněmi. Přípustné hodnoty jsou: Critical, High, Low a Informational. 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 artefaktů, do které budou nahrány protokoly nástroje Kontrola Microsoft Power Platform. Výchozí hodnota je „CheckSolutionLogs“.

upgrade-solution

Aktualizuje ř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, který používáte pro připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte pro připojení.
solution-file (Povinné) Cesta a název souboru řešení, který chcete importovat.
app-id ID aplikace pro autentizaci. Tento parametr je požadován při ověřování pomocí pověření instančního objektu služby.
client-secret Tajný klíč klienta použitý k autentizaci pipeline GitHub. Tento parametr je požadován při ověřování pomocí pověření objektu služby.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.
solution-name (Povinné) Název řešení k aktualizaci.
asynchronní Aktualizuje řešení asynchronně.
max-async-wait-time Maximální asynchronní čekací doba v minutách. Výchozí hodnota je 60 minut.

Úlohy balíčku

Tyto úlohy provádějí akce nad balíčky.

deploy-package

Nasadí balíček DLL nebo soubor ZIP s balíčkem.

Poznámka

Tato akce je podporována pouze u 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, který používáte pro připojení.
password-secret (Povinné) Pokud používáte ověřování pomocí uživatelského jména / hesla, jde o heslo k účtu, který používáte k připojení.
app-id ID aplikace používané k ověřování. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů Service Principal.
client-secret Tajný klíč klienta použitý k autentizaci pipeline GitHub. Tento parametr je požadován při ověřování pomocí pověření instančního objektu.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.
balíček (Povinné) Cesta k souboru DLL balíčku nebo souboru ZIP s balíčkem.

Úkoly portálu

Tyto úkoly provádějí následující akce v rámci 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 používané k ověření. Tento parametr je požadován při ověřování pomocí pověření instančního objektu služby.
client-secret Tajný klíč klienta použitý k autentizaci pipeline GitHubu. Tento parametr je požadován při ověřování pomocí přihlašovacích údajů instančního objektu služby.
tenant-id ID tenanta při ověřování pomocí app-id a client-secret.
upload-path Cesta, kam bude obsah webu uložen (alias: -p).
deployment-profile Nahrajte data portálu s podrobnostmi o prostředí definovanými prostřednictvím proměnných profilu v souboru deployment-profiles/[profile-name].deployment.yaml.
model-version Označuje, jestli data webu, která se mají nahrát, používá standardní (1) nebo vylepš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 (náhled)

Tyto úlohy provádějí akce vůči katalogu v Power Platform.

Poznámka

V současné době jsou úlohy katalogu pro Power Platform ve verzi Preview.

instalovat

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).
nastavení (Povinné) Nastavení balíčku modulu runtime potřebná ke spuštění instalačního rámce. Formát řetězce musí být key=value|key=value.
target-version Cílová verze k instalaci. Pokud nezadáte verzi, vybere se publikovaná verze.
poll-status Opakovaně kontrolujte stav vaší žádosti.

Odeslat

Vypište všechny publikované položky katalogu z aktuálního prostředí Dataverse (organizace).

Parametr Popis
cesta (Povinné) Cesta k dokumentu pro odeslání do katalogu.
package-zip Cesta k souboru balíčku ZIP.
solution-zip Cesta k souboru ZIP s řešením.
poll-status Kontrola stavu vaší žádosti.

stav

Získejte stav instalace katalogu nebo žádosti o odeslání.

Parametr Popis
tracking-id (Povinné) ID sledování žádosti.
typ (Povinné) Typ požadavku. Platné hodnoty jsou Install a Submit.

Vytváření workflow GitHubu

Další informace o vytváření pracovních postupů GitHub pomocí GitHub Actions získáte absolvováním cvičení GitHub Actions pro Microsoft Power Platform.

Další informace najdete v článku GitHub Actions.

Viz také

GitHub Actions pro Microsoft Power Platform

  • Poslední aktualizace v