Tutorial: Automatización de la implementación de soluciones mediante Acciones de GitHub para Microsoft Power Platform

En este tutorial, obtendrá información sobre cómo:

Los flujos de trabajo pueden exportar su aplicación (como una solución no administrada) desde un entorno de desarrollo, generar un artefacto de compilación (solución administrada) e implementar la aplicación en su entorno de producción, todo ello automáticamente. Este tutorial utiliza la solución ALMLab que creó y los entornos que configuró en tutoriales anteriores.

Tutoriales relacionados: Empezar y Crear una aplicación basada en modelos.

Creación de una cuenta de GitHub

1. Vaya a https://github.com y seleccione Registrarse o Iniciar una prueba gratuita (o inicie sesión si tiene una cuenta existente).

   

2. Después de crear la cuenta, cree un repositorio seleccionando Crear repositorio o Nuevo.

   

   Es posible que vea la siguiente pantalla de inicio alternativa:

   

3. Cree el nuevo repositorio y asígnele el nombre poweractionslab. Asegúrese de seleccionar Agregar un archivo README para iniciar el repositorio y elija Crear repositorio.

   

Crear un nuevo secreto para la autenticación con entidad de servicio

1. Vaya al repositorio y seleccione Configuración. Expanda Secretos y a continuación, seleccione Acciones.

2. En la página Secretos, asigne al secreto el nombre PowerPlatformSPN. Escriba el secreto de cliente del registro de aplicación que creó en Microsoft Entra en el campo Valor y, a continuación, seleccione Agregar secreto. Más adelante en este tutorial, hará referencia al secreto del cliente en los archivos YML que definen los flujos de trabajo de GitHub.

   

   El secreto del cliente ahora se almacena de forma segura como un secreto de GitHub.

Crear un flujo de trabajo para exportar y descomprimir el archivo de la solución en una nueva rama

1. Seleccione Acciones y, a continuación, seleccione configurar un flujo de trabajo usted mismo. O bien, seleccione Configurar en el cuadro Flujo de trabajo simple de la sección sugerida para este repositorio.

   

2. Verá un nuevo archivo YAML con un flujo de trabajo básico para ayudarle a empezar a trabajar con acciones de GitHub.

   

3. Elimine el contenido precreado y, a continuación, pegue el contenido del archivo export-and-branch-solution-with-spn-auth.yml. Cambie el nombre del archivo a export-and-branch-solution.yml.

   

4. Actualice <ENVIRONMENTURL> con la URL del entorno de desarrollo desde el que desea exportar (por ejemplo: https://poweractionsdev.crm.dynamics.com).

5. Actualice <APPID> y <TENANT ID> con sus valores.

   • Si usa credenciales, pegue el contenido del archivo export-and-branch-solution.yml en lugar del contenido del archivo export-and-branch-solution-with-spn-auth.yml. Actualice <USERNAME> con el nombre de usuario que use para conectarse al entorno.

     

   Consejo

   Si no está familiarizado con Acciones de GitHub y desea obtener más información, consulte la documentación oficial en https://docs.github.com/en/actions.

6. Ya está listo para hacer commit de sus cambios. Seleccione Iniciar confirmación, escriba Crear exportación yml en el campo de título y, luego, agregue una descripción (opcional). A continuación, seleccione Confirmar nuevo archivo.

   

Enhorabuena, ha creado el primer flujo de trabajo de GitHub mediante las siguientes acciones:

• Who Am I: garantiza que puede conectarse correctamente al entorno desde el que desea exportar.
• Exportar la solución: exporta el archivo de solución desde su entorno de desarrollo.
• Desempaquetar solución: el archivo de solución que exporta el servidor es un archivo comprimido (zip) con archivos de configuración consolidados. Estos archivos iniciales no son adecuados para la gestión de código fuente porque no están estructurados para que sea factible que los sistemas de gestión de código fuente realicen correctamente diferencias en los archivos y capturen los cambios que desea registrar en el control de código fuente. Debe desempaquetar los archivos de solución para que sean adecuados para el almacenamiento y el procesamiento del control de código fuente.
• Branch Solution: crea una nueva rama para almacenar la solución exportada.

Probar el flujo de trabajo de exportación y desempaquetado

1. A continuación, compruebe que se ejecuta el flujo de trabajo. Vaya a Acciones, seleccione Ejecutar flujo de trabajo y elija Ejecutar flujo de trabajo. Si usa un nombre de solución diferente a ALMLab, cambie el valor aquí, pero mantenga los demás valores iguales.

   

2. Después de 5 a 10 segundos, se inicia el flujo de trabajo. Puede seleccionar el flujo de trabajo en ejecución para supervisar el progreso.

   

   

3. Una vez finalizado el flujo de trabajo, compruebe que se crea una nueva rama con la solución desempaquetada en la solutions/ALMLab carpeta . Vaya a la pestaña Code y despliegue el menú desplegable de ramas.

4. Seleccione la rama que la acción creó.

5. Compruebe que la solutions/ALMLab carpeta se crea en la nueva rama. A continuación, cree una solicitud de extracción para fusionar los cambios con la rama principal. Seleccione Contribuir y, en el panel flotante, seleccione Abrir solicitud de incorporación de cambios.

6. En la pantalla Abrir una pull request, agregue un título y una descripción si lo desea y seleccione Crear pull request.

7. La pantalla se actualiza para mostrar la nueva solicitud de extracción. Al crear la solicitud de incorporación de cambios, recibirá la confirmación de que la rama no tiene ningún conflicto con la rama principal. Esta confirmación significa que puede combinar los cambios en la rama principal automáticamente. Seleccione Fusionar solicitud de extracción y, a continuación, seleccione Confirmar fusión. Opcionalmente, seleccione Eliminar la rama para quitar la rama, que ahora ha quedado obsoleta.

   

8. Vuelva a la rama predeterminada (main) y compruebe que la solución está disponible allí.

Crear un flujo de trabajo reutilizable para generar un artefacto de compilación e importarlo en producción

En esta sección, cree un flujo de trabajo adicional que:

• Crea una solución administrada y la publica como un artefacto de GitHub
• Importa el artefacto de compilación en entorno de producción

1. Vaya a Acciones y seleccione Nuevo flujo de trabajo.

   

2. Elija configurar un flujo de trabajo usted mismo.

   

3. Cambie el título del flujo de trabajo a release-solution-to-prod-with-inputs. Copie el contenido del archivo release-solution-to-prod-with-inputs.yml y péguelo en la pantalla Editar nuevo archivo .

   

4. Confirme los cambios. Elija Iniciar confirmación y luego agregue un título y una descripción (opcional). A continuación, seleccione Confirmar nuevo archivo.

   

Llamar al flujo de trabajo reutilizable en el evento de lanzamiento

En esta sección, llama al flujo de trabajo reutilizable en el evento release.

1. Vaya a Acciones y seleccione Nuevo flujo de trabajo.

   

2. Elija configurar un flujo de trabajo usted mismo.

   

3. Cambie el título del flujo de trabajo a release-action-call. Copie el contenido del archivo release-action-call.yml y péguelo en la pantalla Editar nuevo archivo .

   

4. Actualice las siguientes variables en el nuevo archivo de flujo de trabajo:

   • Actualice <BUILD_ENVIRONMENT> con la dirección URL del entorno de compilación que usa para generar la solución administrada. Por ejemplo: https://poweractionsbuild.crm.dynamics.com.
   • Actualice <PROD_ENVIRONMENT> con la dirección URL del entorno de producción en el que va a implementar. Por ejemplo: https://poweractionsprod.crm.dynamics.com.
   • Actualice <APP_ID> con el identificador de aplicación (cliente) que encuentra en la hoja Registros de aplicaciones de Microsoft Azure Portal seleccionando el registro que creó anteriormente en este tutorial.
   • Actualice <TENANT_ID> con el identificador del directorio (inquilino) que encuentra en el panel Registros de aplicaciones del Portal de Microsoft Azure seleccionando el registro que creó anteriormente en este tutorial.

5. Confirmar los cambios. Elija Iniciar commit y luego agregue un título (opcional) y una descripción (opcional). A continuación, seleccione Confirmar nuevo archivo.

   

Probar el flujo de trabajo de lanzamiento a producción

Ya está listo para probar el último flujo de trabajo. Este flujo de trabajo se desencadena cuando se implementa una nueva versión en producción.

1. Vaya a Lanzamientos.

   

2. Seleccione Crear un nuevo lanzamiento en borrador.

3. Agregue una etiqueta de lanzamiento, un título y elija Publicar lanzamiento.

4. Seleccione Acciones para ver el flujo de trabajo en ejecución.

   

5. Elija el flujo de trabajo en ejecución para ver las acciones a medida que se ejecutan.

   

6. Esperar a que se complete cada acción.

   

7. Una vez finalizado el flujo de trabajo, inicie sesión en el entorno de producción y compruebe que la solución se implementa como una solución administrada.

Implementar la actualización y revisar los cambios antes del lanzamiento de producción

Pruebe el proceso de un extremo a otro y, a continuación, vea cómo puede ver y validar los cambios en una aplicación antes de implementarlos en producción.

1. Vaya a la solución ALMLab en el entorno de desarrollo y seleccione Editar o seleccione el nombre para mostrar de la solución.

   

2. Seleccione y vea la tabla Solicitud de tiempo libre.

   

3. Seleccione + Add column y cree la nueva columna como se muestra en la ilustración siguiente.

   

   Valores de campo actualizados:**

   • Nombre para mostrar: Aprobado
   • Tipo de datos: Sí/No

4. Seleccione Listo.

5. Seleccione Guardar tabla.

6. Vuelva a la pestaña Acciones de repositorios de GitHub, seleccione Ejecutar flujo de trabajo y seleccione el botón Ejecutar flujo de trabajo.

   

7. Después de 5 a 10 segundos, se inicia el flujo de trabajo. Seleccione el flujo de trabajo en ejecución para supervisar su progreso.

   

   

8. Cuando finalice el flujo de trabajo, vaya a la nueva rama seleccionando Code y, a continuación, Branches.

   

9. Seleccione la rama que creó expandiendo Contribute y seleccionando Abrir pull request.

10. Agregue un título (opcional) y seleccione Crear solicitud de extracción.

11. Después de que se actualice el contenido, seleccione la pestaña Files changed.

12. Observe que los cambios en la solución están resaltados en verde para indicar que esta sección del archivo se agregó en comparación con el mismo archivo en la rama principal.

13. Vuelva a la pestaña Conversación. Seleccione Solicitudes de extracción y, a continuación, seleccione la solicitud de extracción que creó anteriormente.

14. En la página Solicitud de extracción, seleccione Combinar mediante combinación automática para combinar el archivo de solución actualizado en la rama principal. Opcionalmente, elimine lo que ahora se ha fusionado en main.

    

15. Siga los pasos descritos en la sección Probar el flujo de trabajo de versión para producción para crear una nueva versión y validar que la solución actualizada se implementa en el entorno de producción.

Enhorabuena, ha configurado correctamente un flujo de trabajo de CI/CD de ejemplo mediante GitHub Actions.

Véase también

Automatice su flujo de trabajo desde idea hasta producción