Creación de una canalización de CI con Azure Pipelines

La integración continua (CI) es la práctica de combinar con frecuencia los cambios de código en una rama compartida, de modo que cada combinación active automáticamente una compilación y una ejecución de pruebas. El objetivo es detectar pronto los errores de integración, antes de que se acumulen y se conviertan en problemas grandes y difíciles de solucionar. Una buena canalización de CI compila el código, ejecuta pruebas unitarias, mide la cobertura del código, realiza análisis estático y genera un artefacto implementable en unos minutos. Azure Pipelines proporciona el motor de automatización para esta práctica.

Las canalizaciones de CI de Azure Pipelines se definen en un archivo azure-pipelines.yml ubicado en la raíz del repositorio. El archivo YAML especifica los desencadenadores (cuándo se ejecuta), un grupo de agentes (qué tipo de agente se utilizará) y una jerarquía de fases, trabajos y pasos. De forma predeterminada, las fases se ejecutan secuencialmente. Los trabajos de una fase se ejecutan en paralelo de forma predeterminada. Los pasos de un trabajo se ejecutan secuencialmente. Esta estructura proporciona un control detallado sobre el flujo de ejecución de la canalización.

Azure Pipelines admite varios tipos de desencadenadores. Los desencadenadores de rama ejecutan la canalización cuando se inserta código en ramas especificadas. Los desencadenadores de solicitudes de incorporación de cambios (desencadenadores de PR) se ejecutan cuando se abre o actualiza una PR dirigida a ramas de destino; son esenciales para validar el código antes de combinarlo. Los desencadenadores programados se ejecutan a una hora fija (por ejemplo, compilaciones nocturnas). Los desencadenadores de canalización encadenan varias canalizaciones. Especifique trigger: none para deshabilitar las ejecuciones automáticas y permitir únicamente la ejecución manual.

Los pasos de una canalización son scripts (comandos de bash o PowerShell) o tasks (unidades precompiladas y parametrizadas del marketplace de Azure DevOps). Las tareas como NodeTool@0, DotNetCoreCLI@2 y Maven@3 encapsulan operaciones de compilación habituales. Utilice displayName en cada paso para que los registros de la canalización sean fáciles de leer. Cada paso se ejecuta en secuencia y la canalización produce un error si algún paso termina con un código distinto de cero, a menos que establezca continueOnError: true.

Después de ejecutar las pruebas, publique los resultados en Azure DevOps mediante la tarea PublishTestResults. Azure Pipelines analiza archivos de resultados de JUnit, NUnit, XUnit o VSTest y muestra en la interfaz de usuario de la ejecución de la canalización el número de pruebas aprobadas y fallidas, la duración de la ejecución y los detalles de cada prueba. El historial de pruebas se registra a lo largo del tiempo, lo que permite detectar pruebas inestables y regresiones. Esto es esencial para que todo el equipo tenga visibilidad de la calidad del código.

Publique informes de cobertura del código para que Azure Pipelines muestre los porcentajes y las tendencias de cobertura en la interfaz de usuario de la canalización. La tarea PublishCodeCoverageResults acepta informes en formato Cobertura o JaCoCo. Combine esta función con puertas de cobertura de ramas: configure un umbral mínimo de cobertura y haga que la compilación falle si la cobertura cae por debajo de él. Las tendencias de cobertura ayudan a identificar cuándo se agrega código nuevo sin las pruebas correspondientes.

Almacene la configuración de la canalización en variables definidas en el nivel de canalización, fase o trabajo en YAML. Para valores confidenciales (claves de API y contraseñas), utilice variables secretas; establézcalas en la biblioteca de canalizaciones (interfaz de usuario) o en grupos de variables y haga referencia a ellas en YAML. Los grupos de variables son colecciones reutilizables de variables compartidas entre varias canalizaciones. Vincule un grupo de variables a Azure Key Vault para sincronizar automáticamente los secretos de Key Vault con las variables de la canalización.

Después de una compilación correcta, empaquete la salida en un artefacto de canalización para que las fases posteriores, como la implementación, puedan acceder a ella. Utilice PublishPipelineArtifact para cargar archivos del agente de compilación al almacenamiento de artefactos de Azure DevOps. En una fase o un trabajo posterior, utilice DownloadPipelineArtifact para recuperar el artefacto. Esto desacopla el trabajo de compilación de los trabajos de implementación, que pueden ejecutarse en agentes diferentes o en fases distintas.

Ejecute tareas independientes en paralelo definiendo varios trabajos dentro de una fase. Por ejemplo, ejecute simultáneamente las pruebas unitarias y el análisis de seguridad en lugar de hacerlo secuencialmente. Los trabajos en paralelo requieren minutos de compilación independientes, pero pueden reducir considerablemente la duración total de la canalización. Utilice la propiedad dependsOn para hacer que un trabajo espere a que finalicen uno o varios trabajos antes de iniciarse, creando un grafo de dependencias dentro de una fase.

Vincule su canalización de CI a una directiva de rama en Azure Repos para que se ejecute automáticamente como una comprobación de validación de compilación en las solicitudes de incorporación de cambios dirigidas a main. La combinación queda bloqueada hasta que la canalización finaliza correctamente. Combine varias comprobaciones: la canalización de CI debe completarse correctamente, al menos 2 revisores deben aprobarla, todos los comentarios deben estar resueltos y debe existir un elemento de trabajo vinculado. Esto crea una puerta de calidad que impide combinar código defectuoso en la rama principal.

Cuando finalice una ejecución de canalización, revise los resultados en el portal de Azure DevOps. La pestaña Summary muestra el resultado general, correcto o fallido, y la duración. La pestaña Tests enumera todos los resultados de las pruebas y permite filtrarlos por resultado. La pestaña Code Coverage muestra el porcentaje de cobertura y resalta las líneas no cubiertas. Haga clic en cualquier trabajo para ver el resultado del registro paso a paso. Las canalizaciones fallidas muestran el paso que produjo el error resaltado en rojo, junto con el resultado completo del error para facilitar el diagnóstico.

Compruebe su comprensión de los conceptos de Microsoft Azure Fundamentals (AZ-900) tratados en esta lección.

En esta lección ha aprendido que Azure Pipelines YAML define canalizaciones de CI con fases, trabajos y pasos para compilar, probar y crear artefactos; que los desencadenadores de PR y las directivas de rama aplican puertas de calidad que bloquean la combinación de código defectuoso; y que las tareas PublishTestResults y PublishCodeCoverageResults hacen visible la calidad de las pruebas para todo el equipo. A continuación, exploraremos la implementación continua en Azure.