Accions del GitHub disponibles per al desenvolupament del Microsoft Power Platform
Les accions de GitHub per Microsoft Power Platform es descriuen a les seccions següents. A més, també es mostren fluxos de treball de GitHub d'exemple. Per obtenir més informació sobre Accions de GitHub i com es descarreguen, aneu a Accions de GitHub per al Microsoft Power Platform.
Configurar les credencials per utilitzar amb les accions de GitHub amb Microsoft Power Platform
Moltes de les accions us obliguen a connectar-vos a un entorn del Microsoft Dataverse. Podeu afegir credencials d'usuari o entitats de seguretat de servei com a secrets al dipòsit de GitHub i, a continuació, utilitzar-les en els fluxos de treball.
Per obtenir informació detallada sobre com configurar els secrets a GitHub, vegeu Secrets xifrats
Per obtenir més informació sobre com configurar l'autenticació de l'entitat de seguretat de servei per a Microsoft Power Platform, vegeu les eines de creació de DevOps
Un cop configurat, podeu trucar a l'entitat de seguretat de servei des dels scripts d'acció.
Paràmetres per definir dins de l'script d'acció de GitHub com a Variables de l'entorn:
- Identificador de l'aplicació, com ara:
WF_APPLICATION_ID:<your application id> - Identificador de l'inquilí, com ara:
WF_TENANT_ID:<your tenant id>
El secret del client s'ha d'afegir i emmagatzemar com a secret de GitHub i se'n farà referència des del flux de treball mitjançant un paràmetre com: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Tasques d'ajuda
La tasca d'ajuda disponible es descriu a continuació.
accions-instal·lació
Quan un flux de treball de GitHub Actions força una instal·lació de la CLI en el context d'un executor i es produeix un error de Power Platform temps d'espera, heu d'utilitzar la versió 1 (@v1) amb una acció addicional (actions-install) com a continuació.
Important
- L'ús de la versió 1 (@v1) pot provocar actualitzacions de les accions de GitHub existents que poden provocar l'actualització dels fluxos de treball actuals.
- Heu d'afegir la tasca Instal·la Power Platform eines com a primera tasca del flux de treball abans de qualsevol altra acció de GitHub per 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'
Podeu trobar exemples addicionals d'accions de GitHub a Power Platform Accions.
whoAmI
Per verificar la connexió del servei, es connecta al servei i envia una sol·licitud WhoAmI [SDK/API web]. Aquesta tasca pot ser útil per incloure-la al vostre flux de treball de GitHub per verificar la connectivitat abans que comenci el processament.
| Paràmetre | Descripció |
|---|---|
| environment-url | L'adreça URL de l'entorn al qual us voleu connectar. |
| user-name | Nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | Contrasenya de nom-usuari. Les contrasenyes del GitHub es defineixen a Configuració, a Secrets. Un cop definit i desat, no podreu recuperar un secret. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
Tasques de solució
Aquestes tasques realitzen accions amb solucions i inclouen el següent.
import-solution
Importa una solució en un entorn de destinació.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'adreça URL de l'entorn de destinació al qual voleu importar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| solution-file | (Obligatori) El camí i el nom del fitxer de solució que voleu importar. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
export-solution
Exporta una solució d'un entorn d'origen.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'adreça URL de l'entorn del qual voleu exportar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya de nom-usuari. Les contrasenyes del GitHub es defineixen a Configuració, a Secrets. Un cop definit i desat, no podreu recuperar un secret. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| solution-name | (obligatori) Nom de la solució que s'exportarà. Utilitzeu sempre el nom de la solució, no el nom de visualització. |
| solution-output-file | (Necessari) El camí i el nom del fitxer solution.zip que s'exportarà a l'entorn d'origen. |
| managed | (Necessari) Establert com a cert per exportar com a solució administrada; el valor per defecte (fals) és exportar com a solució no administrada. |
unpack-solution
Pren un fitxer de solució comprimit i el descomprimeix en diversos fitxers XML i altres fitxers de manera que puguin llegir-se i administrar-se més fàcilment mitjançant un sistema de control d'origen.
| Paràmetre | Descripció |
|---|---|
| solution-file | (obligatori) Camí i nom de fitxer del fitxer solution.zip que es desempaquetarà. |
| solution-folder | (obligatori) Camí i carpeta de destinació on voleu desempaquetar la solució. |
| solution-type | (obligatori) Tipus de solució que voleu desempaquetar. Les opcions inclouen No administrada (recomanat), Administrada i Totes dues. |
pack-solution
Empaqueta una solució representada al control d'origen d'un fitxer solution.zip que es pot importar a un altre entorn.
| Paràmetre | Descripció |
|---|---|
| solution-file | (Necessari) El camí i el nom del fitxer solution.zip per empaquetar la solució (per exemple, out/CI/ALMLab.zip). |
| solution-folder | (obligatori) Carpeta de camí i d'origen de la solució que s'empaquetarà. |
| solution-type | (Opcional) El tipus de solució que voleu empaquetar. Les opcions inclouen No administrada (recomanat), Administrada i Totes dues. |
publish-solution
Publica les personalitzacions de la solució.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn al qual voleu publicar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| solution-file | (Obligatori) El camí i el nom del fitxer de solució que voleu importar. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
clone-solution
Clona la solució per a un entorn determinat.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn del qual voleu clonar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| solution-file | (Obligatori) El camí i el nom del fitxer de solució que voleu importar. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| solution-name | (Necessari) El camí i el nom del fitxer solution.zip que es necessiten per clonar (per exemple, out/CI/ALMLab.zip). |
| solution-version | La versió de la solució que s'ha de clonar. |
| target-folder | Carpeta de destinació per col·locar-hi la solució extreta. (per exemple, dipòsit Git repository\target-solution-folder). |
| Working-directory | Carpeta temporal per treballar en els artefactes necessaris per clonar la solució. per defecte: root of the repository |
check-solution
Comprova el fitxer de la solució per detectar inconsistències.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn del qual voleu clonar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| ruta d'accés | (Necessari) El camí i el nom del fitxer de solució que voleu verificar. |
| Zona geogràfica | Quina zona geogràfica del servei verificador del Microsoft Power Platform s'ha d'utilitzar. El valor per defecte és 'estats units'. |
| rule-level-override | Camí al fitxer que conté una matriu de regles JSON i els seus nivells. Els valors acceptats són: Crític, Alt, Baix i Informatiu. Exemple: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | El nom de la carpeta artefacte per a la qual els registres de verificació de Microsoft Power Platform es carregaran. El valor per defecte és 'CheckSolutionLogs'. |
upgrade-solution
Proporciona la capacitat d'actualitzar la solució.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn del qual voleu clonar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| solution-file | (Obligatori) El camí i el nom del fitxer de solució que voleu importar. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| solution-name | (Necessari) Nom de la solució que s'ha d'actualitzar. |
| async | Actualitza la solució de manera asíncrona. |
| max-async-wait-time | Temps d'espera asíncron màxim en minuts. El valor per defecte és 60 minuts. |
Tasques de paquets
Aquestes tasques fan accions amb paquets i inclouen el següent.
deploy-package
Proporciona la capacitat d'implementar un paquet dll o un fitxer zip amb un paquet.
Nota
Aquesta acció només està admesa a Windows.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn del qual voleu clonar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| user-name | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, el nom d'usuari del compte que utilitzeu per connectar-vos. |
| password-secret | (Necessari) Si utilitzeu l'autenticació de nom d'usuari/contrasenya, la contrasenya del compte que utilitzeu per connectar-vos. |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| paquet | (Necessari) El camí a un paquet de fitxer dll o zip amb un paquet. |
Tasques del portal
Aquestes tasques duen a terme les accions següents a Power Pages.
upload-paportal
Carrega dades a Power Pages.
| Paràmetre | Descripció |
|---|---|
| environment-url | (Necessari) L'URL de l'entorn al qual voleu importar la solució (per exemple, https://YourOrg.crm.dynamics.com). |
| app-id | L’identificador de l’aplicació amb el qual cal autenticar-se. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| client-secret | El secret del client s'utilitza per autenticar el pipeline de GitHub. Aquest paràmetre és necessari per autenticar-se amb les credencials de l'entitat de seguretat de servei. |
| tenant-id | L'identificador de l'inquilí en autenticar-se amb app-id i client-secret. |
| upload-path | Camí on s'emmagatzema el contingut del lloc web (àlies: -p). |
| deployment-profile | Carregueu les dades del portal amb els detalls de l'entorn definits a través de variables de perfil al fitxer deployment-profiles/[profile-name].depoyment.yaml. |
| Versió del model | Indica si les dades del lloc que s'han de penjar utilitzaran l'estàndard (1) o el model de dades millorat(2). El valor per defecte és "1". |
Obteniu més informació sobre la Microsoft Power Platform compatibilitat amb la CLI per. Power Pages
Tasques del catàleg (versió preliminar)
Aquestes tasques realitzen accions contra el catàleg i Power Platform inclouen el següent.
Nota
Actualment, les tasques de catàleg per Power Platform a són una versió preliminar .
instal·la
Instal·leu un element del catàleg a l'entorn de destinació.
| Paràmetre | Descripció |
|---|---|
| identificador-element-de-catàleg | (Obligatori) Element del catàleg que s'ha d'instal·lar a l'entorn de destinació. |
| target-url | (Obligatori) L'adreça URL de l'entorn de destinació per a la instal·lació de l'element de catàleg (per exemple, "https://YourOrg.crm.dynamics.com"). |
| configuració | (Obligatori) Configuració del paquet d'execució per executar el marc d'instal·lació. El format de la cadena ha de ser key=value|key=value. |
| Versió de destinació | Versió de destinació per instal·lar. Si es deixa buida, se selecciona la versió publicada. |
| Estat de l'enquesta | Enquesta per comprovar l'estat de la vostra sol·licitud. |
envia
Llista tots els elements del catàleg publicats de l'entorn actual Dataverse (organització).
| Paràmetre | Descripció |
|---|---|
| ruta d'accés | (Obligatori) Camí cap al document d'enviament del catàleg. |
| paquet-zip | Camí del fitxer zip del paquet. |
| solució-zip | Camí del fitxer zip de la solució. |
| Estat de l'enquesta | Enquesta per comprovar l'estat de la vostra sol·licitud. |
estat
Obteniu l'estat de la sol·licitud d'instal·lació o enviament del catàleg.
| Paràmetre | Descripció |
|---|---|
| Identificador de seguiment | (Obligatori) Sol·liciteu l'identificador de seguiment. |
| tipus | (Obligatori) Tipus de sol·licitud (valors: Instal·la, Envia) |
Creació de fluxos de treball GitHub
Per obtenir més informació sobre la composació de fluxos de treball de GitHub mitjançant accions de GitHub, completeu les Accions de GitHub per als laboratoris de Microsoft Power Platform.
Més informació: Quant a les Accions de GitHub