Compartir a través de


Acciones de GitHub disponibles para el desarrollo de Microsoft Power Platform

Las acciones de GitHub para Microsoft Power Platform se describen en las siguientes secciones. Además, también se muestran ejemplos de flujos de trabajo de GitHub. Para obtener más información sobre las acciones de GitHub y cómo descargarlas, vaya a Acciones de GitHub para Microsoft Power Platform.

Configurar las credenciales para usar con las acciones de GitHub con Microsoft Power Platform

Muchas de las acciones requieren que se conecte con un entorno de Microsoft Dataverse. Puede agregar una entidad de servicio o las credenciales de usuario como secretos en su repositorio de GitHub y luego usarlas en sus flujos de trabajo.

  • Para obtener detalles sobre cómo configurar secretos en GitHub, consulte Secretos encriptados

  • Para obtener detalles sobre cómo configurar la autenticación de la entidad de servicio para Microsoft Power Platform, consulte DevOps Build Tools

Una vez configurado, puede llamar a la entidad de servicio desde sus scripts de acción.

Parámetros para definir dentro de su script de acción de GitHub como Variables de entorno:

  • Identificador de la aplicación como: WF_APPLICATION_ID:<your application id>
  • Identificador de del inquilino como: WF_TENANT_ID:<your tenant id>

El secreto del cliente debe agregarse y almacenarse como un secreto de GitHub, y se hará referencia a él desde el flujo de trabajo mediante parámetros como: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}

Tareas de ayuda

La tarea de ayuda disponible se describe a continuación.

actions-install

Cuando un flujo de trabajo de GitHub Actions fuerza una instalación de Power Platform CLI en el contexto de un ejecutor y se produce un error de tiempo de espera, debe usar la versión 1 (@v1) con una acción adicional (actions-install) como a continuación.

Importante

  • El uso de la versión 1 (@v1) puede generar actualizaciones de acciones de GitHub existentes que pueden resultar en la actualización de los flujos de trabajo actuales.
  • Debes agregar la tarea Instalar Power Platform Tools como primera tarea en su flujo de trabajo antes de cualquier otra 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'

Puede encontrar ejemplos adicionales de GitHub Actions en Comportamiento de Power Platform.

whoAmI

Comprueba la conexión del servicio conectándose al servicio y enviando una solicitud WhoAmI [SDK/API web]. Esta tarea puede resultar útil para incluirla al principio de su flujo de trabajo de GitHub, para verificar la conectividad antes de que comience el procesamiento.

Parámetro Descripción
environment-url La URL del entorno al que se va a conectar.
user-name El nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret La contraseña de user-name Las contraseñas de GitHub se definen en Configuración debajo de Secretos. No puede recuperar un secreto después de haberlo definido y guardado.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.

Tareas de solución

Estas tareas realizan acciones con soluciones, e incluyen las siguientes.

import-solution

Importa una solución a un entorno de destino.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino al que desea importar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
solution-file (Obligatorio) La ruta y el nombre del archivo de la solución que desea importar.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.

export-solution

Exporta una solución desde un entorno fuente.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino del que desea exportar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si está utilizando autenticación de nombre de usuario/contraseña, la contraseña de user-name. Las contraseñas de GitHub se definen en Configuración debajo de Secretos. No puede recuperar un secreto después de haberlo definido y guardado.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
solution-name (Obligatorio) Nombre de la solución a exportar. Utilice siempre el nombre de la solución, no su nombre para mostrar.
solution-output-file (Obligatorio) La ruta de acceso y el nombre del archivo solution.zip para exportar al entorno de origen.
managed (Obligatorio) Se establece en true para exportar como un solución administrada; el valor predeterminado (false) exporta como una solución no administrada.

unpack-solution

Toma un archivo de la solución comprimido y lo descompone en varios archivos XML de forma que estos archivos se puedan administrar y leer más fácilmente mediante un sistema de control de origen.

Parámetro Descripción
solution-file (Obligatorio) La ruta de acceso y el nombre del archivo solution.zip para desempaquetar.
solution-folder (Obligatorio) La ruta de acceso y la carpeta de destino a la que desea desempaquetar la solución.
solution-type (Obligatorio) El tipo de solución que quiere desempaquetar. Las opciones incluyen: No administrada (recomendado), Administrada y Ambas.

pack-solution

Empaqueta una solución representada en el control de origen en un archivo solution.zip que se puede importar en otro entorno.

Parámetro Descripción
solution-file (Obligatorio) La ruta y el nombre del archivo solution.zip en el que se va a empaquetar la solución (por ejemplo, out/CI/ALMLab.zip).
solution-folder (Obligatorio) La ruta de acceso y la carpeta de origen de la solución a empaquetar.
solution-type (Opcional) El tipo de solución que se va a empaquetar. Las opciones incluyen: No administrada (recomendado), Administrada y Ambas.

publish-solution

Publica las personalizaciones de la solución.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno en el que desea publicar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
solution-file (Obligatorio) La ruta y el nombre del archivo de la solución que desea importar.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.

clone-solution

Clona la solución para un entorno determinado.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino del que desea clonar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
solution-file (Obligatorio) La ruta y el nombre del archivo de la solución que desea importar.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
solution-name (Obligatorio) La ruta y el nombre del archivo solution.zip necesario para la clonación (por ejemplo, out/CI/ALMLab.zip).
solution-version Versión de la solución que se va a clonar.
target-folder Carpeta de destino donde colocar la solución extraída. (Por ejemplo, repository\target-solution-folder de Git).
Working-directory Carpeta temporal para los artefactos en proceso necesarios para clonar la solución.
Predeterminada: root of the repository

check-solution

Comprueba el archivo de la solución para detectar inconsistencias.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino del que desea clonar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
path (Obligatorio) La ruta y el nombre del archivo de la solución que desea comprobar.
geo Qué ubicación geográfica utilizar del servicio del comprobador de Microsoft Power Platform. El valor predeterminado es 'united states'.
rule-level-override Ruta al archivo que contiene una matriz JSON de reglas y sus niveles. Los valores aceptados son: Crítico, Alto, Bajo e Informativo. Ejemplo: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}]
checker-logs-artifact-name El nombre de la carpeta de artefactos para la que se van a cargar los registros del comprobador de Microsoft Power Platform. El valor predeterminado es 'CheckSolutionLogs'.

upgrade-solution

Ofrece la capacidad de actualizar la solución.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino del que desea clonar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
solution-file (Obligatorio) La ruta y el nombre del archivo de la solución que desea importar.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
solution-name (Obligatorio) Nombre de la solución que se actualiza.
asincrónico Actualiza la solución asincrónicamente.
max-async-wait-time Tiempo máximo de espera asincrónico en minutos. El valor predeterminado es 60 minutos.

Tareas del paquete

Estas tareas realizan acciones respecto a los paquetes e incluyen lo siguiente.

deploy-package

Ofrece la capacidad de implementar un paquete .dll o un archivo .zip con un paquete.

Nota

Esta acción solo es compatible con Windows.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno de destino del que desea clonar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
user-name (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, el nombre de usuario de la cuenta que está utilizando para conectarse.
password-secret (Obligatorio) Si utiliza autenticación de nombre de usuario/contraseña, la contraseña de la cuenta que está utilizando para conectarse.
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
Paquete (Obligatorio) La ruta de acceso al paquete .dll o archivo .zip con un paquete.

Tareas de portal

Estas tareas realizan las siguientes acciones en Power Pages.

upload-paportal

Carga datos en Power Pages.

Parámetro Descripción
environment-url (Obligatorio) La dirección URL del entorno en el que desea importar la solución (por ejemplo, https://YourOrg.crm.dynamics.com).
app-id El identificador de la aplicación con el que se va a autenticar. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
client-secret El secreto del cliente utilizado para autenticar la canalización de GitHub. Este parámetro es obligatorio al autenticarse con las credenciales de la entidad de servicio.
tenant-id La identificación del inquilino al autenticarse con app-id y client-secret.
upload-path Ruta de acceso a la ubicación en la que se almacena el contenido del sitio web (alias: -p).
deployment-profile Cargue los datos del portal con los detalles del entorno definidos a través de variables de perfil en el archivo deployment-profiles/[profile-name].deployment.yaml.
versión-modelo Indica si los datos del sitio que se van a cargar usarán el modelo de datos estándar (1) o mejorado (2). El valor predeterminado es '1'.

Más información sobre la compatibilidad de Microsoft Power Platform CLI con Power Pages.

Tareas de catálogo (versión preliminar)

Estas tareas realizan acciones en el catálogo en Power Platform, e incluyen las siguientes.

Nota

Actualmente, las tareas de catálogo para Power Platform son un lanzamiento de versión preliminar.

install

Instalar un elemento de catalog en el entorno de destino.

Parámetro Descripción
catalog-item-id (Obligatorio) Artículo del catálogo que se instalará en el entorno de destino.
target-url (Obligatorio) La dirección URL del entorno de destino para la instalación del artículo del catálogo (por ejemplo, "https://YourOrg.crm.dynamics.com").
configuración (Obligatorio) Configuración del paquete de tiempo de ejecución para que se ejecute el marco de instalación. El formato de la columna debe ser key=value|key=value.
target-version Versión de destino para instalar. Si se deja vacío, se selecciona la versión publicada.
poll-status Sondeo para comprobar el estado de su solicitud.

submit

Lista de todos los artículos del catálogo publicados desde el actual entorno de Dataverse (organización).

Parámetro Descripción
path (Obligatorio) Ruta al documento de envío del catálogo.
package-zip Ruta de acceso al archivo zip del paquete.
solution-zip Ruta de acceso al archivo zip de la solución.
poll-status Sondear para comprobar el estado de la solicitud.

status

Obtener el estado de la solicitud de instalación o envío de catalog.

Parámetro Descripción
tracking-id (Obligatorio) Id de seguimiento de solicitud.
tipo (Obligatorio) Tipo de solicitud (Valores: Instalar, Enviar)

Creación de flujo de trabajo de GitHub

Para obtener más información sobre cómo componer flujos de trabajo de GitHub mediante acciones de GitHub, complete los laboratorios de acciones de GitHub para Microsoft Power Platform.

Más información: Acerca de las Acciones de GitHub

Vea también

Acciones de GitHub para Microsoft Power Platform