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.

ArquitecturaCorrespondencia conceptual — elementos de Azure DevOps a GitHub Actions
Correspondencia conceptual — elementos de Azure DevOps a GitHub ActionsLas 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.Azure DevOpsGitHub ActionsPipeline templatesStages · jobs · stepsVariables · variable groupsEnvironments · approvalsReusable workflowsJobs · stepsInputs · variables · secretsEnvironments · protection rulesMisma lógica de Terraforminit · validate · plan · apply
  • 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

  1. 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.

  2. 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.