Azure Devops Yaml Pipelines para versión controlada Ci/cd Corrientes de trabajo

Estadios, empleos y pasos

Las etapas representan grandes divisiones en el oleoducto, como Construir, Probar y Despliegar. Pueden ejecutarse secuencial o paralelamente. Dentro de cada etapa, ] trabajo define el entorno de ejecución (conjunto de mando o contenedor) y contiene una secuencia de plantillas

trigger:
 branches:
 include:
 - main
 - releases/*
 paths:
 exclude:
 - docs/*
 - README.md

Templates] son una de las características más poderosas de los oleoductos YAML. Permiten que se integre la lógica común en archivos YAML separados e incluyan en múltiples oleoductos. Hay dos tipos: ] plantillas de trabajo conjunto y plantillas de trabajo conjunto .

Los parámetros de soporte de plantillas, que los hace flexibles. Por ejemplo, puede crear una plantilla de "build-node-app.yml" que toma una versión Node.js como parámetro y ejecuta npm instala, construye y prueba. Cualquier tubería que necesite construir una aplicación Node.js puede simplemente incluir esa plantilla con la versión apropiada. Esto elimina la duplicación y garantiza la consistencia en proyectos.

# templates/build-node-app.yml
parameters:
- name: nodeVersion
 type: string
 default: '18.x'

steps:
- task: NodeTool@0
 inputs:
 versionSpec: ${{ parameters.nodeVersion }}
- script: npm install
 displayName: 'Install dependencies'
- script: npm run build
 displayName: 'Build application'
- script: npm test
 displayName: 'Run tests'

Beneficios clave de la versión controlada CI/CD

Adoptar tuberías YAML trae varias ventajas concretas sobre los oleoductos clásicos basados en UI:

• Control total de versiones:] Cada cambio en el oleoducto se rastrea en el mismo repositorio que el código de aplicación. Puede diff, comentario y revolver cambios de tuberías utilizando flujos de trabajo estándar Git. Esto elimina el misterio "quién cambió el oleoducto" y asegura que la definición de oleoducto siempre está en sincronización con el código que construye.
• Reproducibilidad y auditabilidad: Debido a que el oleoducto se define como código, puede reconstruir cualquier compromiso con exactamente los mismos pasos, variables y dependencias que cuando se construyó por primera vez. Esto es fundamental para depurar los problemas de producción y cumplir los requisitos de cumplimiento.
• Automatización más allá de las construcciones: Los oleoductos YAML soportan lógica condicional, bucles y expresiones complejas usando el lenguaje de expresión de Azure DevOps. Puede implementar flujos de trabajo sofisticados como el despliegue en múltiples regiones en paralelo, realizar pruebas de humo sólo en ramas de liberación o desencadenar tuberías de corriente.
• Portabilidad:] Los oleoductos YAML pueden copiarse entre proyectos, reutilizados en equipos e incluso utilizados para arrancar CI/CD para nuevos depósitos. Las plantillas aumentan aún más esta portabilidad permitiendo a los equipos compartir y mantener la lógica común de oleoducto centralmente.
• Colaboración y revisión de códigos: Los cambios de tubería están sujetos al mismo proceso de revisión de la solicitud de tiradas como código fuente, lo que fomenta las mejores prácticas como la revisión por pares de los cambios de infraestructura, reduce las configuraciones erróneas y fomenta una cultura de colaboración de DevOps.

Creación de una línea de tubería de YAML controlada por la versión

Configurar un oleoducto YAML desde cero es sencillo. A continuación se presentan los pasos recomendados:

1. Decide sobre una estructura de archivos. Usted puede colocar su archivo principal de tubería en la raíz del repositorio (]) o en una carpeta dedicada como . Este último enfoque se escala mejor cuando usted tiene múltiples oleoductos.
2. Escribe la definición de oleoducto. Comience con un archivo YAML mínimo válido que incluye un disparador, una piscina (imagen VM de agente o contenedor), y por lo menos un trabajo. Ejemplo:
3. Detener el archivo en su repositorio. Dedique y empuje al control remoto, asegurándose de que el archivo esté en la rama que se propone utilizar como la rama predeterminada para el oleoducto.
4. ]Crear el oleoducto en Azure DevOps. Navegar a Pipelines > Crear tubería, seleccionar "Azure Repos Git" (o su fuente elegida), elegir el repositorio, y luego seleccionar "Existiendo Azure Pipelines YAML file". Punto a la ruta de archivo que acaba de crear (por ejemplo, [FLT:]
5. Confirme y corra. Haga clic en "Run" para ejecutar el oleoducto por primera vez. Puede monitorear la salida en tiempo real. Posteriormente se compromete a las ramas de activación automáticamente iniciarán nuevas carreras.

Para proyectos existentes que ya tienen un oleoducto clásico, puede migrar a YAML exportando la definición de oleoducto o recreandolo usando el editor de YAML. Microsoft proporciona una guía de migración] para facilitar la transición.

Muestra de tuberías de paseo

Examinemos un oleoducto más realista para una aplicación web Node.js que construye, prueba, publica un artefacto, y se implementa en un entorno de estadificación. Este ejemplo demuestra una implementación multietapa, variables y condicional.

trigger:
 branches:
 include:
 - main
 - develop
 paths:
 exclude:
 - 'README.md'

variables:
 nodeVersion: '18.x'
 artifactName: 'webapp'

stages:
- stage: Build
 displayName: 'Build and Test'
 jobs:
 - job: BuildJob
 pool:
 vmImage: 'ubuntu-latest'
 steps:
 - task: NodeTool@0
 inputs:
 versionSpec: $(nodeVersion)
 - script: npm install
 displayName: 'Install dependencies'
 - script: npm run lint
 displayName: 'Lint code'
 - script: npm run build
 displayName: 'Build application'
 - script: npm test
 displayName: 'Run unit tests'
 - task: PublishBuildArtifacts@1
 inputs:
 PathtoPublish: 'dist'
 ArtifactName: $(artifactName)

- stage: DeployStaging
 displayName: 'Deploy to Staging'
 dependsOn: Build
 condition: and(succeeded(), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
 jobs:
 - deployment: DeployJob
 pool:
 vmImage: 'ubuntu-latest'
 environment: staging
 strategy:
 runOnce:
 deploy:
 steps:
 - download: current
 artifact: $(artifactName)
 - script: echo "Deploying artifact to staging server..."
 displayName: 'Deploy step'
 - script: echo "Running smoke tests..."
 displayName: 'Smoke test'

Este gasoducto muestra:

• Trigger con exclusión de ruta – los cambios de documentación no desencadenarán una construcción completa.
• Variables definidos en la parte superior para la reutilizabilidad.
• Dos etapas] – Construir (no Despliegue) y DeployStaging (trabajo de despliegue). La etapa de despliegue sólo funciona si la rama de origen es y la construcción tuvo éxito.
• Trabajo de despliegue utilizando la palabra clave , que permite trazabilidad, aprobaciones y puertas.
• Publicación y descarga de artefactos – la producción de construcción se guarda y recupera más adelante por la etapa de despliegue.

Patrones avanzados

Multi-Stage con las aprobaciones manuales

Los conductos Azure DevOps YAML soportan entornos con cheques de aprobación manual. Puede requerir usuarios o grupos específicos para aprobar un despliegue antes de que proceda. Esto se define en el YAML por referencia a un entorno que tiene aprobaciones configuradas.

- stage: DeployProduction
 dependsOn: DeployStaging
 condition: succeeded()
 jobs:
 - deployment: ProdDeployment
 pool:
 vmImage: 'ubuntu-latest'
 environment: production
 strategy:
 runOnce:
 deploy:
 steps:
 - script: echo "Deploying to production..."

Ejecución condicional

Usa expresiones como para controlar qué etapas, empleos o pasos se ejecutan. Azure DevOps admite un rico lenguaje de expresión con funciones para la manipulación de cadenas, operadores lógicos y cheques de colección.

Utilizando Containers

En lugar de utilizar una imagen VM, puede ejecutar trabajos completos dentro de un contenedor. Esto es ideal para garantizar entornos consistentes a través del desarrollo y CI/CD. Simplemente especificar un elemento bajo el trabajo o la piscina.

pool:
 vmImage: 'ubuntu-latest'
container: node:18-alpine

Las mejores prácticas para las tuberías YAML

A partir de las implementaciones de producción, aquí están las prácticas clave para mantener sus oleoductos robustos y sostenibles:

• Use plantillas de manera liberal. Extraiga pasos comunes en plantillas parametizadas. Esto reduce la duplicación y hace que sea fácil aplicar estándares (por ejemplo, una plantilla de exploración de seguridad que todos los proyectos deben ejecutar).
• Keep YAML archivos pequeños y enfocados. Un único archivo monolítico se hace difícil de leer y depurar. Dividir en múltiples archivos organizados por escenario o función (por ejemplo, ], ]] ]].
• Secretos seguros con Azure Key Vault. Evite contraseñas de codificación dura, claves de API o certificados. Use grupos variables vinculados a Key Vault, y avíselos en su tubería. Azure DevOps buscará automáticamente los últimos valores en el tiempo de ejecución.
• Validar la sintaxis YAML antes de cometer. Utilizar un plugin de IDE o de Iinter para capturar errores de indentación y claves perdidas. Azure DevOps también proporciona un botón "Validar" en el editor de tuberías.
• Recursos de la fama claramente. Dar etapas, empleos y pasos significativos ] valores. Esto mejora enormemente la legibilidad en los registros y visualizaciones.
• Usar caché de oleoductos] para acelerar las edificaciones. Las dependencias de caché como o NuGet paquetes para evitar la recarga de los paquetes en cada carrera. Azure DevOps proporciona una tarea para este propósito.
• Implement early failure. Fail the pipeline as quickly as possible. Ejecute los controles de forro y sintaxis antes de costosos pruebas de integración. Utilice la opción en tareas de script para capturar advertencias convertidas en errores.
• Documentar su oleoducto. Incluir comentarios en el archivo YAML explicando opciones no obvias, especialmente cuando se utiliza expresiones o lógica condicional. Considerar el mantenimiento de un README junto con los archivos de oleoductos.

Integrando con Otras Herramientas

Los oleoductos Azure DevOps YAML se integran de forma nativa con numerosos servicios.

• SonarQube] para la inspección continua de calidad de código – añadir una tarea SonarQubePrepare antes de construir y una tarea SonarQubeAnalyze después.
• Docker] para la construcción de contenedores – utilice la tarea Docker@2 para construir e impulsar imágenes al Registro de Contenedores Azure o al Centro Docker.
• GitHub – Los oleoductos YAML pueden configurarse para trabajar con los repositorios GitHub, no sólo Azure Repos. Simplemente seleccione GitHub como su fuente durante la creación de oleoductos.
• ServiceNow] para la gestión del cambio: la extensión ServiceNow Change Management permite que los oleoductos creen y actualicen solicitudes de cambio durante las implementaciones.

Para una lista completa de tareas disponibles, consulte la documentación Azure Pipelines Tasks.

Pitfalls comunes y cómo evitarlos

Incluso equipos experimentados se enfrentan a problemas con tuberías YAML. A continuación se presentan errores frecuentes y sus soluciones:

• Sintaxis inválida de YAML] – espacios de seguimiento, indentación inconsistente (YAML no permite pestañas).Utilice una herramienta de validación en su editor o parser de YAML de Azure DevOps.
• ]Escopia variable unclear – variables definidas en las variables de paso/marco superior a menos que utilice la sintaxis macro adecuadamente. Use para las expresiones de plantilla y para la evaluación de tiempo de ejecución.
• Los desencadenantes microconfigurados – olvidando establecer los resultados de un disparador en el oleoducto solo funcionan con los disparadores manuales o programados. Verificar la sección de desencadenantes cubre sus ramas y caminos previstos.
• Ignorar la capacidad de la piscina de agente] – usar una piscina de agente privado sin asegurar suficientes agentes puede causar retrasos o fallos. Considerar el uso de agentes anfitriones de Microsoft para una mayor elasticidad.
• No hay cambios en el oleoducto – siempre se realiza una prueba de forma continua en una rama antes de fusionarse a la red principal. Incluso cambios menores en las plantillas pueden romper decenas de oleoductos en silencio.

Conclusión

Los oleoductos Azure DevOps YAML representan un enfoque maduro y código-primer a CI/CD que escala desde pequeños proyectos hasta la ingeniería de lanzamiento a nivel empresarial. Al colocar definiciones de oleoductos bajo control de versiones, los equipos obtienen transparencia, reproducibilidad y un puente sin fisuras entre desarrollo y operaciones. La sintaxis YAML es lo suficientemente expresiva como para modelar flujos de trabajo complejos, pero lo suficientemente estructurados para mantenerse legibles y mantenerlosivos.

Adoptar tuberías controladas por versiones no es sólo sobre automatización – se trata de tratar el proceso de entrega con el mismo rigor que el código de aplicación. Para los equipos que buscan aumentar la frecuencia de implementación, reducir errores manuales, y mejorar la colaboración, los oleoductos Azure DevOps YAML son una base probada. Comience por definir un simple oleoducto para su proyecto, luego añada gradualmente etapas, plantillas e integraciones a medida que su madurez.