Configurar las canalizaciones de ALM Accelerator
Las canalizaciones son los motores del Acelerador ALM. Automatizan el proceso de ALM para Power Platform. Se compilan con Azure Pipelines, un servicio de Azure DevOps, y se almacenan en un proyecto Azure DevOps.
Se utilizan cuatro canalizaciones principales para automatizar el proceso de ALM:
- Import
- Export
- Delete
- Compilar/Implementar
Las canalizaciones están diseñadas para usarse con la aplicación de lienzo ALM Accelerator. No necesitas usar la aplicación, pero te la recomendamos. La aplicación proporciona una interfaz simple para invocar las canalizaciones y una forma de configurarlas sin tener que comprender los parámetros subyacentes.
Escenarios comunes de canalización de ALM Accelerator
Las canalizaciones y la aplicación de ALM Accelerator tienen configuraciones predeterminadas que le permiten empezar rápidamente a usar ALM para Power Platform. Las canalizaciones pueden cubrir muchos escenarios de ALM diferentes para cumplir con los requisitos de su organización. Las siguientes secciones describen algunos escenarios comunes y de cómo se pueden cubrir a través de la configuración de las canalizaciones, los perfiles de implementación y los pasos de la aplicación ALM Accelerator o, directamente, a través de la canalización.
Instalar las canalizaciones en un proyecto y el código fuente en otro proyecto
En la aplicación ALM Accelerator y en los perfiles de implementación, puede especificar un proyecto de canalización y un proyecto de origen. Una opción en el asistente de configuración le permite especificar un proyecto de canalización y un repositorio separados. Estas opciones son útiles si desea segmentar el almacenamiento de soluciones según los usuarios, la estructura corporativa u otros factores. En la mayoría de los casos, los archivos YAML de canalización se almacenan en el proyecto de canalización y las canalizaciones de exportación, importación y eliminación se crean en el proyecto en el que la solución está controlada por fuente.
Ejecute las canalizaciones sin ALM Accelerator
La aplicación de lienzo del ALM Accelerator proporciona una sencilla capa de botones para ejecutar las canalizaciones. Sin embargo, no necesita la aplicación para ejecutarlos. Si desea utilizar las canalizaciones independientemente de la aplicación, ejecútelas directamente desde la línea de comandos. También puede crear su propia aplicación. Use un conector personalizado para la API de Azure DevOps, incluida en la solución ALM Accelerator, para invocar las canalizaciones usando Power Automate u otras tecnologías de Power Platform.
En cualquier caso, si desea usar canalizaciones de forma independiente, la clave es comprender los parámetros que se pasan a ellas.
Parámetros de canalización
Parámetros para import-unmanaged-to-dev-environment: Utilice la canalización de solución de importación para importar una solución no administrada desde el control de origen a un entorno de desarrollo ambiente.
En la siguiente tabla se describen los parámetros de la canalización de importación.
| Parámetro | Ejemplo | Descripción |
|---|---|---|
| Project | Mi proyecto de Azure DevOps | El nombre del proyecto para importar la solución en |
| Repo | Mi reposigtorio de Azure DevOps | El nombre del repo del que importar la solución |
| SolutionName | MySolutionName | Nombre de la solución a importar |
| me@example.com | La dirección de correo electrónico del usuario que importa la solución | |
| UserName | Apellido, Nombre | Nombre de usuario del usuario que importa la solución |
| Sucursal | main | La rama para compilar la solución y desde la que se importa |
| ServiceConnectionName | MyServiceConnection | Nombre de la conexión de servicio para usar para la importación |
| ServiceConnectionUrl | example.crm.dynamics.com | La URL del entorno del creador para la importación |
| EnvironmentName | MyDevEnvironment | Se usa para encontrar la configuración de implementación en la canalización de implementación; devuelve un nombre de carpeta en el directorio de configuración en el origen de la solución |
Parámetros para delete-unmanaged-solution-and-components: Utilice el proceso de eliminación de soluciones para eliminar una solución no administrada y todos sus componentes de un desarrollo ambiente.
En la siguiente tabla se describen los parámetros de la canalización de eliminación.
| Parámetro | Ejemplo | Descripción |
|---|---|---|
| SolutionName | MySolutionName | Nombre de la solución que se va a eliminar |
| ServiceConnectionName | MyServiceConnection | Nombre de la conexión de servicio para usar para la solución que se va a eliminar |
| ServiceConnectionUrl | example.crm.dynamics.com | La URL del entorno del creador empleada para eliminar la solución |
Parámetros para export-solution-to-git: Utilice la canalización de exportación de solución para exportar la solución a un repositorio Git.
En la siguiente tabla se describen los parámetros de la canalización de exportación.
| Parámetro | Ejemplo | Descripción |
|---|---|---|
| Project | Mi proyecto de Azure DevOps | El nombre del proyecto al que se exportará el código fuente de la solución |
| Repo | Mi reposigtorio de Azure DevOps | El nombre del repo al que se exportará el código fuente de la solución |
| SolutionName | MySolutionName | Nombre de la solución a exportar |
| me@example.com | La dirección de correo electrónico del usuario que exporta la solución | |
| UserName | Apellido, Nombre | Nombre de usuario del usuario que exporta la solución |
| CommitMessage | Corrección del error #1234 | Una descripción de los cambios a almacenar en la confirmación en el repositorio |
| Sucursal | main | La rama de origen desde la que se va a crear una rama o la rama existente que se debe confirmar |
| BranchToCreate | característica-1234 | El nombre único de una rama de nueva creación en función del parámetro Branch, si es necesario |
| ServiceConnectionName | MyServiceConnection | Nombre de la conexión de servicio para usar para la exportación de la solución |
| ServiceConnectionUrl | example.crm.dynamics.com | La URL del entorno de creador donde reside la solución no administrada que se va a exportar |
| Datos | [JSON de configuración de implementación] | Una cadena JSON que contiene la configuración de implementación que se usará para exportar y configurar canalizaciones de implementación |
| PortalSiteName | MyPortalSite | El nombre del sitio web de Power Pages asociado con la solución que se va a exportar |
Personalice el control de versiones de las soluciones al usar las canalizaciones de ALM Accelerator para exportarlas o implementarlas
De forma predeterminada, las soluciones exportadas e implementadas se versionan con el nombre especificado en el archivo YAML de canalización de implementación. Sin embargo, las canalizaciones de ALM Accelerator le permiten personalizar el control de versiones de una solución al exportarla o implementarla. En las siguientes secciones se describen los métodos que puede usar.
Control de versiones exportadas
Utilice el número de versión exportado por las canalizaciones como el número de versión en todos los entornos implementados. Crea una variable llamada UseSolutionVersionFromDataverse en su canalización de exportación o una variable global en la biblioteca de variables para ALM Accelerator. Dele un valor de Verdadero. La variable garantiza que el número de versión exportado en su solución se conserve en entornos posteriores, y también se refleja en su control de código fuente cuando se confirme el origen de la solución.
Lógica de control de versiones personalizada
Utilice enlaces de ALM Accelerator para configurar la versión de la solución. Agregue su lógica personalizada a la plantilla build-solution-pack-pre-hook.yml para manipular Solution.xml directamente o usando otras herramientas como la versión de la solución pac.
Versiones personalizadas de traer sus propias plantillas
La posibilidad de usar sus propias plantillas para generar canalizaciones de implementación aporta flexibilidad para el control de versiones durante la exportación inicial de una solución. Como ejemplo, cree una copia de build-deploy-validation/test/prod-SampleSolution.yml y cambie el nombre de compilación del valor predeterminado a una estrategia de control de versiones basada en la configuración de números de ejecución o compilación:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Después de tener las plantillas en su lugar, actualice los pasos de implementación en su perfil de implementación para señalarlos.
Personalice la cantidad de pasos de implementación en sus canalizaciones y los nombres de los entornos de destino
Como ocurre con el control de versiones personalizado con plantillas, la posibilidad de usar sus propias plantillas para generar canalizaciones de implementación aporta más flexibilidad durante la exportación inicial de una solución. Especifique el proyecto en el que estas se encuentran, así como la ruta hacia ellas, que se usará para generar las canalizaciones de implementación. La configuración del proyecto y la ruta se encuentran en la tabla perfil de implementación y la tabla Pasos de implementación en la aplicación de administración del ALM Accelerator.
La ruta a la plantilla es relativa a la raíz de la ubicación de la canalización de exportación. Por ejemplo, la ruta a las plantillas de canalización de implementación en el entorno de validación predeterminado es /Pipelines/build-deploy-validation-SampleSolution.yml. Para usar una plantilla en el mismo proyecto que la canalización de exportación, especifique la ruta como /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
La tabla siguiente describe los marcadores de posición en las plantillas para los valores específicos de la solución que se reemplazan cuando se genera la canalización de implementación.
| Marcador de posición | Descripción |
|---|---|
| SampleSolutionName | Nombre de la solución a implementar |
| RepositoryContainingTheBuildTemplates | El repositorio que contiene las plantillas de compilación que se usarán para la canalización de implementación |
| BranchContainingTheBuildTemplates | La rama que contiene las plantillas de compilación que se usarán para la canalización de implementación |
| alm-accelerator-variable-group | El grupo de variables globales que usan las plantillas de compilación para la canalización de implementación |
Le recomendamos que copie una plantilla de canalización build-deploy-validation/test/prod-SampleSolution.yml para comenzar con su propia plantilla personalizada.
Ejecute pasos personalizados en sus canalizaciones sin modificar las plantillas predeterminadas
Las plantillas de canalización de ALM Accelerator tienen varios puntos de extensión, o ganchos, que puede usar para personalizar las canalizaciones mientras minimiza el ruido de los conflictos de combinación en los escenarios de actualización. Obtenga más información sobre los ganchos del acelerador ALM.
Activar o desactivar acciones específicas en las canalizaciones
Las canalizaciones usan variables para determinar si una tarea debe ejecutarse o no o qué tarea de varias posibilidades debe ejecutarse. La siguiente tabla describe las variables que puede establecer para una canalización individual o, a través del grupo de variables del acelerador alm, para todas las canalizaciones.
Nota
Para configurar estas variables para soluciones específicas en la exportación, cree una canalización de exportación específica basada en la plantilla de canalización de exportación. Llámela export-solution-to-git-{SolutionName}. La aplicación ALM Accelerator utiliza esta canalización de exportación para la solución específica, en lugar de la canalización genérica export-solution-to-git.
| Variables | Default | Canalizaciones | Descripción |
|---|---|---|---|
| GenerateDeploymentSettings | VERDADERO | Export | Si es falso, la configuración de implementación no se genera ni almacenará en el control de código fuente. |
| UseDeploymentSettingsPlaceholders | VERDADERO | Export | Si es falso, la configuración de implementación no usa marcadores de posición y todos los valores de la configuración de implementación se guardan en los archivos deploymentSettings.json y customDeploymentSettings.json.IMPORTANTE: Es posible que se guarde información confidencial en texto sin formato en la configuración de implementación. Cualquier usuario con acceso al control de código fuente puede leer estos valores. Tenga cuidado si establece un valor para esta variable. |
| DisableFlows | False | Export | Si es verdadero, todos los flujos se desactivan en el código fuente desempaquetado antes de confirmar. |
| UseSolutionVersionFromDataverse | False | Export | Si es verdadero, el número de versión exportado en su solución se conserva en entornos posteriores. El número de versión se refleja en su control de fuente cuando se confirma la fuente de la solución. |
| DoNotExportCurrentEnvironmentVariableValues | False | Export | Si es verdadero, los valores de las variables del entorno actual se eliminan del código fuente de la solución desempaquetada. |
| PublishCustomizationsBeforeExport | VERDADERO | Export | Si es falso, las personalizaciones no se publican antes de que se exporte la solución. Esta opción es útil si está trabajando en un entorno compartido y solo desea exportar las últimas personalizaciones publicadas. |
| CacheEnabled | VERDADERO | Exportar/Implementar | Si es falso, el almacenamiento en caché de los módulos de PowerShell está deshabilitado. Esta opción es útil si sus canalizaciones ejecutan la limpieza del directorio de caché después de que se ejecutan las canalizaciones. |
| ProcessCanvasApps | VERDADERO | Exportar/Implementar | Si es falso, las aplicaciones de lienzo no se desempaquetan durante la exportación o se empaquetan durante las compilaciones. NOTA: La funcionalidad de descomprimir y empaquetar el lienzo se encuentra actualmente en versión preliminar . En este momento no se recomienda usar en entornos de producción. 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. |
| DisableSolutionChecker | False | Implementar | Si es verdadero, el verificador de soluciones no se ejecuta en cada compilación que se inicia a través de una solicitud de extracción. |
| SkipSolutionImport | False | Implementar | Si es verdadero, el paso de importación de la solución se omite durante la implementación. Sin embargo, aún se deben realizar otras actividades, como la activación de flujo y el intercambio. |