Ya sabemos que queremos describir la infraestructura en código (IaC). Pero hay dos formas de hacerlo: el enfoque imperativo y el declarativo. Entender esta diferencia es clave para comprender cómo «piensa» Terraform y por qué resulta tan cómodo. Es un concepto sencillo con una analogía que lo deja clarísimo.

• Imperativo: describes PASO A PASO cómo llegar al resultado. Das instrucciones detalladas en orden: «haz esto, luego esto, luego esto otro».
• Declarativo: describes QUÉ resultado quieres, y dejas que la herramienta averigüe cómo conseguirlo. Solo dices el destino, no el camino.

Analogía del taxi (la clave de todo):

• Imperativo: le das al taxista indicaciones paso a paso: «gira a la derecha, sigue recto 200 metros, en la rotonda toma la segunda salida, gira a la izquierda…». Si te equivocas en un paso, llegas mal.
• Declarativo: le dices al taxista «llévame al aeropuerto». Él decide la mejor ruta. Si hay un atasco, busca otro camino. Tú solo expresaste el destino deseado.

Terraform es declarativo: tú declaras el destino (la infraestructura que quieres) y él calcula los pasos.

Un enfoque imperativo sería, por ejemplo, un script (en Bash, Python…) que ejecuta comandos en orden:

Problemas del enfoque imperativo:

• Tú gestionas el orden y todas las dependencias.
• ¿Qué pasa si lo ejecutas dos veces? Podría intentar crear cosas que ya existen y fallar, o duplicarlas. Tienes que escribir lógica para comprobar «¿ya existe esto?» en cada paso.
• ¿Y si algo cambia? Tienes que escribir más instrucciones para detectar y modificar el estado actual.

Es como las indicaciones paso a paso: funciona, pero eres responsable de cada detalle y de cada imprevisto.

Con el enfoque declarativo (el de Terraform), tú escribes el estado final deseado:

No dices en qué orden crearlo ni cómo. Simplemente declaras lo que quieres que exista. Terraform se encarga del resto:

• Calcula el orden correcto y las dependencias automáticamente (sabe que la subred va dentro de la red, así que crea la red primero).
• Compara lo que has declarado con lo que ya existe.
• Hace solo los cambios necesarios para que la realidad coincida con tu declaración.

Aquí está la palabra clave del enfoque declarativo: idempotencia.

Idempotencia significa que puedes aplicar la misma configuración muchas veces y el resultado siempre es el mismo. No importa cuántas veces lo ejecutes: si ya está en el estado deseado, no hace nada; si falta algo, lo crea; si algo difiere, lo ajusta.

Ejemplo práctico: Declaras que quieres «1 servidor».

• Lo aplicas: Terraform ve que no hay ninguno y crea 1.
• Lo aplicas otra vez (sin cambiar nada): Terraform ve que ya hay 1 y no hace nada. No crea un segundo servidor por error.
• Cambias la declaración a «3 servidores» y aplicas: Terraform ve que hay 1 y añade 2 más para llegar a 3.

Siempre acabas con exactamente lo que declaraste. Esto es justo lo contrario de un script imperativo, que podría crear servidores duplicados cada vez que lo ejecutas.

La idempotencia es lo que hace que la IaC declarativa sea segura y predecible. Resuelve directamente el problema del «¿qué pasa si lo ejecuto otra vez?».

El enfoque imperativo tiene su lugar (scripts puntuales, automatizaciones concretas). Pero para gestionar infraestructura, el declarativo es muy superior porque:

• Es más fácil de leer: el código describe directamente cómo debe quedar todo.
• Es idempotente y seguro de re-ejecutar.
• La herramienta gestiona la complejidad (orden, dependencias, cambios) por ti.

Por eso las principales herramientas de IaC modernas, Terraform incluida, son declarativas.

Matiz: algunas herramientas modernas (como el CDK de AWS o Pulumi, que veremos en el subcapítulo 9.3) usan lenguajes de programación normales, lo que parece imperativo, pero por debajo generan un modelo declarativo. Lo importante es el resultado: declaras el estado deseado.

• Imperativo: describes cómo (los pasos, en orden). Tú gestionas el orden y las repeticiones.
• Declarativo: describes qué quieres (el resultado final). La herramienta calcula el cómo. Es el enfoque de Terraform.
• La analogía: imperativo = indicaciones giro a giro; declarativo = «llévame al aeropuerto».
• La gran ventaja declarativa es la idempotencia: aplicar la misma configuración muchas veces siempre da el mismo resultado, sin duplicados ni sorpresas.
• Para gestionar infraestructura, el enfoque declarativo es más legible, seguro y predecible.

En el siguiente subcapítulo compararemos las herramientas de IaC más importantes —Terraform, CloudFormation, Pulumi y CDK— y veremos por qué elegimos Terraform.