terraform plan hace tres cosas bien: valida la sintaxis, resuelve las referencias entre recursos y refresca el state contra el proveedor para los recursos que ya administra. Lo que no hace es llamar al proveedor para preguntar si lo que la configuración da por sentado existe, está permitido o tiene lugar. Esa es la brecha entre el plan verde y el apply rojo, y es más ancha de lo que parece: una subred escrita a mano, una credencial que sólo puede leer, una cuota de vCPU que ya está en el límite. Ninguna de esas cosas aparece en el plan.
Estas son las seis cosas que plan no verifica. Para cada una: qué ve el plan, con qué choca el apply y un comando de sólo lectura por proveedor para preguntarlo antes. Los comandos están tomados de la referencia oficial de cada CLI.
1. La subred referenciada por nombre o por ID a mano
Lo que ve el plan: un string. subnet_id = "subnet-0abc..." o un var.subnet_name que llega desde un tfvars. Si el string tiene la forma correcta, el plan lo acepta; no comprueba que la subred exista en esa región ni en esa cuenta.
Con lo que choca el apply: InvalidSubnetID.NotFound, un 404 del proveedor o, peor, una subred que existe pero en otra VPC, y la VM sale en una red que no era.
# AWS
aws ec2 describe-subnets --filters "Name=tag:Name,Values=snet-app" "Name=vpc-id,Values=$VPC"
# Azure
az network vnet subnet show -g rg-app --vnet-name vnet-app -n snet-app
# OCI
oci network subnet list --compartment-id "$C" --vcn-id "$VCN" --display-name snet-app
# GCP
gcloud compute networks subnets describe snet-app --region us-central1
Arreglo parcial: un data source con filtros (data "aws_subnet" con filter, data "azurerm_subnet", data "oci_core_subnets", data "google_compute_subnetwork") mueve la verificación al plan, porque el data source sí llama a la API. Parcial porque sólo cubre lo que se declaró como data source; el ID pegado en un tfvars sigue sin verificarse.
2. El alcance de la credencial
Lo que ve el plan: una credencial que puede leer. plan necesita permisos de lectura para refrescar el state, y si los tiene, termina verde. No simula el Create que viene después.
Con lo que choca el apply: UnauthorizedOperation, AuthorizationFailed, NotAuthorizedOrNotFound (OCI mezcla los dos casos a propósito) o un 403 de GCP a mitad del apply, con la mitad de los recursos ya creados.
# AWS: quién soy y si puedo crear la instancia
aws sts get-caller-identity
aws iam simulate-principal-policy --policy-source-arn "$ROLE_ARN" --action-names ec2:RunInstances ec2:CreateTags
# Azure: roles efectivos, incluidos los heredados de scopes superiores
az role assignment list --assignee "$SP_ID" --include-inherited --all
# OCI: las policies del compartimento (la tenancy es el compartimento raíz)
oci iam policy list --compartment-id "$C" --all
# GCP: bindings del proyecto
gcloud projects get-iam-policy "$PROJECT"
En OCI la lectura es manual: la propia referencia de la CLI dice que para saber qué policies aplican a un grupo hay que leer las sentencias una por una, no hay API que lo responda. El simulador de AWS sí responde allow o deny por acción, y es el único de los cuatro que lo hace sin intentar la operación.
3. La cuota
Lo que ve el plan: nada. Las cuotas no son un atributo de ningún recurso, así que no hay dónde refrescarlas.
Con lo que choca el apply: InstanceLimitExceeded en AWS, un OperationNotAllowed que habla de la cuota de cores en Azure, LimitExceeded en OCI, Quota 'CPUS' exceeded en GCP.
# AWS: vCPU on-demand estándar (L-1216C47A) en la región
aws service-quotas get-service-quota --service-code ec2 --quota-code L-1216C47A
# Azure: uso y límite por familia en la región
az vm list-usage -l brazilsouth -o table
# OCI: disponible y usado para un límite concreto
oci limits resource-availability get --compartment-id "$T" --service-name compute --limit-name standard-a1-core-count --availability-domain "$AD"
# GCP: la lista quotas de la región, con usage y limit
gcloud compute regions describe us-central1 --format="yaml(quotas)"
Las cuatro respuestas traen el límite y el uso. Si la diferencia es menor que lo que el plan va a crear, el apply va a fallar y el plan no lo sabe.
4. La capacidad, que no es la cuota
Lo que ve el plan: tampoco nada, y acá ni un data source ayuda. Tener cuota para 8 vCPU no significa que haya un host libre para ese shape en ese availability domain en este momento.
Con lo que choca el apply: InsufficientInstanceCapacity en AWS, AllocationFailed o SkuNotAvailable en Azure, Out of host capacity en OCI. La diferencia con la cuota importa porque la solución es distinta: la cuota se pide; la capacidad se espera, se cambia de zona o se cambia de tamaño.
Lo único que se puede leer antes es la lista de SKUs con restricciones para la suscripción; para la capacidad del momento no hay API de lectura, sólo el intento:
# Azure: tamaños con restricciones por zona para esta suscripción
az vm list-skus -l brazilsouth --resource-type virtualMachines --zone --all -o table
En OCI el loop de reintentos de la nota anterior es la respuesta honesta; en AWS la guía de troubleshooting de EC2 sugiere lo mismo: reintentar, bajar la cantidad o sacar la zona del pedido.
5. La salida a internet: NAT, gateway y ruta
Lo que ve el plan: la VM y, si están en la misma configuración, la subred y la tabla de rutas. Lo que no ve es si esa tabla tiene una ruta 0.0.0.0/0 hacia algo cuando la red la creó otro equipo u otro state.
Con lo que choca el apply: con nada, y por eso es el peor caso. La VM se crea, el apply sigue verde hasta el provisioner o el user_data que hace apt-get update, y ahí se cuelga o falla por timeout. Terraform marca el recurso como tainted y el siguiente apply lo recrea, para fallar igual.
# AWS: la tabla asociada a la subred y si tiene 0.0.0.0/0 (igw-* o nat-*)
aws ec2 describe-route-tables --filters "Name=association.subnet-id,Values=$SUBNET" --query "RouteTables[].Routes[?DestinationCidrBlock=='0.0.0.0/0']"
# Azure: route table (null = rutas del sistema), NAT gateway y si la subred es privada
az network vnet subnet show -g rg-app --vnet-name vnet-app -n snet-app --query "{routeTable:routeTable.id, natGateway:natGateway.id, defaultOutboundAccess:defaultOutboundAccess}"
# OCI: reglas de ruta y service gateways de la VCN
oci network route-table list --compartment-id "$C" --vcn-id "$VCN" --query 'data[*]."route-rules"'
oci network service-gateway list --compartment-id "$C" --vcn-id "$VCN"
# GCP: los NAT del Cloud Router de la región
gcloud compute routers nats list --router "$ROUTER" --region us-central1
En Azure hay una fecha: según la página de Default Outbound Access, para la versión de API posterior al 31 de marzo de 2026 las subredes de VNets nuevas nacen con defaultOutboundAccess en false, y una VM ahí necesita NAT Gateway, IP pública o load balancer con reglas de salida para llegar a internet. Una configuración que salía bien en una VNet vieja deja de salir en una nueva, y el plan es idéntico.
6. Lo que vive en otro state
Lo que ve el plan: terraform_remote_state u outputs de otro módulo, resueltos al momento del plan. Pero si el valor depende de un recurso que todavía no existe (el otro state no se aplicó, o un count depende de algo que se crea en este mismo apply), el plan muestra (known after apply) y sigue.
Con lo que choca el apply: el recurso del otro state no está, o está con otro ID porque alguien lo recreó, y el error es del proveedor, no de Terraform. Lo que sí se puede hacer es inventariar cuánto del plan está en (known after apply) antes de aprobarlo:
terraform plan -out plan.out
terraform show -json plan.out | jq -r '.resource_changes[] | select(.change.actions | index("create")) | "\(.address): \(.change.after_unknown | keys | join(","))"'
# y lo que el otro state exporta hoy, no lo que exportaba cuando se escribió el módulo
terraform state list
terraform output -json
after_unknown es un campo documentado del formato JSON de Terraform: lista cada atributo que no se va a conocer hasta el apply. Si entre ellos están subnet_id o network_interface_ids, los puntos 1 y 5 de esta lista no se pudieron verificar en el plan por construcción.
Lo que sí se puede automatizar hoy
Todo lo anterior cabe en un script que corre antes del apply, sin herramienta nueva. El esqueleto, con AWS como ejemplo:
#!/usr/bin/env bash
set -euo pipefail
terraform plan -out plan.out -input=false
PLAN=$(terraform show -json plan.out)
# 1. cada create con atributos desconocidos
echo "$PLAN" | jq -r '.resource_changes[] | select(.change.actions|index("create")) | "\(.address) unknown: \(.change.after_unknown|keys|join(","))"'
# 2. las subredes que el plan referencia por ID, contra la API
for s in $(echo "$PLAN" | jq -r '.resource_changes[].change.after.subnet_id? // empty' | sort -u); do
aws ec2 describe-subnets --subnet-ids "$s" --query 'Subnets[0].SubnetId' --output text >/dev/null || { echo "subnet $s not found"; exit 1; }
done
# 3. cuota contra lo que se crea
NEED=$(echo "$PLAN" | jq '[.resource_changes[] | select(.type=="aws_instance" and (.change.actions|index("create")))] | length')
echo "instances to create: $NEED"
aws service-quotas get-service-quota --service-code ec2 --quota-code L-1216C47A --query 'Quota.Value'
# 4. credencial (simulate-principal-policy) y 5. rutas (describe-route-tables) van acá
terraform apply plan.out
Dos límites. El script conoce un proveedor por vez y lee lo que el plan ya decidió: una subred que entra por variable sin pasar por el plan JSON no la ve. Y la capacidad (punto 4) no tiene lectura previa en ningún proveedor.
Control Cloud corre estas verificaciones desde la app, contra la tenancy en vivo y con la credencial de sólo lectura que ya está conectada: alcance de la credencial, subred y salida a internet, dependencias de la plantilla y hosts, antes de que el Terraform exista, porque el Terraform se genera desde el canvas después del chequeo. Lo que no hace: cuotas reales (sólo umbrales suaves en IONOS) y no hay hook de CI ni API pública; corre desde el canvas y desde Pre-Deploy. El video de pre-flight muestra el recorrido completo.
¿Cuál de las seis te rompió el último apply con el plan en verde?
Top comments (0)