Nota
L'accés a aquesta pàgina requereix autorització. Podeu provar d'iniciar la sessió o de canviar els directoris.
L'accés a aquesta pàgina requereix autorització. Podeu provar de canviar els directoris.
Les seccions següents descriuen les GitHub Actions per a Microsoft Power Platform. Les seccions també mostren exemples de fluxos de treball a GitHub. Per a més informació sobre GitHub Actions i com descarregar-les, consulteu GitHub Actions per a 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. Afegeix credencials de principal de servei o d'usuari com a secrets al teu repositori de GitHub i després utilitza-les en els teus fluxos de treball.
Per a més detalls sobre com configurar secrets a GitHub, vegeu Secrets xifrats.
Per a més detalls sobre com configurar l'autenticació del principal de servei per a Microsoft Power Platform, vegeu les eines de compilació DevOps.
Després de configurar les credencials, pots trucar al principal del servei des dels teus scripts d'Acció.
Defineix els següents paràmetres dins del teu script d'acció de GitHub com a variables d'entorn:
- ID d'aplicació, com ara:
WF_APPLICATION_ID:<your application id> - ID de llogater, com ara:
WF_TENANT_ID:<your tenant id>
Afegeix el secret del client com a secret de GitHub. Referencia-ho des del flux de treball utilitzant un paràmetre com: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Tasques d'ajuda
La següent tasca d'ajuda està disponible.
accions-instal·lació
Quan un flux de treball GitHub Actions obliga a instal·lar Power Platform CLI en el context d'un executor i es produeix un error de temps d'espera, utilitza la versió 1 (@v1) amb una acció addicional (actions-install) com es mostra en l'exemple següent.
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.
- Afegeix la tasca Install Power Platform Tools com la primera tasca del teu flux de treball abans de qualsevol altra GitHub Actions per a 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'
Pots trobar més exemples de GitHub Actions a Power Platform Actions.
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 a l'inici del teu flux de treball a 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. Defineix les contrasenyes de GitHub a la Configuració sota Secrets. No pots recuperar un secret després de definir-lo i desar-lo. |
| 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. Defineix les contrasenyes de GitHub a la Configuració sota Secrets. No pots recuperar un secret després de definir-lo i desar-lo. |
| 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
Agafa un fitxer de solució comprimit i el descompon en diversos fitxers XML. Pots llegir i gestionar aquests fitxers més fàcilment en un sistema de control de versions.
| Paràmetre | Descripció |
|---|---|
| solution-file | (obligatori) Camí i nom de fitxer del fitxer solution.zip que es desempaquetarà. |
| solution-folder | (Obligatori) La carpeta de ruta i destinació on vols 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 pel control de versions en un fitxer solution.zip que pots importar a un altre entorn.
| Paràmetre | Descripció |
|---|---|
| solution-file | (Obligatori) La ruta i el nom del fitxer del fitxer solution.zip on 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
Millora 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. |
| asíncron | 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 realitzen accions contra paquets.
deploy-package
Desplega un DLL de paquet o un fitxer ZIP amb un paquet.
Nota
Aquesta acció només és compatible amb 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 | (Obligatòria) El camí cap al DLL o fitxer ZIP del paquet 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 a pujar utilitzen el model de dades estàndard (1) o 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 a Power Platform.
Nota
Actualment, les tasques de catàleg per a Power Platform estan en previsualització.
instal·lar
Instal·leu un element del catàleg a l'entorn de destinació.
| Paràmetre | Descripció |
|---|---|
| identificador-element-de-catàleg | (Obligatori) Element de catàleg per instal·lar a l'entorn objectiu. |
| target-url | (Obligatori) L'URL de l'entorn objectiu per a la instal·lació de l'element del 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 no especifiques una versió, es 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
Consulta l'estat de la instal·lació del catàleg o de la sol·licitud d'enviament.
| Paràmetre | Descripció |
|---|---|
| Identificador de seguiment | (Obligatori) Sol·liciteu l'identificador de seguiment. |
| tipus | (Obligatori) Tipus de sol·licitud. Els valors vàlids són Install i Submit. |
Creació de fluxos de treball GitHub
Per aprendre més sobre com compondre fluxos de treball per a GitHub utilitzant GitHub Actions, completa els GitHub Actions per a Microsoft Power Platform labs.
Per a més informació, vegeu Sobre GitHub Actions.