# Referencia Rápida de Terraform

*Proveedores, recursos, variables, estado, módulos*

> Source: Terraform Documentation (developer.hashicorp.com/terraform) · MIT

## Fundamentos

### Flujo de Trabajo Principal

```
terraform init      # instalar proveedores y módulos
terraform plan      # previsualizar cambios
terraform apply     # aplicar cambios
terraform destroy   # desmantelar todos los recursos
```

### Comandos Esenciales

| Command | Description |
|---------|-------------|
| `terraform init` | Inicializar directorio de trabajo, descargar proveedores |
| `terraform plan` | Mostrar plan de ejecución sin aplicar |
| `terraform apply` | Aplicar cambios a la infraestructura |
| `terraform destroy` | Destruir todos los recursos gestionados |
| `terraform fmt` | Formatear archivos `.tf` al estilo canónico |
| `terraform validate` | Verificar sintaxis de la configuración |
| `terraform show` | Mostrar estado actual o plan |
| `terraform output` | Imprimir valores de salida |

## Proveedores

### Configuración del Proveedor

```
terraform {
  required_providers {
    aws = { source = "hashicorp/aws", version = "~> 5.0" }
  }
}
provider "aws" {
  region = "us-east-1"
}
```

### Notas sobre Proveedores

| Command | Description |
|---------|-------------|
| `source` | Dirección del registro (`hashicorp/aws`, `hashicorp/google`) |
| `version` | Restricción de versión (`~> 5.0`, `>= 3.0, < 4.0`) |
| `.terraform.lock.hcl` | Archivo de bloqueo — confirmar al control de versiones |
| `alias` | Usar múltiples configuraciones para el mismo proveedor |

## Recursos

### Bloques de Recursos

```
resource "aws_instance" "web" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"
  tags = { Name = "web-server" }
}
```

### Meta-Argumentos de Recursos

| Command | Description |
|---------|-------------|
| `depends_on` | Dependencia explícita de otro recurso |
| `count` | Crear múltiples instancias (`count = 3`) |
| `for_each` | Crear instancias desde un mapa o conjunto |
| `provider` | Seleccionar un alias de proveedor no predeterminado |
| `lifecycle` | Personalizar comportamiento de crear/actualizar/destruir |

### Referenciar Recursos

```
# tipo.nombre.atributo
aws_instance.web.id
aws_instance.web.public_ip
aws_vpc.main.cidr_block
```

## Variables

### Declarar Variables

```
variable "region" {
  type    = string
  default = "us-east-1"
}
variable "instance_count" {
  type        = number
  description = "Número de instancias"
}
```

### Establecer Valores de Variables

| Command | Description |
|---------|-------------|
| `-var 'region=us-west-2'` | Opción de línea de comandos |
| `-var-file=prod.tfvars` | Cargar desde un archivo `.tfvars` |
| `terraform.tfvars` | Se carga automáticamente si existe |
| `TF_VAR_region` | Variable de entorno |
| `Prompt interactivo` | Se solicita en plan/apply si no hay valor por defecto |

### Tipos de Variables

| Command | Description |
|---------|-------------|
| `string` | `"us-east-1"` |
| `number` | `42` |
| `bool` | `true` / `false` |
| `list(string)` | `["a", "b"]` |
| `map(string)` | `{ key = "val" }` |
| `object({...})` | Tipo estructurado con atributos con nombre |

## Salidas

### Definir Salidas

```
output "instance_ip" {
  value       = aws_instance.web.public_ip
  description = "IP pública del servidor web"
}
output "db_password" {
  value     = random_password.db.result
  sensitive = true
}
```

### Comandos de Salida

| Command | Description |
|---------|-------------|
| `terraform output` | Imprimir todas las salidas |
| `terraform output instance_ip` | Imprimir una salida específica |
| `terraform output -json` | Formato JSON para scripting |
| `sensitive = true` | Ocultar valor de la salida CLI |
| `module.vpc.vpc_id` | Acceder a salidas de módulos hijo |

## Estado

### Backend Remoto

```
terraform {
  backend "s3" {
    bucket = "my-tf-state"
    key    = "prod/terraform.tfstate"
    region = "us-east-1"
  }
}
```

### Comandos de Estado

| Command | Description |
|---------|-------------|
| `terraform state list` | Listar todos los recursos en estado |
| `terraform state show <addr>` | Mostrar atributos de un recurso |
| `terraform state mv <src> <dst>` | Renombrar / mover un recurso en estado |
| `terraform state rm <addr>` | Eliminar recurso del estado (conservar infraestructura) |
| `terraform state pull` | Descargar estado remoto a stdout |
| `terraform import <addr> <id>` | Importar infraestructura existente al estado |

## Módulos

### Usar Módulos

```
module "vpc" {
  source  = "terraform-aws-modules/vpc/aws"
  version = "~> 5.0"
  cidr    = "10.0.0.0/16"
}
```

### Fuentes de Módulos

| Command | Description |
|---------|-------------|
| `"./modules/vpc"` | Ruta local |
| `"terraform-aws-modules/vpc/aws"` | Registro de Terraform |
| `"github.com/org/repo//module"` | Repositorio de GitHub |
| `"s3::https://bucket/module.zip"` | Bucket S3 |

### Estructura del Módulo

```
modules/vpc/
  main.tf          # recursos
  variables.tf     # variables de entrada
  outputs.tf       # valores de salida
```

## Fuentes de Datos

### Leer Recursos Existentes

```
data "aws_ami" "ubuntu" {
  most_recent = true
  filter {
    name   = "name"
    values = ["ubuntu/images/hvm-ssd/*"]
  }
  owners = ["099720109477"]
}
```

### Fuentes de Datos Comunes

| Command | Description |
|---------|-------------|
| `data.aws_ami` | Buscar una AMI por filtros |
| `data.aws_vpc` | Buscar VPC existente |
| `data.aws_caller_identity` | ID de cuenta AWS actual |
| `data.aws_region` | Región AWS actual |
| `data.terraform_remote_state` | Leer salidas de otro archivo de estado |
| `data.external` | Ejecutar un programa externo para obtener datos |

## Ciclo de Vida

### Reglas de Ciclo de Vida

```
resource "aws_instance" "web" {
  lifecycle {
    create_before_destroy = true
    prevent_destroy       = true
    ignore_changes        = [tags]
  }
}
```

### Opciones de Ciclo de Vida

| Command | Description |
|---------|-------------|
| `create_before_destroy` | Crear reemplazo antes de destruir el antiguo |
| `prevent_destroy` | Error si `terraform destroy` apunta a este recurso |
| `ignore_changes` | No detectar desviaciones en atributos listados |
| `replace_triggered_by` | Forzar reemplazo cuando el recurso referenciado cambia |
| `precondition` | Validar supuestos antes de aplicar |
| `postcondition` | Validar resultados después de aplicar |

## Patrones Comunes

### Bucles y Condicionales

```
# for_each con un mapa
resource "aws_iam_user" "users" {
  for_each = toset(["alice", "bob"])
  name     = each.value
}
# recurso condicional
count = var.create_db ? 1 : 0
```

### Funciones Útiles

| Command | Description |
|---------|-------------|
| `file("key.pub")` | Leer contenido de archivo |
| `join(", ", list)` | Unir lista en cadena |
| `lookup(map, key, default)` | Búsqueda en mapa con valor por defecto |
| `length(list)` | Número de elementos |
| `toset(["a", "b"])` | Convertir lista a conjunto (para for_each) |
| `try(expr, fallback)` | Devolver fallback si expr produce error |
| `templatefile(path, vars)` | Renderizar un archivo de plantilla |