Configurar el acelerador de ALM manualmente (en desuso)

Puede configurar los componentes de ALM Accelerator for Power Platform ya sea utilizando la aplicación de administración aplicación de administración complementaria o manualmente. Este artículo lo guía a través de la configuración manual de la aplicación y está estructurado en siete secciones:

• Requisitos previos
• Configuración básica
• Configuración del proyecto de desarrollo
• Configuración de la solución
• Importar la solución y configurar la aplicación
• Configurar creadores para usar la aplicación ALM Accelerator

Requisitos previos

Antes de instalar ALM Accelerator for Power Platform, asegúrese de cumplir con los siguientes requisitos previos.

• El acelerador de ALM debe estar instalado en un entorno de Power Platform que tenga una base de datos Microsoft Dataverse. Todos los entornos en los que use ALM Accelerator para implementar soluciones también requieren una base de datos de Dataverse.

  Nota

  ALM Accelerator no es compatible con Dataverse for Teams. Tanto la aplicación ALM Accelerator como las canalizaciones asociadas suponen que se utiliza la versión completa de Dataverse en todos los entornos.

  Le recomendamos que instale ALM Accelerator en el mismo entorno que otras soluciones del kit de inicio de CoE. Obtenga más información sobre cómo determinar la mejor estrategia para su organización:

  • Estableciendo una estrategia de entorno para Microsoft Power Platform
  • Estrategia del entorno para ALM.

• El acelerador de ALM usa Azure DevOps para el control de código fuente y las implementaciones. Si no tiene una organización de Azure DevOps, regístrese gratuitamente para un máximo de cinco usuarios en el sitio Azure DevOps.

• Para completar los pasos de esta sección, necesita los siguientes usuarios y permisos en Azure, Azure DevOps y Power Platform:

  • Un usuario con licencia Azure con permisos para crear y ver grupos de Microsoft Entra, crear registros de aplicaciones y conceder consentimiento del administrador a los registros de aplicaciones en Microsoft Entra ID
  • Un usuario con licencia Azure DevOps con permisos para crear y administrar canalizaciones, conexiones de servicio, repositorios y extensiones
  • Un usuario de Power Platform con licencia y permisos para crear usuarios de la aplicación y concederlos permisos administrativos

• Los siguientes conectores deben estar disponibles para usarse juntos en el entorno en el que se importa ALM Accelerator:

  • Dataverse (heredado)
  • HTTP
  • Power Apps for Makers
  • HTTP con Microsoft Entra ID (con acceso de punto de conexión a https://graph.microsoft.com)
  • ALM Accelerator Custom DevOps (este conector se creará como parte de la importación de la solución Accelerator)
  • Office 365 Usuarios
  • HTTP

• Instale Creator Kit en el entorno donde instala ALM Accelerator.

Configuración básica

Los pasos siguientes son generales para la funcionalidad de ALM Accelerator y no son específicos de ningún proyecto o solución.

Creación de un registro de aplicaciones en el entorno de Microsoft Entra

Cree un registro de aplicación para el Acelerador de ALM para conceder a la aplicación y los permisos de canalizaciones asociados necesarios para realizar operaciones en Azure DevOps y Power Apps o Dataverse. Solo necesita hacer esto una vez.

En los pasos siguientes se muestra cómo crear un registro de aplicación único con permisos para Dataverse y Azure DevOps. Sin embargo, es posible que desee crear registros de aplicaciones independientes para dividir las responsabilidades. Debe considerar cómo los registros de aplicaciones independientes afectan tanto el mantenimiento como la seguridad antes de decidir una estrategia de registro de aplicaciones.

Crear el registro de la aplicación

1. Inicie sesión en el portal Azure.

2. Seleccione Microsoft Entra ID>Registros de aplicaciones.

3. Seleccione + Nuevo registro y luego asigne un nombre al registro, como ALMAcceleratorServicePrincipal.

4. Deje todas las demás opciones en sus valores predeterminados y luego seleccione Registrarse.

Agregar permisos al registro de la aplicación

1. En el panel del lado izquierdo, seleccione Permisos de API.

2. Seleccione +Agregar un permiso.

3. Seleccione Dynamics CRM y, a continuación, seleccione Permisos delegados y user_impersonation.

4. Seleccione Agregar permisos para añadir el permiso de user_impersonation de la API de Dynamics CRM al registro de la aplicación.

5. Seleccione + Agregar un permiso de nuevo.

6. Seleccione la pestaña API que usa mi organización. Busque y seleccione PowerApps-Advisor y, a continuación, seleccione Permisos delegados y Analysis.All (no se requiere el consentimiento del administrador).

   Este permiso es necesario para ejecutar análisis estático a través del verificador de aplicaciones.

7. Seleccione Agregar permisos para agregar el permiso Analysis.All de API de PowerApps-Advisor al registro de aplicación.

8. Seleccione + Agregar un permiso de nuevo.

9. En la pestaña Microsoft API o el APIs que usa mi organización pestaña, Seleccione Azure DevOps y, después, seleccione Permisos delegados y user_impersonation.

   Este permiso es necesario para conectarse a Azure DevOps a través del conector personalizado en la aplicación aceleradora de ALM.

10. Si agregó el permiso de Azure DevOps desde la pestaña APIs que utiliza mi organización, copie el Id. de Aplicación (cliente) para usarlo más adelante en este procedimiento.

    Usará este valor como Id. de aplicación DevOps (cliente), que es diferente del Id. de aplicación DevOps (cliente) que copiará más tarde en este procedimiento.

    Captura de pantalla de la ventana Solicitar permisos de API, con la pestaña API que utiliza mi organización y el ID de la aplicación (cliente) resaltados.

    Si no encuentra los permisos de Azure DevOps en la pestaña las APIs que usa mi organización, siga estos pasos para obtener el ID de Aplicación DevOps (cliente):

    1. Abra una ventana privada del navegador y vaya a .
    2. En la página de inicio de sesión, copie el valor del parámetro client_id en la URL.

    

11. Seleccione Agregar permisos para agregar el permiso user_impersonation API de Azure DevOps al registro de aplicaciones.

12. Seleccione Conceder consentimiento de administrador para su inquilino.

Configurar el secreto del cliente y la URI de redireccionamiento

1. En el panel lateral izquierdo, seleccione Certificados y secretos.

2. Seleccione + Nuevo secreto de cliente.

3. Seleccione la fecha de caducidad y seleccione Agregar.

4. Copie el secreto del cliente Valor para usarlo más adelante. Esta es la única vez que puede copiar el valor. Asegúrese de hacerlo antes de salir de la página.

5. En el panel del lado izquierdo, seleccione Descripción general.

6. Copie ID de la aplicación (cliente) e ID del directorio (inquilino).

7. Seleccione Configurar.

Otorgue permiso a Power App Management para el registro de su aplicación

Otorgue permisos de Power App Management para el registro de su aplicación para que las canalizaciones puedan realizar las acciones que necesitan en sus entornos. Para ello, ejecute el siguiente cmdlet de PowerShell como un usuario interactivo que tenga Power Apps privilegios administrativos. Solo necesita ejecutar este comando una vez, después de crear el registro de su aplicación.

Install-Module -Name Microsoft.PowerApps.Administration.PowerShell
Install-Module -Name Microsoft.PowerApps.PowerShell -AllowClobber
New-PowerAppManagementApp -ApplicationId <the Application (client) ID you copied when you created the app registration>

Instalación de extensiones de Azure DevOps

El acelerador de ALM usa varias extensiones de Azure DevOps, incluidas algunas extensiones de terceros que están disponibles en Azure DevOps Marketplace. El sitio web de cada extensión de terceros y un enlace a su código fuente se proporcionan en las siguientes instrucciones. Aprenda a evaluar a un editor de extensiones de Marketplace.

1. Inicie sesión en Azure DevOps.

2. Seleccione Configuración de organización.

3. Seleccione GeneralExtensiones.

4. Busque e instale las siguientes extensiones:

   • Power Platform Build Tools (obligatorias): esta extensión contiene las tareas de compilación de Microsoft para Power Platform. ()

   • Reemplazar tokens (requerido): las canalizaciones utilizan esta extensión para reemplazar tokens en los archivos de configuración y almacenar valores seguros en variables privadas configuradas para una canalización. ()

   • SARIF SAST Scans Tab (opcional): use esta extensión para visualizar los archivos SARIF que genera el comprobador de soluciones durante una compilación. (Pestaña SARIF SAST Scans - Visual Studio Marketplace)

     

Clonar los pipelines de YAML de GitHub a su instancia de Azure DevOps

1. Vaya a y copie la URL de la versión más reciente.

2. Inicie sesión en Azure DevOps.

3. Cree un proyecto o seleccione un proyecto existente.

4. Seleccione Repos y, a continuación, seleccione Repositorioimport en la lista de repositorios.

5. Pegue la URL que copió en el paso 1 como URL de clonación y luego seleccione Importar.

6. Confirme que la rama predeterminada para el repositorio es la principal. Seleccione Repos y Branches y asegúrese de que la rama main está etiquetada como predeterminada.

   Si no es así, seleccione los tres puntos verticales (⋮) correspondientes a la rama principal y en el menú Más opciones, seleccione Establecer como rama predeterminada.

   Nota

   Este repositorio es donde se ejecutan las plantillas de canalización de solución y las canalizaciones de exportación/importación. Más tarde, cuando cree las canalizaciones para sus soluciones, es posible que deba hacer referencia a este proyecto y repositorio específico si elige usar un repositorio diferente para el control del código fuente de sus soluciones.

Crear canalizaciones para importar, eliminar y exportar soluciones

Cree canalizaciones de importación, eliminación y exportación basadas en YAML en el repositorio de Azure DevOps. Estas canalizaciones se ejecutan cuando se usa la aplicación para confirmar una solución en Git, importar una solución o eliminar una solución.

La siguiente tabla muestra la correspondencia entre el archivo YAML en el repositorio y la canalización que lo acompaña.

1. En Azure DevOps, vaya a Pipelines>Crear una nueva canalización.

2. Seleccione Azure Repos Git para su repositorio de código y, a continuación, apunte al repositorio de código de Azure DevOps que creó e inicializó con las plantillas de canalización en los pasos anteriores.

3. En la página Configurar la canalización, seleccione Existing Azure Pipelines archivo YAML y apunte a /Pipelines/export-solution-to-git.yml, /Pipelines/import-unmanaged-to-dev-environment.yml o /Pipelines/delete-unmanaged-solution-and-components.yml.

4. Seleccione Continuar y, a continuación, Guardar.

5. Seleccione el menú Más (…) junto a Ejecutar canalización y luego seleccione Cambiar nombre/mover.

6. Cambie el nombre de la canalización a export-solution-to-git, import-unmanaged-to-dev-environment o delete-unmanaged-solution-and-components, según corresponda.

7. Seleccione Guardar.

Crear variables de canalización de exportación (opcional)

Puede establecer variables de canalización en la canalización export-solution-to-git para controlar qué información se conserva en el control de código fuente. Para aplicar esta configuración globalmente, configure las variables en su canalización export-solution-to-git. Para aplicar la configuración a soluciones específicas en la exportación, cree una canalización de exportación específica para su solución como se describe en la nota de la sección anterior y configure las variables en esa canalización.

Para asegurarse de que los valores actuales de las variables de entorno nunca se confirmen en el control de código fuente durante el proceso de exportación, cree la variable en su canalización de exportación de solución a Git y establezca su valor en True.

Para asegurarse de que los valores de las variables de entorno predeterminados específicos se establezcan durante la exportación de una solución, cree la variable en su canalización de exportación de solución a Git y establezca su valor en True. Establezca los valores de las variables de entorno predeterminadas en customDeploymentSettings.json como se describe en la guía de configuración de implementación.

1. En Azure DevOps, seleccione Pipelines>Library>Crear un nuevo grupo de variables.

2. Llame al nuevo grupo de variables alm-accelerator-variable-group, exactamente como se indica aquí.

   Las canalizaciones hacen referencia a este grupo de variables específico, por lo que debe nombrarse exactamente como se muestra. Si decide utilizar una convención de nomenclatura diferente para el grupo de variables, debe modificar partes de las canalizaciones para que hagan referencia al nombre que utilice en su lugar.

3. Agregue las siguientes variables al grupo de variables:

   Nombre	Descripción	valor
   AADHost	Punto de conexión de autorización de Microsoft Entra	Para nubes públicas, utilice login.microsoftonline.com. Para nubes gubernamentales, utilice la URL de autorización adecuada.
   ProcessCanvasApps	Si las aplicaciones de lienzo se desempaquetan durante la exportación o se empaquetan durante las compilaciones	Si es False, las aplicaciones de lienzo no se desempaquetan durante la exportación o se empaquetan durante las compilaciones. La función de desempaquetar y empaquetar aplicaciones de lienzo está en versión preliminar y no se recomienda su uso en entornos de producción en este momento. Sin embargo, no puede ver el código fuente del lienzo en el control de código fuente a menos que establezca esta variable en True.

4. (Opcional) Si usa Canvas Studio Test Automation en sus canalizaciones, agregue las siguientes variables al grupo de variables:

   Nombre	valor
   TestAutomationLoginMethod	CloudIdentity
   TestAutomationMakerPortalUrl	Dirección URL del portal de Power Apps maker, normalmente *https://make.powerapps.com*
   TestAutomationUsername	La cuenta de usuario utilizada para ejecutar las pruebas automatizadas
   TestAutomationPassword	La contraseña para la cuenta de usuario utilizada para ejecutar las pruebas automatizadas

5. (Opcional) De forma predeterminada, las variables globales están restringidas y necesita configurar el acceso para cada canalización. Puede simplificar eso y permitir el acceso para cualquier canalización. En el Grupo de variables (CanalizacionesBibliotecaalm-accelerator-variable-group), seleccione Permisos de canalización en el menú superior, seleccione (…) y luego seleccione Abrir acceso.

Establecer permisos para el servicio de compilación del proyecto

1. En Azure DevOps, seleccione Configuración del proyecto.

2. Seleccione RepositoriosSeguridad.

3. En Usuarios, busque y seleccione Servicio de compilación de colección del proyecto (nombre de su organización).

   Nota

   Es posible que no vea el nombre de su organización después del usuario de Servicio de compilación de colección del proyecto. Puede ser solo un identificador único. En ese caso, use la función de búsqueda para buscar el usuario y, a continuación, selecciónelo.

4. Establezca los siguientes permisos para el usuario del servicio de compilación:

   Permiso	valor
   Contribuir	Permitir
   Contribuir a solicitudes de extracción	Permitir
   Crear rama	Permitir
   Editar directivas	Permitir

5. En Usuarios, busque y seleccione Servicio de compilación de colección de su nombre de proyecto (nombre de su organización).

6. Establezca los mismos valores que en el paso 4.

7. Seleccione Canalizaciones, seleccione los tres puntos (…) en la esquina superior derecha y luego seleccione Administrar seguridad.

8. Establezca los siguientes permisos para el usuario Nombre de su proyecto Servicio de compilación (Nombre de su organización):

   Permiso	valor
   Editar canalización de compilación	Permitir
   Editar calidad de compilación	Permitir
   Administrar cola de compilación	Permitir
   Anular validación de registro por compilación	Permitir
   Actualizar información de compilación	Permitir
   Ver canalización de compilaciones	Permitir
   Ver compilaciones	Permitir

9. Seleccione Configuración de proyectoGrupos de agentes, seleccione Seguridad y, a continuación, Agregar.

10. Busque y seleccione Servicio de compilación de su nombre de proyecto (nombre de su organización).

11. Establezca el Rol en Lector.

12. Seleccione Agregar.

13. (Opcional) De forma predeterminada, los permisos de las canalizaciones para cada repositorio están restringidos y necesita configurarlos individualmente. Puede simplificar eso y permitir el acceso para cualquier canalización. En Configuración del proyectoRepositorios, seleccione cada repositorio a la vez. En el menú superior, seleccione Seguridad. Busque el bloque Permisos de canalizaciones, seleccione (…) y luego Abrir acceso.

Configuración del proyecto de desarrollo

La sección siguiente le guía a través de los pasos de configuración necesarios para configurar cada uno de los proyectos de desarrollo que realice. En este contexto, un proyecto de desarrollo abarca la infraestructura y la configuración que permiten una administración del ciclo de vida (ALM) correcta, incluida la configuración de su entorno de Dataverse que respalda el proceso de ALM propiamente dicho.

Creación de conexiones de servicio para que Azure DevOps accedan a Power Platform

Cada entorno de Dataverse (desarrollo, validación, prueba y producción) debe tener una conexión de servicio power Platform en Azure DevOps. Para cada entorno, realice los siguientes pasos.

1. Inicie sesión en Azure DevOps y seleccione el proyecto.

2. Seleccione Configuración del proyectoConexiones de servicio y luego seleccione Crear conexión de servicio.

3. Busque y seleccione el tipo de conexión del servicio de Power Platform.

4. Seleccione Siguiente.

5. Para Dirección URL del servidor, introduzca la dirección URL del entorno, por ejemplo .

   Importante

   Debe incluir la barra diagonal final (/) en la URL, es decir, después de .com en este ejemplo.

6. Para Nombre de conexión de servicio, introduzca la misma dirección URL que en el paso 4, incluida la barra diagonal de la formación (/).

7. Escriba el Id. de inquilino, Id. de aplicación (cliente) y Secreto de cliente que copió de Microsoft Entra cuando creó el registro de la aplicación.

8. Seleccione Otorgar permisos de acceso a todas las canalizaciones.

9. Seleccione Guardar.

Las conexiones de servicio deben proporcionar permisos de usuario a todos los usuarios en todos los entornos a los que los usuarios deben acceder desde la aplicación (por ejemplo, entornos de creador).

1. En la lista Conexiones de servicio, seleccione la conexión de servicio que se compartirá con los usuarios.

2. Seleccione Más (…) en la esquina superior derecha y, a continuación, Seguridad.

3. En la lista Grupo o usuario, seleccione el usuario o grupo al que desea otorgar permisos de usuario.

4. Seleccione Usuario, seleccione un Rol y, a continuación, seleccione Agregar.

Repita los pasos de esta sección para cada uno de sus entornos de desarrollo, validación, prueba y producción.

Establezca los permisos para que el servicio de compilación del proyecto use las conexiones de servicio

1. En Azure DevOps, seleccione Configuración del proyecto>Conexiones de servicio.

2. Seleccione (…) en la esquina superior derecha, seleccione Seguridad y luego Agregar.

3. Busque y seleccione Servicio de compilación de su nombre de proyecto (nombre de su organización).

4. Establezca el Rol en Administrador y luego seleccione Agregar.

Crear un usuario de la aplicación en los entornos de Dataverse

Cree un usuario de la aplicación en sus entornos para permitir que las canalizaciones se conecten a Dataverse. Haga esto en cada entorno en el que planee usar ALM Accelerator para implementar.

1. Inicie sesión en el Centro de administración de Power Platform.

2. Seleccione su entorno de implementación y, a continuación, Configuración.

3. Seleccione Usuarios + permisosUsuarios de la aplicación.

4. Seleccione + Nuevo usuario de la aplicación.

5. Seleccione + Agregar una aplicación, seleccione el registro de la aplicación que creó antes y luego seleccione Agregar.

6. Seleccione la unidad de negocio.

7. Seleccione el ícono de lápiz a la derecha de Funciones de seguridad y luego seleccione funciones de seguridad para el usuario de la aplicación.

   Recomendamos que otorgue a la aplicación privilegios de rol de seguridad de administrador del sistema para que este pueda realizar las funciones requeridas en cada entorno.

8. Seleccione Crear.

Repita estos pasos en los entornos de validación, prueba y producción.

Configuración de la solución

Cuando cree una solución en Dataverse, deberá crear canalizaciones específicamente para esa solución. Las siguientes canalizaciones de ejemplo se incluyen en el directorio Canalizaciones del repositorio coe-alm-templates.

• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-validation-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-test-SampleSolution.yml
• https://github.com/microsoft/coe-alm-accelerator-templates/blob/main/Pipelines/build-deploy-prod-SampleSolution.yml

Las canalizaciones de ejemplo brindan flexibilidad para que las organizaciones almacenen sus plantillas de canalización en un proyecto o repositorio separado del YAML de canalización de la solución específica. Siga los pasos de esta sección para configurar la canalización de su solución. Repita estos pasos para cada solución para la que use ALM Accelerator para control de código fuente.

Crear las canalizaciones de implementación y compilación de la solución

Las canalizaciones de soluciones se utilizan para compilar e implementar sus soluciones con control de código fuente en los entornos de su inquilino. Las canalizaciones de ejemplo asumen que usa solo tres entornos: validación, prueba y producción. Sin embargo, puede crear tantas canalizaciones de soluciones como sea necesario en función de la estrategia de entorno de su organización.

Las canalizaciones de implementación de ejemplo se desencadenan mediante cambios en una rama (es decir, prueba y producción) o como parte de una directiva de rama en Azure DevOps (es decir, validación). Obtenga más información sobre la configuración de directivas de rama para la validación de solicitudes de extracción. También puede ejecutar canalizaciones manualmente, sin un disparador.

Siga los pasos de esta sección para crear canalizaciones de implementación a partir de la canalización de muestra YAML. La siguiente tabla describe la configuración de canalización.

Crear el archivo de canalización

1. En Azure DevOps, vaya al repositorio que contiene la carpeta pipelines que ha confirmado y seleccione la carpeta Pipelines.

2. Abra una de las tres canalizaciones de implementación de ejemplo y copie el YAML para usarlo en su nueva canalización.

3. Anote el nombre del repositorio para usarlo en su canalización.

4. Vaya al repositorio que desea usar para el control del código fuente de su solución.

5. Cree una rama basada en su rama predeterminada y asígnele el nombre de su solución; por ejemplo, MyNewSolution.

   Esta rama se convierte en la rama de su próxima versión (v-next) para su solución en el repositorio. Todo el trabajo de desarrollo debe derivarse desde esta rama hasta una rama de trabajo personal del desarrollador y luego combinarse en la rama v-next para impulsar la validación y las pruebas. Más tarde, cuando una versión esté lista, la rama v-next se puede combinar con la rama principal o predeterminada.

6. Seleccione Nuevo en el menú superior y luego seleccione Carpeta.

7. Asigne a la nueva carpeta el mismo nombre que su solución.

8. De al archivo YAML de la canalización un nombre, como build-deploy-validation-SampleSolution.yml, build-deploy-test-SampleSolution.yml o build-deploy-prod-SampleSolution.yml.

9. Seleccione Crear.

Actualizar y guardar el archivo

1. Pegue el YAML que copió en el paso 2 de la sección anterior en el nuevo archivo de canalización.

2. Cambie los siguientes valores en el nuevo YAML de canalización:

   • Cambie RecursosRepositoriosNombre al nombre del repositorio que contiene sus plantillas de canalización.

     En este ejemplo, el repositorio se llama coe-alm-accelerator-templates y existe en el mismo proyecto que el repositorio MyNewSolution. Si el repositorio de plantillas está en un proyecto de Azure DevOps diferente, use el formato ProjectName/RepoName. También puede especificar una rama para la ubicación de sus plantillas mediante el parámetro si es necesario.

   • Cambie cualquier valor que haga referencia a SampleSolutionName al nombre único de su solución; por ejemplo, MyNewSolution.

3. Seleccione Confirmar para guardar los cambios.

4. En Azure DevOps, vaya a Pipelines y seleccione Crear una nueva canalización.

5. Seleccione Azure Repos Git para el repositorio de código.

6. Seleccione el Repositorio de DevOps, que contiene el YAML de canalización de implementación.

7. En la página Configurar la canalización, seleccione Archivo YAML existente de Azure Pipelines, apunte al archivo YAML del repositorio que creó anteriormente y, a continuación, seleccione Continuar.

8. Seleccione Guardar, seleccione ... junto a Ejecutar canalización y luego seleccione Cambiar nombre/mover.

9. Cambie el nombre de la canalización a deploy-validation-MyNewSolution, deploy-test-MyNewSolution o deploy-prod-MyNewSolution, donde MyNewSolution es el nombre de su solución.

10. Seleccione Guardar.

11. Si su canalización nueva no se creó en la rama predeterminada del repositorio: seleccione Editar en la canalización. Seleccione ... en la esquina superior derecha y, a continuación, Desencadenadores. Seleccione la pestaña YAML y luego seleccione Obtener orígenes. Cambie la Rama predeterminada para compilaciones manuales y programadas para apuntar a la rama de solución. Más información sobre cómo configurar desencadenadores de canalización

12. Repita los pasos anteriores para crear una canalización de implementación para cada uno de sus entornos haciendo referencia al YAML de canalización de implementación de ejemplo desde el repo coe-alm-accelerator-templates (deploy-validation-SampleSolution.yml, deploy-test-SampleSolution.yml y deploy-prod-SampleSolution.yml).

13. Seleccione Guardar y poner en cola y luego seleccione Guardar.

Crear la canalización de implementación de la solución (opcional)

Como se mencionó antes, los pasos de la sección anterior le permiten crear canalizaciones que se compilan e implementan para los entornos de validación, prueba y producción. Sin embargo, puede crear una canalización de implementación de solución aparte si desea compilar e implementar solo para validación y prueba, y luego implementar los artefactos desde la compilación de prueba hasta la producción.

Siga los pasos de esta sección para crear una canalización de implementación de solución a partir de la canalización de muestra YAML. La siguiente tabla describe la configuración de canalización.

1. En Azure DevOps, vaya al repositorio que contiene la carpeta pipelines que ha confirmado y seleccione la carpeta Pipelines.

2. Abra la canalización de implementación de ejemplo deploy-prod-pipelineartifact-SampleSolution.yml y copie el YAML para utilizarlo en su nueva canalización.

3. Anote el nombre del repositorio para usarlo en su canalización.

4. Vaya al repositorio que desea usar para el control del código fuente de su solución.

5. Seleccione Nuevo en el menú superior y, a continuación, seleccione Archivo.

6. Asigne un nombre al nuevo archivo YAML de canalización; por ejemplo, deploy-prod-MyNewSolution.yml, donde MyNewSolution es el nombre de su solución.

7. Seleccione Crear.

8. Pegue el YAML que copió en el paso 2 en el nuevo archivo de canalización.

9. Cambie los siguientes valores en el nuevo YAML de canalización:

   • Cambie DesencadenarRamasIncluir a las ramas en las que los cambios deberían desencadenar una implementación en producción.

   • Cambie RecursosRepositoriosNombre al nombre del repositorio que contiene sus plantillas de canalización.

     En este ejemplo, el repositorio se llama coe-alm-accelerator-templates y existe en el mismo proyecto que el repositorio MyNewSolution. Si el repositorio de plantillas está en un proyecto de Azure DevOps diferente, use el formato ProjectName/RepoName. También puede especificar una rama para la ubicación de sus plantillas mediante el parámetro si es necesario.

   • Actualice RecursosCanalizacionesOrigen para especificar la canalización de compilación que contiene los artefactos que esta canalización debería implementar. En este caso, va a implementar los artefactos de la canalización de prueba que creó anteriormente, que compiló e implementó su solución en el entorno de prueba.

   • Cambie cualquier valor que haga referencia a SampleSolutionName al nombre único de su solución; por ejemplo, MyNewSolution.

10. Repita los mismos pasos del 11 al 20 en la sección anterior para deploy-validation-ALMAcceleratorSampleSolution y deploy-test-ALMAcceleratorSampleSolution para crear una canalización desde el nuevo YAML de canalización de producción llamado deploy-prod-ALMAcceleratorSampleSolution.

Establecer variables de canalización de implementación

Para cada canalización de implementación que haya configurado anteriormente, debe establecer las variables y en función del entorno en el que se implementa su canalización. También puede establecer la variable EnableFlows para desactivar los flujos de Power Automate como parte de una implementación.

Crear variables de entorno y conexión de servicio (obligatorio)

Cada canalización de implementación requiere la variable de entorno y la variable de conexión de servicio .

• EnvironmentName especifica el entorno Azure DevOps que se implementa para habilitar el historial de implementación de seguimiento y establecer permisos y aprobaciones para la implementación en entornos específicos. Establezca este valor en Validación, Prueba o Producción, según corresponda.

• especifica cómo se conecta la canalización de implementación a Power Platform. Los valores permitidos son los nombres de las conexiones de servicio que creó anteriormente.

1. Seleccione Editar en cada una de las canalizaciones de implementación.

2. Seleccione Variables en la definición de canalización de implementación para abrir el editor de variables.

3. Para agregar una variable, (+). Ingrese el nombre de la variable y el valor apropiado.

Repita estos pasos para crear las variables y .

Crear la variable EnableFlows (opcional)

Puede establecer el valor de una variable de canalización denominada EnableFlows en False para omitir los pasos que habilitan automáticamente los flujos de Power Automate como parte de una implementación. El valor predeterminado de la variable es True.

Establecer directivas de rama para la validación de solicitudes de extracción

Cree una directiva de rama para ejecutar la canalización que creó anteriormente cuando se crea una solicitud de extracción.

1. En Azure DevOps, vaya a Repos y seleccione la carpeta Branches.

2. Busque la rama para la que quiere crear la directiva de solicitud de extracción. Seleccione los puntos suspensivos (…) que están a la derecha de la rama y después seleccione Directivas de rama.

3. En la página Directivas de rama, vaya a Validación de compilación.

4. Seleccione para agregar una nueva directiva de rama.

5. En la lista Crear canalización, seleccione la canalización que creó anteriormente.

6. Especifique un Filtro de ruta si corresponde, para asegurarse de que solo los cambios en la ruta especificada activen la canalización para la solicitud de extracción.

7. Selecciona el Desencadenador como Automático.

8. Establezca el Requisito de directiva como Requerido.

9. Establezca la Caducidad de compilación como Inmediatamente.

10. Establezca un Nombre para mostrar para la directiva de rama; por ejemplo, Validación de compilación de relaciones públicas.

11. Seleccione Guardar.

Captura de pantalla de la selección de configuraciones para una política de compilación de validación.

Establecer permisos de acceso a recursos para canalizaciones

Las canalizaciones necesitan acceder a los recursos necesarios, como repositorios, grupos de variables y conexiones de servicio, para ejecutarse. Para permitir el acceso, tiene tres opciones.

Otorgar acceso durante la primera ejecución

Puede permitir el acceso a un recurso necesario durante la primera ejecución de la canalización.

1. Desencadene la canalización y abra la ejecución de la canalización en Azure DevOps.
2. Seleccione el botón Ver en el banner de "permiso requerido".
3. Seleccione Permitir para cada recurso requerido.

Dar permiso explícito

Puede otorgar permiso explícito para que una canalización acceda a los repositorios requeridos.

1. En Azure DevOps, abra Configuración del proyecto.
2. Seleccionar Repositorios y luego seleccione un repositorio.
3. Seleccione la pestaña Seguridad.
4. Desplácese hacia abajo hasta Permisos de canalizaciones y seleccione .
5. Seleccione la canalización a la que desea dar acceso al repositorio.

Puede otorgar permiso explícito para que una canalización acceda a los grupos de variables requeridos.

1. En Azure DevOps, seleccione Pipelines>Library y, a continuación, seleccione un grupo de variables.
2. Seleccione Permisos de canalizaciones.
3. Seleccione y luego seleccione la canalización a la que desea dar acceso al grupo de variables.

Puede otorgar permiso explícito para que una canalización acceda a las conexiones de servicio requeridas.

1. En Azure DevOps, abra Configuración del proyecto.
2. Seleccione Conexiones de servicio y luego seleccione una conexión de servicio.
3. Seleccione Más acciones (…) y, a continuación, seleccione Seguridad.
4. Desplácese hacia abajo hasta Permisos de canalizaciones y seleccione .
5. Seleccione la canalización a la que desea dar acceso a la conexión de servicio.

Otorgar acceso a todas las canalizaciones

Puede permitir que todas las canalizaciones, tanto las que tiene ahora como las que cree en el futuro, accedan a los repositorios requeridos.

1. En Azure DevOps, abra Configuración del proyecto.
2. Seleccionar Repositorios y luego seleccione un repositorio.
3. Seleccione la pestaña Seguridad.
4. Desplácese hacia abajo hasta Permisos de canalizaciones.
5. Seleccione Más acciones (…), Abrir acceso y luego confirme cuando se le solicite.

Puede permitir que todas las canalizaciones accedan a los grupos de variables necesarios.

1. En Azure DevOps, seleccione Pipelines>Library y, a continuación, seleccione un grupo de variables.
2. Seleccione Permisos de canalizaciones.
3. Seleccione Más acciones (…), Abrir acceso y luego confirme cuando se le solicite.

Puede permitir que todas las canalizaciones accedan a las conexiones de servicio necesarias.

1. En Azure DevOps, abra Configuración del proyecto.
2. Seleccione Conexiones de servicio y luego seleccione una conexión de servicio.
3. Seleccione Más acciones (…) y, a continuación, seleccione Seguridad.
4. Seleccione una conexión de servicio, seleccione Más acciones (…) y luego seleccione Seguridad.
5. Desplácese hacia abajo hasta Permisos de canalizaciones.
6. Seleccione Más acciones (…), Abrir acceso y luego confirme cuando se le solicite.

Establecer alcance de autorización de trabajo

El ámbito de autorización del trabajo se puede establecer para toda la organización de Azure DevOps o para un proyecto específico. Deshabilite la opción Limitar el ámbito de autorización del trabajo al proyecto actual para las canalizaciones de liberación si elige un proyecto diferente de Azure DevOps para instalar las plantillas.

Para establecer el alcance de la autorización de trabajo a nivel de organización para todos los proyectos

1. En Azure DevOps, elija Configuración de organización > Pipelines > Settings.
2. Deshabilite la configuración Limitar el alcance de la autorización de trabajo al proyecto actual para las canalizaciones de lanzamiento.

Crear una configuración de implementación (opcional)

Debe crear varias configuraciones en un entorno de destino después de implementar una solución. Estas configuraciones son específicas del entorno e incluyen referencias de conexión, variables de entorno y permisos para grupos de Microsoft Entra y equipos de Dataverse, además de compartir aplicaciones de lienzo y actualizar la propiedad de componentes de solución, como flujos de Power Automate. Junto con estas configuraciones, un entorno de destino a menudo necesita datos de ejemplo o configuración asociados con tablas de Dataverse en la solución para proporcionar una experiencia ALM completa de extremo a extremo.

Si la solución requiere estas otras configuraciones o datos, siga la guía de configuración de implementación para configurar sus canalizaciones en función de los entornos en los que está implementando.

Importación de la solución y configuración de la aplicación

Importe la aplicación de lienzo del ALM Accelerator en su entorno de Power Platform. Luego, configure el conector personalizado incluido para Azure DevOps.

Instalar ALM Accelerator en Dataverse

1. La solución ALM Accelerator depende del Creator Kit. Instale Creator Kit ahora.

2. Descargue el archivo de solución administrada más reciente de GitHub. Desplácese hacia abajo hasta Activos y seleccione CenterofExcellenceALMAccelerator_última versión_managed.zip.

3. Inicie sesión en Power Apps y, a continuación, seleccione el entorno que desea hospedar la aplicación aceleradora de ALM.

4. En el panel izquierdo, seleccione Soluciones.

5. Seleccione Importar soluciónExaminar y, a continuación, busque la ubicación de la solución administrada que descargó y seleccione el archivo.

6. Seleccione Siguiente y luego seleccione Siguiente otra vez.

7. En la página Conexiones, seleccione o cree una nueva conexión para conectarse a la Conexión CDS DevOps a Dataverse.

   Al crear una conexión para HTTP con Microsoft Entra, use Microsoft Graph para ambos parámetros.

8. Seleccione Importar.

Configurar el conector personalizado de DevOps

1. Seleccione DatosConectores personalizadosCustomAzureDevOps.

2. Seleccione Editar. En la página Seguridad, seleccione Editar y luego configure los siguientes campos:

   Nombre	valor
   Tipo de autenticación	OAuth 2.0
   Proveedor de identidades	Azure Active Directory
   Id. de cliente	El Id. de aplicación (cliente) que copió al crear el registro de la aplicación
   Secreto de cliente	El valor del secreto de la aplicación (cliente) que copió al crear el registro de la aplicación
   Id. de inquilino	Deje el valor predeterminado, común
   URL del recurso	El Id. de la aplicación DevOps (cliente) que copió al agregar permisos al registro de su aplicación
   URL de redireccionamiento	Se genera automáticamente. Si observa la casilla de verificación "Actualizar a URL de redireccionamiento única" debajo de "URL de redireccionamiento", marque la casilla.

3. Seleccione Actualizar conector.

Agregue la "URL de redireccionamiento" como "URI de redireccionamiento"

La "URL de redireccionamiento" generada automáticamente en la sección anterior debe agregarse como "URI de redireccionamiento" al registro de la aplicación.

1. Regrese al registro de la aplicación que creó.

2. En el panel del lado izquierdo, seleccione Descripción general.

3. Seleccione Agregar URI de redireccionamiento.

4. Seleccione + Agregar una plataforma y seleccione Web.

5. Bajo el cuadro de texto Redireccionar URI, pegue la "URL de redireccionamiento" generada automáticamente y copiada de la sección anterior.

6. Seleccione Configurar.

Probar el conector personalizado

1. Abra el menú Prueba.

2. Seleccione Nueva conexión y luego siga las indicaciones para crear una conexión.

3. En Power Apps, seleccione el entorno y, a continuación, seleccione Dataverse>Custom Connectors>CustomAzureDevOps.

4. Seleccione Editar, vaya a la página Prueba y luego busque la operación GetOrganizations.

5. Seleccione Probar operación.

6. Confirme que Response Status se devuelve 200 y que el Response Body es una representación JSON de la organización Azure DevOps.

   

Configurar creadores para usar la aplicación ALM Accelerator

• Configurar permisos de usuario para la cuenta de un creador en Dataverse y Azure DevOps.

• Configure los ajustes del usuario de implementación para configurar la experiencia del usuario de la aplicación y conceder acceso a soluciones y perfiles de implementación.

Más información

• Acelerador de ALM para Power Platform
• Configurar los perfiles de implementación
• Configuración e implementación de datos en canalizaciones
• Configuración e implementación de datos en canalizaciones
• Configurar la sincronización de canalizaciones