Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A következő szakaszok a GitHub Actions for Microsoft Power Platform szolgáltatást ismertetik. A szakaszok GitHub munkafolyamatok mintáit is megjelenítik. A GitHub Actions és a letöltésük módjáról további információért lásd a GitHub Actions for Microsoft Power Platform című cikket.
A Microsoft Power Platformhoz készült GitHub Actions használatához szükséges hitelesítő adatok konfigurálása
Számos művelethez kapcsolódnia kell egy Microsoft Dataverse-környezethez. Adjon hozzá szolgáltatásnevet vagy felhasználói hitelesítő adatokat titkos kódként a GitHub-adattárban, majd használja őket a munkafolyamatokban.
A titkos adatok GitHubban történő beállításáról további részletekért lásd: Titkosított titkos adatok.
A Microsoft Power Platform szolgáltatásnévvel történő hitelesítésének beállításáról a DevOps Build eszközei című témakörben talál további információt.
A hitelesítő adatok konfigurálása után meghívhatja a szolgáltatásnév-identitást a műveletszkriptekből.
Adja meg a következő paramétereket a GitHub műveletszkriptben környezeti változókként:
- Alkalmazásazonosító, például:
WF_APPLICATION_ID:<your application id> - Bérlőazonosító, például:
WF_TENANT_ID:<your tenant id>
Adja hozzá az ügyfélkulcsot GitHub-titokként. Hivatkozzon rá a munkafolyamaton belül egy olyan paraméterrel, mint a következő: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Segéd feladatai
Az alábbi segédfeladat érhető el.
actions-install
Ha egy GitHub Actions munkafolyamat egy runner kontextusában kényszeríti a Power Platform parancssori felületének telepítését, és időtúllépési hiba történik, használja az 1. verziót (@v1) egy további művelettel (actions-install) az alábbi példában látható módon.
Fontos
- Az 1-es verzió (@v1) használata a meglévő GitHub-műveletek frissítéseit eredményezheti, amelyek a jelenlegi munkafolyamatok frissülését eredményezhetik.
- Adja hozzá a Power Platform Tools telepítése feladatot a munkafolyamat első feladataként a Power Platformhoz készült GitHub Actions előtt.
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 Actions további mintáit a Power Platform Actionsben találja.
whoAmI
A szolgáltatáshoz csatlakozva és egy WhoAmI [SDK/webes API]-kérelem elküldésével ellenőrzi a kapcsolatot a szolgáltatással. Ez a feladat hasznos lehet a GitHub munkafolyamat korai szakaszában a kapcsolat ellenőrzéséhez a feldolgozás megkezdése előtt.
| 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, amellyel csatlakozik. |
| password-secret | A user-name jelszava. Adja meg a GitHub jelszavakat a Beállítások alatt, a Titkos kulcsok területen. A definiálás és a mentés után nem lehet lekérni a titkot. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a Service Principal 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 Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlőazonosító a app-id és a client-secret segítségével történő hitelesítéskor. |
Megoldási feladatok
Ezek a feladatok műveleteket hajtanak végre a megoldásokkal kapcsolatban, é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 | A hitelesítéshez használt alkalmazásazonosító. Ez a paraméter a szolgáltatásnév (service principal) hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyfél-titok. Ez a paraméter a szolgáltatásneves hitelesítő adatokkal 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, adja meg a(z) user-name felhasználó jelszavát. Adja meg a GitHub-jelszavakat a Beállítások alatt, a Titkos kódok területen. A definiálás és a mentés után nem lehet lekérni a titkot. |
| app-id | Az alkalmazás hitelesítéshez használt azonosítója. Ez a paraméter a Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyféltitok. Ez a paraméter a Service Principal 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 nevét, ne a megjelenítendő nevét. |
| solution-output-file | (Kötelező) Azon solution.zip fájl elérési útja és fájlneve, amelynek használatával a forráskörnyezetet exportálni kívánja. |
| kezelt | (Kötelező) Állítsa igaz értékre a kezelt megoldásként való exportáláshoz; az alapértelmezett beállítás (hamis) a nem kezelt megoldásként való exportálás. |
unpack-solution
Egy tömörített megoldásfájlt fogad, és több XML-fájlra bontja. Egyszerűbben olvashatja és kezelheti ezeket a fájlokat egy forrásvezérlő rendszerben.
| 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, ahol ki szeretné csomagolni a megoldáscsomagot. |
| 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áskezelőben tárolt megoldást egy solution.zip fájlba csomagolja, amelyet importálhat egy másik környezetbe.
| Paraméter | Ismertetés |
|---|---|
| solution-file | (Kötelező) Az solution.zip fájl elérési útja és fájlneve, amelybe a megoldást becsomagolja (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 lehetőségek közé tartozik a Nem felügyelt (ajánlott), a Felügyelt és a 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 csatlakozik. |
| 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 Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyfél titka. Ez a paraméter a Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlőazonosító 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örnyezet számára.
| 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 | A hitelesítéshez használt alkalmazásazonosító. Ez a paraméter a szolgáltatásnév-identitás hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyféltitok. Ez a paraméter a Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlőazonosító 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 klónozni kívánt verzió. |
| 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ő összetevők számára. alapértelmezett: root of the repository |
check-solution
Ellenőrzi a megoldásfájlt a következetlenségek észlelése érdekében.
| 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 Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyfél-titok. Ez a paraméter a szolgáltatásnév-azonosító hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlőazonosító a app-id és a client-secret segítségével történő hitelesítéskor. |
| elérési út | (Kötelező) Az ellenőrizni kívánt megoldásfájl elérési útja és neve. |
| földrajzi hely | A Microsoft Power Platform Checker szolgáltatás használatához kívánt földrajzi helye. Az alapértelmezett érték: „Egyesült Államok”. |
| rule-level-override | A szabályok és szintjeik JSON tömbjét tartalmazó a 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 az összetevőmappának a neve, amelyhez tartozó Microsoft Power Platform ellenőrző naplófájlok feltöltésre kerülnek. Az alapértelmezett érték: 'CheckSolutionLogs'. |
upgrade-solution
Frissíti a megoldást.
| 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 (service principal) hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyféltitok. Ez a paraméter a Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | Bérlőazonosító a(z) app-id és client-secret használatakor. |
| solution-name | (Kötelező) A frissíteni kívánt megoldás neve. |
| aszinkron | Aszinkron módon frissíti a megoldást. |
| 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 műveleteket hajtanak végre a csomagokkal kapcsolatban.
deploy-package
Üzembe helyez egy csomag DLL-fájlt vagy egy ZIP-fájlt a csomaggal.
Feljegyzés
Ez a művelet csak Windowson támogatott.
| 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 az egyszerű szolgáltatás hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyféltitok. Ez a paraméter a szolgáltatásnév (service principal) hitelesítő adataival történő hitelesítéskor szükséges. |
| tenant-id | A bérlőazonosító 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 Pagesen.
upload-paportal
Adatokat tölt fel a Power Pages-be.
| Paraméter | Ismertetés |
|---|---|
| environment-url | (Kötelező) Annak a környezetnek az URL-címe, amelybe 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 Service Principal hitelesítő adataival történő hitelesítéskor szükséges. |
| client-secret | A GitHub-folyamat hitelesítéséhez használt ügyfél titkos kulcsa. Ez a paraméter a Service Principal 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 deployment-profiles/[profile-name].deployment.yaml fájlban profilváltozókkal definiált környezeti adatokkal. |
| modellverzió | Azt jelzi, hogy a feltöltendő helyadatok a standard (1) vagy a továbbfejlesztett adatmodellt (2) használják-e. Az alapértelmezett érték 1. |
További információ a Microsoft Power Platform CLI Power Pageshez nyújtott támogatásáról.
Katalógus feladatok (előnézet)
Ezek a feladatok műveleteket hajtanak végre a katalóguson a Power Platformon.
Feljegyzés
A Power Platform katalógusfeladatai jelenleg előzetes verzióban érhetők el.
telepít
Katalóguselem telepítése a célkörnyezetbe.
| Paraméter | Ismertetés |
|---|---|
| katalógus-elem-azonosító | (Kötelező) A célkörnyezetre telepíteni kívánt katalóguselem. |
| target-url | (Kötelező) A katalóguselem-telepítés célkörnyezetének URL-címe (például https://YourOrg.crm.dynamics.com). |
| beállítások | (Kötelező) A telepítési keretrendszer által végrehajtandó futásidejű csomag beállításai. 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 nem ad meg verziót, a közzétett verzió lesz kiválasztva. |
| szavazás-állapot | Lekérdezéssel ellenőrizheti kérése állapotát. |
Elküldés
Sorolja fel az aktuális Dataverse környezet (szervezet) összes közzétett katalóguselemét.
| Paraméter | Ismertetés |
|---|---|
| elérési út | (Kötelező) A katalógusbeküldési dokumentum elérési útja. |
| package-zip | A csomag ZIP-fájljának elérési útja. |
| solution-zip | A megoldás ZIP-fájljának elérési útja. |
| szavazás-állapot | Lekérdezés a kérés állapotának ellenőrzéséhez. |
állapot
Kérje le a katalógus telepítési vagy beküldési kérelmének állapotát.
| Paraméter | Ismertetés |
|---|---|
| Követési azonosító | (Kötelező) Követési azonosító kérése. |
| típus | (Kötelező) Kérelem típusa. Az érvényes értékek a következők: Install és Submit. |
GitHub-munkafolyamat létrehozása
Ha többet szeretne megtudni a GitHub-munkafolyamatok GitHub Actions használatával történő összeállításáról, töltse ki a GitHub Actions for Microsoft Power Platform labs laborokat.
További információ: A GitHub Actions névjegye.