Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
As accións de GitHub para Microsoft Power Platform descríbense nas seguintes seccións. Ademais, tamén se mostran fluxos de traballo de GitHub de mostra. Para obter máis información sobre accións GitHub e como descargalas, visite Accións de GitHub para Microsoft Power Platform.
Configurar as credenciais para usar con accións de GitHub con Microsoft Power Platform
Moitas das accións requiren que se conecte a un ambiente de Microsoft Dataverse. Pode engadir as credenciais do servizo principal ou de usuario como segredos no seu repositorio de GitHub e logo usalas nos seus fluxos de traballo.
Para obter detalles sobre como configurar segredos en GitHub, consulte Segredos cifrados
Para obter máis detalles sobre como configurar a autenticación principal do servizo para Microsoft Power Platform, consulte Ferramentas DevOps Build
Unha vez configurado, pode chamar ao director do servizo desde os seus scripts de acción.
Parámetros para definir dentro do seu script de acción GitHub como variables de ambiente:
- ID de aplicación como:
WF_APPLICATION_ID:<your application id> - ID de arrendatario como:
WF_TENANT_ID:<your tenant id>
O segredo do cliente debe engadirse e almacenarse como segredo de GitHub e farase referencia a este desde o fluxo de traballo usando un parámetro como: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Tarefas de axuda
A continuación, descríbese a tarefa de axuda dispoñible.
accións-instalación
Cando un fluxo de traballo de GitHub Actions obriga a instalar Power Platform CLI no contexto dun corredor e se produce un erro de tempo de espera, debes usar a versión 1 (@v1) cunha acción adicional (actions-install) como a continuación.
Importante
- Usar a versión 1 (@v1) pode levar a actualizacións das accións existentes de GitHub que poden provocar que se actualicen os fluxos de traballo actuais.
- Debes engadir a tarefa Instalar Power Platform Ferramentas como primeira tarefa no teu fluxo de traballo antes de calquera outra acción de GitHub para 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'
Podes atopar mostras adicionais de accións de GitHub en Power Platform Accións.
whoAmI
Verifique a conexión do servizo conectándose ao servizo e enviando unha solicitude de WhoAmI [SDK/API web]. Esta tarefa pode ser útil para incluíla no inicio do seu fluxo de traballo GitHub, para verificar a conectividade antes de que comece o procesamento.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | O URL do contorno ao que se está a conectar. |
| nome-de-usuario | O nome de usuario da conta coa que se está a conectar. |
| segredo-do-contrasinal | O contrasinal do nome de usuario. Os contrasinais de GitHub defínense en Configuración baixo Segredos. Non pode recuperar un segredo despois de definilo e gardalo. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
Tarefas da solución
Estas tarefas realizan accións en solucións e inclúen o seguinte.
importar solución
Importa unha solución a un contorno obxectivo.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno de destino ao que desexa importar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| ficheiro-da-solución | (Obrigatorio) A ruta e o nome do ficheiro de solución que desexa importar. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
exportar solución
Exporta unha solución desde un contorno de orixe.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno desde o que desexa exportar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación de nome de usuario/contrasinal, o contrasinal para nome de usuario. Os contrasinais de GitHub defínense en Configuración baixo Segredos. Non pode recuperar un segredo despois de definilo e gardalo. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| nome-da-solución | (Obrigatorio) O nome da solución para exportar. Empregue sempre o nome da solución, non o seu nome de visualización. |
| ficheiro-de-saída-da-solución | (Obrigatorio) A ruta e o nome do ficheiro solución.zip para exportar ao contorno de orixe. |
| xestionado | (Obrigatorio) Estableza a opción verdadeiro para facer a exportación como unha solución administrada; o valor predeterminado (falso) fai a exportación como unha solución non administrada. |
desempaquetar solución
Colle un ficheiro de solucións comprimido e descompono en varios ficheiros XML e outros ficheiros para que estes ficheiros poidan ser lidos e xestionados máis facilmente por un sistema de control de fonte.
| Parámetro | Descripción |
|---|---|
| ficheiro-da-solución | (Obrigatorio) Ruta e nome de ficheiro do ficheiro solución.zip para desempaquetar. |
| cartafol-da-solución | (Obrigatorio) O camiño e o cartafol de destino no que desexa desempaquetar a solución. |
| tipo-de-solución | (Obrigatorio) Escolla o tipo de solución que desexa desempaquetar. Opcións: Non administrado (recomendado), Xestionado e Ámbolos dous. |
empaquetar solución
Empaqueta unha solución representada no control de fonte nun ficheiro solución.zip que se pode importar noutro ambiente.
| Parámetro | Descripción |
|---|---|
| ficheiro-da-solución | (Obrigatorio) O camiño e o nome do ficheiro do ficheiro solution.zip no que empaquetar a solución (por exemplo, out/CI/ALMLab.zip). |
| cartafol-da-solución | (Obrigatorio) A ruta e o cartafol fonte da solución para empaquetar. |
| tipo-de-solución | (Opcional) O tipo de solución a empaquetar. Opcións: Non administrado (recomendado), Xestionado e Ámbolos dous. |
publicar solución
Publica as personalizacións da solución.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno no que desexa publicar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| ficheiro-da-solución | (Obrigatorio) A ruta e o nome do ficheiro de solución que desexa importar. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
clonar solución
Clona a solución para un determinado ambiente.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno desde o que desexa clonar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| ficheiro-da-solución | (Obrigatorio) A ruta e o nome do ficheiro de solución que desexa importar. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| nome-da-solución | (Obrigatorio) A ruta e o nome do ficheiro solution.zip necesarios para clonar (por exemplo, out / CI / ALMLab.zip). |
| versión da solución | Versión da solución a clonar. |
| cartafol de destino | Cartafol de destino no que colocar a solución extraída. (por exemplo, repositorio Git\target-solution-folder). |
| Directorio de traballo | Cartafol temporal para artefactos en proceso necesarios para clonar a solución. predefinido: root of the repository |
verificar solución
Comproba o ficheiro da solución para detectar incoherencias.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno desde o que desexa clonar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| camiño | (Obrigatorio) A ruta e o nome do ficheiro de solución que desexa comprobar. |
| área xeográfica | Que localización xeográfica do servizo do verificador de Microsoft Power Platform se debe usar. O valor predeterminado é "Estados Unidos". |
| rule-level-override | Camiño ao ficheiro que contén unha matriz JSON de regras e os seus niveis. Os valores aceptados son: crítico, alto, baixo e informativo. Exemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | O nome do cartafol de artefacto para o cal se cargarán rexistros de verificador de Microsoft Power Platform. O valor predefinido é 'CheckSolutionLogs'. |
upgrade-solution
Ofrece a posibilidade de actualizar a solución.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno desde o que desexa clonar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| ficheiro-da-solución | (Obrigatorio) A ruta e o nome do ficheiro de solución que desexa importar. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| nome-da-solución | (Obrigatorio) Nome da solución a actualizar. |
| asíncrono | Actualiza a solución de forma asíncrona. |
| max-async-wait-time | Tempo máximo de espera asíncrono en minutos. O valor predefinido é 60 minutos. |
Tarefas de paquetes
Estas tarefas realizan accións en paquetes e inclúen o seguinte.
deploy-package
Ofrece a posibilidade de despregar un paquete dll ou un ficheiro zip cun paquete.
Nota
Esta acción só é compatible cun equipo Windows.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno desde o que desexa clonar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| nome-de-usuario | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o nome de usuario da conta coa que está a conectarse. |
| segredo-do-contrasinal | (Obrigatorio) Se está a usar a autenticación mediante nome de usuario/contrasinal, o contrasinal da conta coa que está a conectarse. |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| paquete | (Obrigatorio) O camiño a un paquete dll ou ficheiro zip cun paquete. |
Tarefas do portal
Estas tarefas realizan as seguintes accións en Power Pages.
upload-paportal
Carga datos a Power Pages.
| Parámetro | Descripción |
|---|---|
| URL-do-ambiente | (Obrigatorio) O URL para o contorno no que desexa importar a solución (por exemplo, https://YourOrg.crm.dynamics.com). |
| app-id | ID da aplicación co que autenticarse. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| segredo de cliente | O segredo do cliente usado para autenticar a canle GitHub. Este parámetro é obrigatorio ao autenticarse coas credenciais do servizo principal. |
| Id do arrendatario | A identificación do arrendatario ao autenticarse con app-id e client-secret. |
| camiño de carga | Camiño onde se almacenará o contido do sitio web (alias: -p). |
| deployment-profile | Cargue datos do portal con detalles do contorno definidos a través de variables de perfil no ficheiro de perfís de despregamento/[profile-name].deployment.yaml. |
| Versión modelo | Indica se os datos do sitio que se van cargar utilizarán o estándar (1) ou o modelo de datos mellorado (2). O valor predeterminado é "1". |
Obtén máis información sobre a Microsoft Power Platform compatibilidade da CLI para Power Pages.
Tarefas do catálogo (versión preliminar)
Estas tarefas realizan accións contra o catálogo en Power Platform e inclúen as seguintes.
Nota
Actualmente, as tarefas de catálogo para Power Platform son unha versión preliminar versión.
instalar
Instalar un elemento do catálogo no ambiente de destino.
| Parámetro | Descripción |
|---|---|
| identificador-elemento-catalogo | (Obrigatorio) Elemento de catálogo que se instalará no ambiente de destino. |
| target-url | (Obrigatorio) O URL do entorno de destino para a instalación do elemento de catálogo (por exemplo, "https://YourOrg.crm.dynamics.com"). |
| configuración | (Obrigatorio) Configuración do paquete de tempo de execución para que se execute o marco de instalación. O formato da cadea debe ser key=value|key=value. |
| versión-destino | Versión de destino para instalar. Se se deixa baleiro, selecciónase a versión publicada. |
| Estado da votación | Enquisa para comprobar o estado da túa solicitude. |
Enviar
Lista todos os elementos do catálogo publicados do Dataverse contorno (organización) actual.
| Parámetro | Descripción |
|---|---|
| camiño | (Obrigatorio) Camiño ao documento de envío do catálogo. |
| paquete-zip | Camiño ao ficheiro zip do paquete. |
| solución-zip | Camiño ao ficheiro zip da solución. |
| Estado da votación | Enquisa para comprobar o estado da túa solicitude. |
estado
Obteña o estado da instalación/solicitude de envío do catálogo.
| Parámetro | Descripción |
|---|---|
| Identificador de seguimento | (Obrigatorio) Solicitar identificación de seguimento. |
| tipo | (Obrigatorio) Tipo de solicitude (Valores: Instalar, Enviar) |
Creación de fluxo de traballo GitHub
Para obter máis información sobre a composición de fluxos de traballo GitHub mediante accións GitHub, complete os laboratorios de Accións de GitHub para Microsoft Power Platform.
Máis información: Acerca de accións de GitHub