ProfesionalModernización CI/CD
Migración de plantillas de pipelines Terraform de Azure DevOps a GitHub Actions
Traslado de plantillas de pipelines de Azure DevOps para Infrastructure as Code con Terraform a workflows de GitHub Actions, preservando una lógica de build y despliegue equivalente.
- Rol
- Cloud DevSecOps Engineer — migración de pipelines
- Contexto
- ALIANDO · Área Cloud Platform
- Periodo
- 2026
01Resumen
Las plantillas de pipelines codifican los estándares de entrega de un equipo. Llevarlas de Azure DevOps a GitHub Actions supone reexpresar esos estándares en otro modelo de ejecución sin cambiar qué se construye o se despliega. Realicé esa traducción para los workflows de IaC con Terraform.
02Contexto
En el área Cloud Platform la infraestructura se entrega con Terraform ejecutado desde pipelines CI/CD. Las plantillas ya existían en Azure DevOps; el requisito era ofrecer la misma capacidad en GitHub Actions.
03Problema
Azure DevOps y GitHub Actions comparten conceptos pero no semántica — plantillas, stages, ámbito de variables y aprobaciones se modelan de forma distinta. Un port literal arriesga cambios sutiles de comportamiento en despliegues de infraestructura, donde un valor de variable distinto o un paso omitido puede cambiar recursos reales.
04Mis responsabilidades
- Analicé las plantillas de pipelines de Azure DevOps existentes para IaC con Terraform.
- Las traduje a workflows de GitHub Actions.
- Preservé una lógica de build y despliegue equivalente durante la migración.
05Arquitectura
La migración asigna cada elemento de Azure DevOps a su equivalente en GitHub Actions. El diagrama muestra esa correspondencia conceptual entre los bloques de ambas plataformas; la lógica de Terraform que se ejecuta dentro de los pipelines no cambia.
- Entrega y automatización
- Código y configuración
Vista conceptual de los elementos de plataforma implicados; no reproduce los pipelines del cliente.
Descripción textual del diagrama
Las plantillas de pipelines de Azure DevOps se corresponden con reusable workflows de GitHub Actions; stages, jobs y steps con jobs y steps; las variables del pipeline con inputs, variables y secrets del workflow; environments y aprobaciones con environments de GitHub. Ambos ejecutan la misma lógica de Terraform.
Flujos
- Pipeline templates → Reusable workflows
- Stages · jobs · steps → Jobs · steps
- Variables · variable groups → Inputs · variables · secrets
- Environments · approvals → Environments · protection rules
Componentes
Pipeline templates · Stages · jobs · steps · Variables · variable groups · Environments · approvals · Reusable workflows · Jobs · steps · Inputs · variables · secrets · Environments · protection rules · Misma lógica de Terraform
06Stack tecnológico
- Plataforma origen
- Azure DevOps Pipelines
- YAML templates
- Plataforma destino
- GitHub Actions
- Reusable workflows
- Carga
- Terraform
- Infrastructure as Code
07Enfoque de implementación
- Inventariar las plantillas existentes y el comportamiento que garantiza cada una — inputs, orden, condiciones y destinos de despliegue.
- Reexpresar cada plantilla en términos de GitHub Actions, manteniendo sin cambios los comandos de Terraform y su orden.
- Tratar la equivalencia como criterio de aceptación — los workflows migrados deben construir y desplegar igual que los originales.
08Retos y decisiones de ingeniería
Reto
Modelos de ejecución distintos — los stages y plantillas de Azure DevOps no se corresponden uno a uno con workflows y jobs de GitHub Actions.
Decisión
Traducir por intención y no por sintaxis — identificar qué garantiza cada plantilla y reproducir esa garantía con el elemento de GitHub Actions más cercano.
Reto
En pipelines de infraestructura, una diferencia de comportamiento es un cambio en recursos reales.
Decisión
Mantener intacto el flujo de Terraform y limitar la migración a la capa de orquestación que lo rodea.
09Consideraciones de seguridad
- Secretos y variables deben mantener su ámbito al moverse entre plataformas — una variable con ámbito de entorno no debe pasar a ser legible globalmente.
- Los controles de despliegue en entornos sensibles necesitan un equivalente explícito en la plataforma destino.
10Consideraciones operativas
- Una lógica equivalente permite a los operadores mantener el mismo modelo mental de cómo se entrega la infraestructura.
- Los reusable workflows mantienen centralizados los estándares de entrega en lugar de copiarlos en cada repositorio.
11Resultados e impacto
- Plantillas de pipelines de Azure DevOps para IaC con Terraform trasladadas a GitHub Actions.
- Lógica de build y despliegue equivalente preservada.
12Lecciones aprendidas
- Una migración de pipelines es un ejercicio de preservación de comportamiento; la sintaxis es la parte fácil.
- Separar la orquestación de la lógica de infraestructura que ejecuta hace intercambiables las plataformas CI/CD.