Elérhető GitHub Actions szolgáltatás Microsoft Power Platform-fejlesztéshez
A GitHub Actions a Microsoft Power Platform szolgáltatáshoz a következő szakaszokban kerülnek ismertetésre. Emellett minta-GitHub-munkafolyamatok is megjelennek. A GitHub Actions műveletekkel és azok letöltésével kapcsolatos további tudnivalók: GitHub Actions a Microsoft Power Platformhoz.
A hitelesítő adatok konfigurálása GitHub Actions a Microsoft Power Platform szolgáltatáshoz használatával
Számos művelethez kapcsolódnia kell egy Microsoft Dataverse-környezethez. A GitHub-tárhelyen hozzáadhatja titkokként a szolgáltatásnévhez vagy a felhasználóhoz tartozó hitelesítő adatokat, majd felhasználhatja azokat a munkafolyamatokban.
A titkok GitHubban történő beállításának részleteiért lásd: Titkosított titkok
A Microsoft Power Platform szolgáltatásnév-hitelesítésének beállításával kapcsolatos részletekért lásd: DevOps fejlesztési eszközök
Konfigurálás után a művelet-parancsfájlból hívhatja be a szolgáltatásnevet.
Környezetváltozókként definiálható paraméterek a Github művelet parancsfájlban:
- Az alkalmazás azonosítója, például:
WF_APPLICATION_ID:<your application id> - A bérlő azonosítója, például:
WF_TENANT_ID:<your tenant id>
A titkos ügyfélkódot GitHub titkos kódként kell hozzáadni és tárolni, a munkafolyamaton belül pedig a következőhöz hasonló paraméterrel lehet rá hivatkozni: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Segítő feladatai
A rendelkezésre álló segédfeladatot az alábbiakban ismertetjük.
műveletek-telepítés
Ha egy GitHub Actions munkafolyamat kényszeríti a Power Platform CLI telepítését egy futó kontextusában, és időtúllépési hiba történik, akkor az 1-es verziót (@v1) kell használnia egy további művelettel (actions-install) az alábbiak szerint.
Fontos
- Az 1-es verzió (@v1) használata a meglévő GitHub-műveletek frissítéséhez vezethet, ami az aktuális munkafolyamatok frissítését eredményezheti.
- Az Eszközök telepítése Power Platform feladatot első feladatként kell hozzáadnia a munkafolyamathoz, mielőtt bármilyen más GitHub lenne 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'
A GitHub-műveletek további mintáit a Műveletek oldalon Power Platform találja.
whoAmI
Ellenőrzi a szolgáltatás kapcsolatát a szolgáltatáshoz való kapcsolódással és a WhoAmI [SDK/webes API]-kérelem elküldésével. Ezt a feladatot hasznos lehet a GitHub-munkafolyamat korai szakaszába beilleszteni, hogy még a feldolgozás megkezdése előtt ellenőrizze az összekapcsolhatóságot.
| Paraméter | Ismertetés |
|---|---|
| environment-url | Annak a környezetnek az URL-címe, amelyhez kapcsolódik. |
| user-name | Annak a fióknak a felhasználóneve, amely használatával kapcsolódik. |
| password-secret | A user-name elemhez tartozó jelszó. A GitHub-jelszavak meghatározása a Beállítások > Titkos kódok pontban történik. Egy titkos kódot nem lehet lekérdezni, miután azt definiálták és elmentették. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
Megoldásfeladatok
Ezek a feladatok műveleteket hajtanak végre a megoldásokon, és a következőket tartalmazzák.
import-solution
Egy megoldást célkörnyezetbe importál.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Azon célkörnyezet URL-címe, amelybe importálni szeretné a megoldást (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| solution-file | (Kötelező) Az importálni kívánt megoldásfájl elérési útja és neve. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
export-solution
Megoldást exportál egy forráskörnyezetből.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Azon környezet URL-címe, amelyből exportálni szeretné a megoldást (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, a user-name jelszava. A GitHub-jelszavak meghatározása a Beállítások > Titkos kódok pontban történik. Egy titkos kódot nem lehet lekérdezni, miután azt definiálták és elmentették. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| solution-name | (Kötelező) Az exportálni kívánt megoldás neve. Mindig használja a megoldás név elemét, ne a megjelenítendő név elemét. |
| solution-output-file | (Kötelező) Azon solution.zip fájl elérési útja és fájlneve, amelybe a forráskörnyezetet exportálni kívánja. |
| managed | (Kötelező) Állítsa igaz értékre a felügyelt megoldásként való exportáláshoz; az alapértelmezett (hamis ) beállítás a nem felügyelt megoldáshoz való. |
unpack-solution
Egy tömörített megoldásfájlt különböző XML-fájlokra bont, így ezek a fájlok könnyebben olvashatók és kezelhetők egy forráskód-vezérlőrendszer segítségével.
| Paraméter | Ismertetés |
|---|---|
| solution-file | (Kötelező) A kicsomagolni kívánt solution.zip fájl elérési útvonala és fájlneve. |
| solution-folder | (Kötelező) Az elérési út és a célmappa, ahova a megoldást ki akarja csomagolni. |
| solution-type | (Kötelező) A kicsomagolni kívánt megoldás típusa. A használható típusok: Nem felügyelt (ajánlott), Felügyelt és Mindkettő. |
pack-solution
A forrásvezérlőben lévő megoldást egy másik környezetbe importálható solution.zip fájlba csomagolja be.
| Paraméter | Ismertetés |
|---|---|
| solution-file | (Kötelező) A solution.zip fájl elérési útja és fájlneve, amelybe a megoldást csomagolja (például out/CI/ALMLab.zip). |
| solution-folder | (Kötelező) A becsomagolni kívánt megoldás elérési útvonala és forrásmappája. |
| solution-type | (Nem kötelező) A csomagolandó megoldás típusa. A használható típusok: Nem felügyelt (ajánlott), Felügyelt és Mindkettő. |
publish-solution
Közzéteszi a megoldás testreszabásait.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyben a megoldást közzé szeretné tenni (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| solution-file | (Kötelező) Az importálni kívánt megoldásfájl elérési útja és neve. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
clone-solution
Klónozza a megoldást egy adott környezethez.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyből a megoldást klónozni szeretné (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| solution-file | (Kötelező) Az importálni kívánt megoldásfájl elérési útja és neve. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| solution-name | (Kötelező) A klónozáshoz szükséges solution.zip fájl elérési útja és neve (például out/CI/ALMLab.zip). |
| solution-version | A megoldás klónozni kívánt verziója. |
| target-folder | Az a célmappa, ahová a kibontott megoldást el szeretné helyezni. (például Git-adattár \target-solution-folder). |
| Working-directory | Ideiglenes mappa a megoldás klónozásához szükséges, folyamatban lévő műtermékek számára. alapértelmezett: root of the repository |
check-solution
Ellenőrzi a következetlenségeket a megoldásfájlban.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyből a megoldást klónozni szeretné (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| útvonal | (Kötelező) Az ellenőrizni kívánt megoldásfájl elérési útja és neve. |
| geo | A Microsoft Power Platform Ellenőrző szolgáltatás használni kívánt földrajzi elhelyezkedése. Az alapértelmezett érték: ’egyesült államok'. |
| rule-level-override | A szabályok és szintjeik JSON tömbjét tartalmazó fájl elérési útja. Az elfogadott értékek: Kritikus, Magas, Alacsony és Informatív. Példa: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Annak a műtermékmappának a neve, amelyhez az Microsoft Power Platform ellenőrző naplófájlai feltöltésre kerülnek. Az alapértelmezett érték: 'CheckSolutionLogs'. |
upgrade-solution
Lehetővé teszi a megoldás frissítését.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyből a megoldást klónozni szeretné (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| solution-file | (Kötelező) Az importálni kívánt megoldásfájl elérési útja és neve. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| solution-name | (Kötelező) A frissíteni kívánt megoldás neve. |
| async | A megoldás aszinkron frissítése. |
| max-async-wait-time | Az aszinkron várakozási idejének maximális értéke, percben kifejezve. Az alapértelmezett érték 60 perc. |
Csomagfeladatok
Ezek a feladatok a következő műveleteket hajtják végre a csomagokkal kapcsolatban.
deploy-package
Lehetőséget biztosít egy csomag DLL-jének vagy egy csomagot tartalmazó zip fájlnak a telepítésére.
Feljegyzés
Ez a művelet csak Windows rendszerben támogatott.
| Paraméter | Description |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyből a megoldást klónozni szeretné (például: https://YourOrg.crm.dynamics.com). |
| user-name | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a felhasználóneve, amellyel csatlakozni szeretne. |
| password-secret | (Kötelező) Ha felhasználónév/jelszó hitelesítést használ, annak a fióknak a jelszava, amellyel csatlakozni szeretne. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| csomag | (Kötelező) A csomagot tartalmazó DLL vagy ZIP-fájl elérési útja. |
Portálfeladatok
Ezek a feladatok a következő műveleteket hajtják végre a Power Pages-szel szemben.
upload-paportal
Adatokat tölt fel a Power Pages-be.
| Paraméter | Description |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelyben a megoldást importálni szeretné (például: https://YourOrg.crm.dynamics.com). |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt titkos ügyfélkód. Ez a paraméter a szolgáltatásnév hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlő azonosítója a app-id és a client-secret segítségével történő hitelesítéskor. |
| upload-path | Ezen az elérési úton lesz tárolva a webhely tartalma (alias: -p). |
| deployment-profile | Portáladatok feltöltése a profilváltozók segítségével definiált környezetadatokkal a deployment-profiles/[profile-name].deployment.yaml fájlban. |
| modell-verzió | Azt jelzi, hogy a feltöltendő webhelyadatok a szabványos (1) vagy a továbbfejlesztett adatmodellt () használják-e.2 Az alapértelmezett érték "1". |
További információ a CLI-támogatásról Microsoft Power Platform Power Pages.
Katalógusfeladatok (előzetes verzió)
Ezek a feladatok műveleteket hajtanak végre a katalóguson, Power Platform és a következőket tartalmazzák.
Feljegyzés
Jelenleg a katalógusfeladatai előzetes Power Platform kiadásúak.
telepítés
Katalóguselem telepítése a célkörnyezetbe.
| Paraméter | Description |
|---|---|
| katalógus-elem-azonosító | (Kötelező) A célkörnyezetre telepítendő katalóguselem. |
| target-url | (Kötelező) A katalóguselem célkörnyezetének URL-címe (például "https://YourOrg.crm.dynamics.com"). |
| beállítások | (Kötelező) Futásidejű csomagbeállítások a telepítési keretrendszer végrehajtásához. A karakterlánc formátumának a következőnek kell lennie key=value|key=value. |
| cél-verzió | A telepítendő célverzió. Ha üresen hagyja, a közzétett verzió lesz kiválasztva. |
| szavazás-állapot | Szavazással ellenőrizheti kérése állapotát. |
küldés
Sorolja fel az aktuális Dataverse környezet (szervezet) összes közzétett katalóguselemét.
| Paraméter | Description |
|---|---|
| útvonal | (Kötelező) A katalógusbeküldési dokumentum elérési útja. |
| csomag-zip | A csomag ZIP-fájljának elérési útja. |
| megoldás-zip | A megoldás ZIP-fájljának elérési útja. |
| szavazás-állapot | Szavazás a kérés állapotának ellenőrzéséhez. |
állapot
A katalógus telepítési/küldési kérés állapotának lekérése.
| Paraméter | Description |
|---|---|
| Követési azonosító | (Kötelező) Kérelem nyomon követési azonosítója. |
| type | (Kötelező) Kérelem típusa (értékek: Telepítés, Küldés) |
GitHub-munkafolyamat szerkesztése
Ha többet szeretne megtudni arról, hogyan lehet a GitHub-munkafolyamatokat a GitHub-műveletek segítségével összeállítani, töltse ki a következőt: GitHub Actions Microsoft Power Platform-laboratóriumokhoz.
További információk: A GitHub Actions ismertetése