Lección 14 de 20 · Lectura y práctica
Ejercicio Práctico: Configurar un Pipeline CI/CD para Terraform
Concepto claveUn pipeline CI/CD para Terraform es un sistema automatizado que gestiona el ciclo de vida de tu infraestructura como código. Imagina que eres un arquitecto que diseña un edificio: en lugar de construir manualmente.
Del concepto a la práctica
Taller de esta lección
El ejercicio consiste en diseñar un pipeline auditable para una modificación pequeña: añadir una etiqueta al bucket. El pipeline debe producir evidencia en cada etapa y no aplicar automáticamente cambios que aún no tengan revisión. Define entradas, artefactos y condición de salida antes de escribir sintaxis específica de una plataforma.
Ejemplo resuelto
La secuencia es checkout, formato, validación, plan y aprobación. El artefacto contiene el plan para el commit C1. Si el plan solo añade la etiqueta CostCenter, la aprobación puede continuar; si elimina el bucket, debe detenerse.
Pruébalo
Especifica la condición de éxito de cada etapa.
Ejecuta el flujo con un cambio de etiqueta y conserva su plan.
Introduce después una eliminación controlada y observa la regla de bloqueo.
Documenta quién aprueba y qué estado remoto se utiliza.
Error frecuente: comprobar solo que el comando terminó con código cero. Corrección: revisar también el contenido del plan y la identidad del entorno.
Ejercicio: crea una matriz etapa, entrada, salida y decisión.
Comprueba tu resultado
formato produce código normalizado; validación produce diagnóstico; plan produce diferencias; aprobación decide apply.
Pipeline evaluado con fixtures
Usa tres planes simulados declarados: C1={create:0,update:1,delete:0,entorno:'dev',aprobado:true}; C2={create:0,update:0,delete:1,entorno:'dev',aprobado:false}; C3={create:0,update:1,delete:0,entorno:'prod',aprobado:true}. La política de este laboratorio acepta solo dev, sin bajas y con aprobación del commit exacto. C1habilita siguiente etapa, C2bloquea baja y C3rechaza entorno. Son contadores de prueba, no archivos de plan Terraform reales.
Un pipeline de plataforma agrega permisos mínimos, autenticación temporal, concurrencia por estado/entorno y protección de la etapa aplicadora. No expongas credenciales a código de un pull request no confiable; sintaxis válida en CI sin credenciales puede ser una etapa separada del plan autorizado. Revisa las versiones/SHAs de acciones elegidas, en vez de reutilizar checkout@v2/setup@v1/Terraform1.0 del histórico.
plan -detailed-exitcode devuelve0sin diferencia,1error y2con diferencias. El2no es fallo técnico, pero tampoco aprueba el contenido del plan. Captura y clasifica ese resultado correctamente. Aplicar un plan guardado solicita sus acciones sin una segunda interacción de aprobación CLI; la aprobación del flujo debe ocurrir antes. No añadas auto-approve como reparación universal ni reemplaces el plan revisado por uno nuevo silenciosamente. La matriz registra artefacto, commit, entorno y decisión.

Mapa de prácticaUna condición decide qué camino ejecuta el programa. Un bucle repite una operación mientras queden elementos, y termina cuando la lista se agota. Separar ambas ideas ayuda a seguir el flujo y comprobar casos límite.
Ver la infografía en tamaño completo ↗Concepto clave
Un pipeline CI/CD para Terraform es un sistema automatizado que gestiona el ciclo de vida de tu infraestructura como código. Imagina que eres un arquitecto que diseña un edificio: en lugar de construir manualmente cada vez, creas planos detallados (tu código Terraform) y luego usas una cadena de montaje automatizada (el pipeline) que revisa, prueba y construye según esos planos de forma consistente.
Este pipeline asegura que cada cambio en tu infraestructura pase por las mismas etapas de validación, similar a como en una fábrica automotriz cada vehículo pasa por controles de calidad estandarizados. Para un DevOps Engineer, esto elimina la variabilidad humana, reduce errores y permite desplegar infraestructura de manera repeatable y confiable en AWS.
Cómo funciona en la práctica
Vamos a configurar un pipeline básico usando GitHub Actions, un servicio popular de CI/CD. El flujo tendrá estas etapas:
- Plan: Cuando haces un pull request, Terraform genera un plan de ejecución para mostrar qué cambiará.
- Apply: Al fusionar a la rama principal, Terraform aplica los cambios automáticamente.
- Estado: Se usa un backend remoto (como S3) para almacenar el estado de Terraform, asegurando que el pipeline siempre trabaje con la versión más reciente.
Paso a paso: primero, preparas tu repositorio con archivos Terraform. Luego, creas un archivo de configuración para GitHub Actions que define los jobs. Finalmente, pruebas el pipeline haciendo un cambio y viendo cómo se ejecuta automáticamente.
Codigo en accion
Aquí tienes un ejemplo funcional de un archivo Terraform para crear un bucket S3 en AWS, que será parte de tu pipeline:
# main.tf - Configuración básica de un bucket S3
provider "aws" {
region = "us-east-1"
}
resource "aws_s3_bucket" "mi_bucket" {
bucket = "mi-bucket-terraform-pipeline-${random_id.suffix.hex}"
acl = "private"
tags = {
Name = "Bucket para pipeline"
Environment = "Dev"
}
}
resource "random_id" "suffix" {
byte_length = 4
}Ahora, el archivo de configuración para GitHub Actions que define el pipeline:
# .github/workflows/terraform.yml
name: 'Terraform CI/CD Pipeline'
on:
pull_request:
branches: [ main ]
push:
branches: [ main ]
jobs:
terraform:
name: 'Terraform Plan and Apply'
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Setup Terraform
uses: hashicorp/setup-terraform@v1
with:
terraform_version: '1.0.0'
- name: Terraform Init
run: terraform init
env:
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
- name: Terraform Plan
if: github.event_name == 'pull_request'
run: terraform plan
- name: Terraform Apply
if: github.event_name == 'push'
run: terraform apply -auto-approveErrores comunes
- No usar un backend remoto para el estado: Si el estado se almacena localmente, el pipeline puede perder la pista de los recursos. Solución: Configura un backend como S3 con bloqueo DynamoDB desde el inicio.
- Exponer credenciales en el código Incluir AWS keys directamente en los archivos es un riesgo de seguridad. Solución: Usa secrets en GitHub Actions o AWS IAM roles.
- Olvidar el -auto-approve en Apply Sin esto, el pipeline se detendrá esperando confirmación manual. Solución: Asegúrate de incluir el flag en el comando apply para entornos automatizados.
- No manejar dependencias entre recursos Si un recurso depende de otro y falla, puede romper el pipeline. Solución: Usa depends_on en Terraform y prueba en un entorno de staging primero.
Checklist de dominio
- Configurar un backend remoto de Terraform en S3 para gestionar el estado.
- Crear un archivo de workflow de GitHub Actions que ejecute terraform init, plan y apply.
- Usar secrets para almacenar credenciales de AWS de forma segura.
- Probar el pipeline con un cambio simple, como modificar un tag en un recurso.
- Verificar que el plan se ejecute en pull requests y el apply en pushes a main.
- Manejar errores comunes como timeouts o permisos insuficientes.
- Documentar el proceso para que otros miembros del equipo puedan replicarlo.
Configurar un Pipeline CI/CD para Terraform con GitHub Actions
Sigue estos pasos para crear un pipeline funcional que automatice el despliegue de infraestructura en AWS:
- Prepara tu entorno: Crea un repositorio en GitHub y clónalo localmente. Asegúrate de tener una cuenta de AWS con credenciales configuradas.
- Configura Terraform: En tu repositorio, crea un archivo main.tf con el código del bucket S3 proporcionado en la lección. Luego, inicializa Terraform localmente con
terraform initpara verificar que funcione. - Configura el backend remoto: Modifica main.tf para usar un backend S3. Agrega este bloque al inicio:
Crea el bucket S3 manualmente en AWS primero.terraform { backend "s3" { bucket = "nombre-de-tu-bucket" key = "terraform.tfstate" region = "us-east-1" } } - Crea el workflow de GitHub Actions: En tu repositorio, crea la carpeta
.github/workflowsy dentro, un archivo terraform.yml con el código YAML de la lección. Ajusta la región si es necesario. - Configura secrets en GitHub: En la configuración de tu repositorio en GitHub, ve a Secrets y agrega
AWS_ACCESS_KEY_IDyAWS_SECRET_ACCESS_KEYcon tus credenciales de AWS. - Prueba el pipeline: Haz un commit y push de tus cambios. Luego, crea un pull request para ver el plan en acción, y fusiónalo para trigger el apply automático.
Pistas
- Si el pipeline falla en terraform init, verifica que las credenciales en secrets estén correctamente configuradas y que el backend S3 exista.
- Para evitar costos inesperados, usa el comando terraform plan antes de cada apply y revisa los cambios propuestos.
- Si el apply no se ejecuta tras fusionar, asegúrate de que el evento push en el workflow esté configurado para la rama main.
Evalua tu comprension
Completa el quiz interactivo de arriba para ganar XP.
Sigue con Terraform en AWS: Infraestructura como Código para DevOps
Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.
Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.