Llegó el momento de escribir Terraform de verdad. El lenguaje se llama HCL (HashiCorp Configuration Language) y se organiza en bloques. En este subcapítulo conocerás los cuatro bloques más importantes que usarás constantemente: resource, variable, output y locals. Con ellos ya puedes describir infraestructura real.

El código de Terraform se escribe en archivos con extensión .tf. Todo en HCL se estructura en bloques, que tienen esta forma general:

No te preocupes por la sintaxis exacta ahora; la verás con ejemplos. Lo importante: HCL es legible, parecido a rellenar una ficha con datos. Vamos con los cuatro bloques clave.

El bloque resource es el más importante de todos. Describe un recurso de infraestructura que quieres que exista: un servidor, una red, un bucket…

Desglosemos:

• resource → el tipo de bloque.
• "aws_instance" → el tipo de recurso (una instancia EC2 de AWS). El prefijo aws_ indica que es de AWS.
• "mi_servidor" → el nombre que TÚ le das para referirte a él dentro de tu código (no es el nombre en AWS, es una etiqueta interna).
• Dentro de { } → los argumentos que configuran el recurso (qué AMI usar, qué tipo de instancia… ¿recuerdas el Capítulo 4?).

Analogía: Un bloque resource es como rellenar el formulario de pedido de un recurso: «quiero una instancia, de tipo t3.micro, con esta imagen». Terraform lee el formulario y lo crea por ti.

Cada recurso de AWS que viste en la Parte II (EC2, S3, VPC…) tiene su tipo de resource en Terraform: aws_instance, aws_s3_bucket, aws_vpc, etc.

El bloque variable define valores configurables que puedes cambiar sin tocar el resto del código. Son como los «parámetros» de tu configuración.

Luego usas esa variable en tus recursos con la sintaxis var.nombre:

Por qué son útiles: Las variables hacen tu código reutilizable y flexible. Por ejemplo, puedes usar t3.micro en pruebas y m5.large en producción cambiando solo el valor de la variable, sin tocar la definición del servidor. Lo veremos más en el Capítulo 19 (entornos).

Analogía: Las variables son como los ajustes configurables de un electrodoméstico. La lavadora es la misma, pero ajustas la temperatura y el programa según la colada. Tu código es el mismo, pero ajustas las variables según el entorno.

El bloque output muestra información útil después de aplicar tu configuración. Sirve para «sacar» datos que necesitas saber, como la IP de un servidor o la URL de una web.

Cuando ejecutas terraform apply, al terminar verás:

Por qué son útiles: Después de crear infraestructura, necesitas saber datos como «¿cuál es la IP de mi servidor?» o «¿cuál es la dirección de mi base de datos?». Los outputs te los muestran automáticamente, sin tener que buscarlos en la consola de AWS. También sirven para pasar información entre módulos (Capítulo 18).

Analogía: Los outputs son como el recibo o resumen que te dan al final: «aquí tienes los datos importantes de lo que acabas de crear».

El bloque locals define valores internos reutilizables dentro de tu código. A diferencia de las variables (que entran desde fuera), los locals son valores que defines y calculas dentro de tu configuración.

Y los usas con local.nombre:

Cuándo usarlos: para evitar repetir valores o cálculos. Si usas el mismo nombre o la misma combinación de valores en muchos sitios, lo defines una vez en locals y lo reutilizas. Si cambia, lo cambias en un solo lugar.

Variable vs Local — la diferencia clave:

• variable: entra desde fuera (la configura quien usa el código). «Parámetro de entrada».
• local: se define y calcula dentro del código. «Valor interno reutilizable».

Este código: toma un entorno como variable, calcula un nombre con un local, crea un servidor etiquetado con ese nombre, y muestra su IP como output. ¡Ya estás leyendo Terraform!

• HCL se organiza en bloques, escritos en archivos .tf.
• resource: el bloque más importante; describe la infraestructura que quieres crear (servidores, redes, buckets…).
• variable: valores configurables que entran desde fuera; se usan con var.nombre. Hacen el código reutilizable.
• output: muestra información útil tras apply (IPs, URLs…); se usa con la referencia al recurso.
• locals: valores internos reutilizables que defines dentro del código; se usan con local.nombre.
• Diferencia clave: variable = entra de fuera; local = se calcula dentro.

En el siguiente subcapítulo veremos los tipos de datos de HCL (string, number, list, map, object…) para dar forma a tus variables y valores.