Configurar componentes de ALM Accelerator for Makers

Esta solución utiliza Acciones de GitHub para el control de la fuente y las implementaciones. El Conector de GitHub se usa en flujos para interactuar con GitHub. Más información: Usar los componentes de ALM Accelerator for Makers

Requisitos previos

Ambientes

Los componentes de ALM Accelerator for Makers gestionarán la implementación de soluciones desde el desarrollo hasta las pruebas y los entornos de producción. Necesitará entornos separados para implementar ALM Accelerator for Makers y para el desarrollo, las pruebas y la producción de su proyecto.

• Cree un entorno con una base de datos de Microsoft Dataverse para implementar ALM Accelerator for Makers.
• Cualquier entorno de destino (desarrollo, prueba o producción) requerirá una base de datos Dataverse para implementar soluciones.
• Cree una cuenta de GitHub en GitHub.com.
• Crear una organización de GitHub.

Usuarios y permisos

Necesitará los siguientes usuarios y permisos en Microsoft Power Platform y Azure Active Directory (Azure AD):

• Un usuario con licencia Power Apps con el rol administrador del sistema en el entorno donde se implementará ALM Accelerator for Makers.

  Nota

  Este usuario no debe haber habilitado la autenticación multifactor hasta que se habilite el soporte completo de los principales de servicio en los flujos de trabajo de GitHub.

• Un usuario de Azure con licencia con permisos para crear registros de aplicaciones y otorgar el consentimiento de administrador para los registros de aplicaciones en Azure AD.

• Una cuenta de GitHub en GitHub.com

• Una organización de GitHub

Crear un registro de aplicación Azure AD

Configurar un registro de aplicación Azure AD que se utilizará para crear entornos y recuperar soluciones dentro de un entorno.

1. Inicie sesión en portal.azure.com.

2. Vaya a Azure Active Directory > Registros de aplicaciones.

   

3. Seleccione + Nuevo registro.

4. Introduzca GithubDevOpsApp para el nombre, y luego seleccione Registrarse. No cambie ninguna otra configuración.

5. Seleccione Permisos de API > +Agregar un permiso.

6. Seleccione Dynamics CRM.

7. Seleccione Permisos delegados y luego seleccione user_impersonation.

   

8. Seleccione Agregar permisos.

9. Seleccione Conceder consentimiento de administrador para [su organización].

10. Seleccione Autenticar desde el menú.

11. En Configuración avanzada > Permitir flujos de clientes públicos, active la opción Habilite los siguientes flujos móviles y de escritorio.

12. Seleccione Guardar.

13. Seleccione Visión general y copie y pegue el valor de ID de la aplicación (cliente) en el Bloc de notas. Necesitará este valor en el siguiente paso cuando configure el conector personalizado.

Deje el portal de Azure abierto, porque deberá copiar alguna información después de haber configurado el conector personalizado.

Importar la solución

1. Descargue el archivo zip de la solución ALM Accelerator for Makers del repositorio del Kit de inicio de CoE (aka.ms/CoeStarterKitDownload: descargue el archivo ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip en "Activos").

2. Vaya a make.powerapps.com.

3. Vaya a su entorno de destino. En el ejemplo de la siguiente imagen, estamos importando al entorno llamado Contoso CoE.

   

4. Cree conexiones a todos los conectores utilizados como parte de la solución.

   1. Vaya a Datos > Conexiones.
   2. Seleccione + Nueva colección.
   3. Busque y seleccione Microsoft Dataverse.
   4. Seleccione + para crear una conexión.
   5. Complete los mismos pasos para los siguientes conectores:
      • Office 365 Outlook
      • GitHub
      • Power Apps for Makers
      • Power Platform for Admins
      • Aprobación
      • Content Conversion

5. En el panel de navegación izquierdo, seleccione Soluciones.

6. Seleccione Importar. Aparece una ventana emergente. (Si la ventana no aparece, asegúrese de que el bloqueador de elementos emergentes de su navegador esté desactivado e intente nuevamente).

7. En la ventana emergente, seleccione Elegir archivo.

8. Seleccione la solución ALM Accelerator en el Explorador de archivos (ALMAcceleratorForMakers_x.x.xxxxxxxx.x_managed.zip).

9. Cuando se haya cargado el archivo comprimido (.zip), seleccione Siguiente.

10. Revise la información y luego seleccione Siguiente.

11. Establezca conexiones para activar su solución. Si crea una nueva conexión, debe seleccionar Actualizar. No perderá su progreso de importación.

    

12. Seleccione Importar.

Configure los ajustes del entorno y las etapas de implementación después de la importación

1. Vaya a make.powerapps.com.
2. En el panel de navegación izquierdo, seleccione Soluciones.
3. Seleccione la solución Power Platform GitHub ALM y luego abra la aplicación Configuración de administrador del acelerador ALM.

Configurar etapas de implementación

1. Actualice el Correo electrónico del propietario de la fase para cada una de las tres etapas (DEV, PRUEBA, y PROD). El propietario de la etapa recibirá una notificación para aprobar la creación y el despliegue del proyecto.
2. Actualice el Nombre de usuario y contraseña de administrador. Estas credenciales pueden ser una cuenta de servicio o una cuenta de usuario con el rol administrador de Power Platform.
3. Para cada una de las etapas de prueba y producción, seleccione un entorno preexistente que se utilizará para implementaciones de prueba y producción. Su entorno de desarrollo es el entorno aprovisionado cuando creó un proyecto.

Actualizar el valor de la URL del webhook

Esta URL se utilizará para devoluciones de llamada desde GitHub.

1. En una nueva pestaña, vaya a make.powerapps.com > Soluciones > solución Power Platform GitHub ALM.
2. Edite el flujo WorkflowCompleteNotification.
3. Seleccione la primera acción y luego copie la URL en la acción.
4. Vuelve a la aplicación Administrador de ALM Accelerator y actualice el campo URL del webhook con el valor que copió en el paso anterior.
5. Seleccione Actualizar.

Actualizar el id. del cliente

El id. de cliente es necesario para que los flujos creen un entorno y realicen otras actividades relacionadas con la administración, como buscar soluciones y aplicaciones dentro de un entorno.

1. En la aplicación ALM Accelerator Admin, actualice el campo Identificación del cliente utilizando el valor de ID de la aplicación (cliente) que copió en el paso 13 de Crear un registro de la aplicación Azure AD.
2. Seleccione Actualizar

Actualice el nombre de la organización de GitHub

1. Introduzca el nombre de su organización de GitHub (consulte prerrequisitos, anteriormente en este artículo). Los repositorios se crearán dentro de esta organización.
2. Seleccione Actualizar.

Actualice el idioma

1. Cambie su idioma preferido, si lo desea. Power Apps usa el formato de etiqueta de idioma IETF BCP-47, por ejemplo en_US, fr_FR, it_IT.
2. Seleccione Actualizar.

Actualizar la configuración de Existe un plan de GitHub

Si existe un plan de organización de GitHub de pago para su organización, active la opción Existe un plan de GitHub.

Credenciales de administrador seguras

Seguridad a nivel de campo está habilitado para proteger las credenciales para las implementaciones. Como administrador, deberá agregar usuarios al perfil de seguridad de campo FieldSecurityForPassword; esto permite a esos usuarios agregar sus credenciales para la implementación desde el desarrollo hasta los entornos de prueba y producción.

Para agregar usuarios al perfil de seguridad de campo

1. Vaya a make.powerapps.com, seleccione Soluciones y luego abra la solución Power Platform GitHub ALM.

2. Seleccione FieldSecurityForPassword en la solución.

   

3. Seleccione Usuarios.

   

4. Seleccione Agregar.

5. Busque un usuario que desee agregar al perfil.

   

6. Seleccione para agregar el usuario al perfil de seguridad.

   

7. Repita este paso para todos los usuarios que utilizarán la aplicación ALM Accelerator for Makers.

8. Seleccione Guardar y cerrar.

   

Configurar los secretos de la organización de GitHub

Los secretos de la organización de GitHub se utilizarán para realizar llamadas a la API para importar y exportar soluciones y para interactuar con Dataverse. Los secretos son la forma recomendada de almacenar información confidencial.

GitHub admite secretos de organización y secretos a nivel de repositorio. Si tiene un plan pago, todos los secretos creados a nivel de organización también pueden ser utilizados por repositorios privados. Esa es la ventaja de tener un plan pago. De lo contrario, el administrador tiene que crear secretos para cada repositorio.

Más información: Ofertas del equipo de GitHub .

Plan de organización de GitHub pagado

Si tiene un plan de organización de GitHub de pago, configure los secretos de la organización siguiendo estos pasos:

1. Vaya a su organización en GitHub (https://github.com/yourorg).
2. Seleccione Configuración > Secreto > Nuevo secreto de organización
3. Introduzca DEV_ENVIRONMENT_SECRET como nombre de la etapa de implementación de desarrollo e ingrese el valor de su secreto.
4. En la lista Acceso al repositorio lista, seleccione Repositorios privados.
5. Seleccione Agregar secreto.
6. Repita los pasos anteriores para agregar un TEST_ENVIRONMENT_SECRET y PROD_ENVIRONMENT_SECRET.

Plan de organización de GitHub gratuito

Si no tiene un plan de organización de GitHub de pago, haga lo siguiente para todos los proyectos creados en la aplicación ALM Accelerator for Makers.

1. Vaya a su organización en GitHub (https://github.com/yourorg).
2. Seleccione Configuración > Secreto > Nuevo secreto de organización
3. Introduzca DEV_ENVIRONMENT_SECRET como nombre de la etapa de implementación de desarrollo e ingrese el valor de su secreto.
4. Seleccione Agregar secreto.
5. Repita los pasos anteriores para agregar un TEST_ENVIRONMENT_SECRET y PROD_ENVIRONMENT_SECRET.

Ahora puede Usar los componentes de ALM Accelerator for Makers.