La Infraestructura como Código (IaC) ha revolucionado la forma en que diseñamos, desplegamos y administramos la infraestructura en la nube. Entre las herramientas del ecosistema DevOps, Terraform de HashiCorp se mantiene como uno de los estándares de la industria gracias a su declaración agnóstica y su robusto ecosistema de proveedores.
Esta guía recopila los comandos más utilizados y las configuraciones más comunes estructuradas bajo las mejores prácticas de ingeniería de software.
1. El Ciclo de Vida: Comandos Esenciales de Terraform
Para dominar Terraform, es fundamental comprender el flujo operativo diario. Aquí tienes los comandos que usarás en el 90% de tus despliegues:
terraform init
Es el punto de partida absoluto. Este comando inicializa un directorio de trabajo que contiene archivos de configuración de Terraform.
terraform init
# Útil si necesitas forzar la actualización de plugins:
terraform init -upgrade
terraform fmt y terraform validate
La salud de tu código depende de su legibilidad y sintaxis:
terraform fmt:
Formatea automáticamente todos los archivos .tfen el directorio actual según el estándar oficial de HashiCorp.terraform validate: Analiza sintácticamente el código sin realizar llamadas a la API del proveedor, asegurando que no existan errores de estructura.
terraform plan
El comando de previsualización por excelencia. Compara el estado actual de tu infraestructura (según el archivo de estado) con los archivos de configuración declarados, generando un plan detallado de lo que se creará (+), modificará (~) o destruirá (-).
terraform plan -out=tfplan.binary
terraform apply
Ejecuta las acciones propuestas por el comando plan para alcanzar el estado deseado en la infraestructura.
# Si guardaste el plan previamente (recomendado para entornos de producción/CI-CD):
terraform apply tfplan.binary
terraform destroy
Elimina toda la infraestructura gestionada por ese directorio de configuración de Terraform.
terraform destroy
2. Estructura y Configuraciones Más Comunes
Una configuración limpia y modular facilita el mantenimiento a largo plazo. A continuación, te mostramos cómo estructurar un proyecto base profesional utilizando bloques estándar de HashiCorp Configuration Language (HCL).
A. Configuración del Proveedor y Bloque terraform (versions.tf)
Define las versiones mínimas requeridas tanto para Terraform como para los proveedores que utilizarás.
terraform {
required_version = ">= 1.5.0"
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 5.0"
}
}
# Configuración recomendada de backend remoto para producción
backend "s3" {
bucket ="mi-empresa-terraform-state"
key ="proyectos/app-prod/terraform.tfstate"
region ="us-east-1"
dynamodb_table ="terraform-lock-table"
encrypt = true
}
}
provider "aws" {
region = var.aws_region
default_tags {
tags = {
Environment = var.environment
ManagedBy = "Terraform"
}
}
}
B. Declaración de Variables de Entrada (variables.tf)
Separa los valores dinámicos utilizando tipos estrictos y descripciones claras.
type = string
description = "Región de AWS donde se desplegarán los recursos"
default = "us-east-1"
}
variable "environment" {
type = string
description = "Entorno de despliegue (dev, staging, prod)"
}
variable "instance_config" {
type = object({
ami = string
instance_type = string
})
description = "Configuración base para la instancia EC2"
default = {
ami = "ami-0c55b159cbfafe1f0"
instance_type = "t3.micro"
}
}
C. Definición de Recursos y Outputs (main.tf / outputs.tf)
Un ejemplo clásico implementando un recurso acompañado de su respectivo archivo de salidas (outputs.tf) para exponer información crítica hacia otros sistemas o pipelines.
# main.tf
resource "aws_instance" "app_server" {
ami = var.instance_config.ami
instance_type = var.instance_config.instance_type
tags = {
Name = "Servidor-${var.environment}"
}
}
# outputs.tf
output "instance_id" {
value = aws_instance.app_server.id
description = "ID de la instancia EC2 desplegada"
}
output "instance_public_ip" {
value = aws_instance.app_server.public_ip
description = "Dirección IP pública del servidor"
}
3. Mejores Prácticas
Nunca subas los archivos
.tfstateal repositorio:Contienen secretos y mapeos exactos de tu infraestructura. Utiliza siempre backends remotos cifrados (como S3 con DynamoDB en AWS, GCS en Google Cloud o Terraform Cloud). Usa ficheros
.tfvarsseparados:Mantén los valores sensibles o específicos de cada entorno fuera del código principal usando archivos como terraform.tfvarso variables de entorno con el prefijoTF_VAR_.Automatiza en CI/CD: Integra
terraform planen tus Pull Requests para revisar cambios antes de hacer merge, y dejaterraform applyúnicamente para la rama principal bajo estrictas políticas de aprobación.
