Lección 2 de 20 · Lectura y práctica
Estructura de Archivos Terraform y Sintaxis HCL
Concepto claveLa estructura de archivos en Terraform y la sintaxis HCL (HashiCorp Configuration Language) son el esqueleto de tu infraestructura como codigo. Imagina que estás construyendo una casa: los archivos Terraform son los.
Del concepto a la práctica
Taller de esta lección
La estructura de archivos debe hacer visible la intención: variables de entrada, recursos, proveedores y salidas. Para una red de aula, separa variables.tf, main.tf, outputs.tf y terraform.tfvars. Terraform carga los archivos del directorio como una configuración conjunta, pero la separación permite revisar responsabilidades.
Ejemplo resuelto
Usa una variable environment con valor dev, una etiqueta común basada en esa variable y un output que exponga el nombre lógico de la red. La decisión es no repetir dev en cada recurso: un solo cambio debe actualizar las etiquetas previstas.
Pruébalo
Define environment como variable de tipo string con una descripción.
Declara un local con la etiqueta Environment igual a var.environment.
Usa ese local en dos recursos de práctica.
Expón la etiqueta mediante un output y ejecuta terraform fmt y terraform validate.
Error frecuente: declarar una variable pero escribir luego el valor directamente en los recursos. Corrección: reemplaza el literal por la referencia de variable y valida que el plan cambie al modificar el archivo de valores.
Ejercicio: cambia dev por staging sin editar los recursos.
Comprueba tu resultado
el plan muestra las dos etiquetas actualizadas y ninguna referencia antigua a dev en la configuración evaluada.
HCL conjunto y ejercicio sin proveedor externo
Los nombres main.tf/variables.tf/outputs.tf son convenciones; Terraform reúne archivos .tf del directorio, sin ejecutar primero uno por su nombre. Los subdirectorios no se incorporan automáticamente: se llaman como módulos. La indentación facilita lectura, pero HCL no es Python; una indentación distinta no invalida por sí misma bloques correctamente delimitados.
Para practicar etiquetas sin AWS ni recursos facturables, este ejemplo completo usa terraform_data, integrado en Terraform1.4+:
variable "environment" {
type = string
default = "dev"
validation {
condition = contains(["dev", "staging", "prod"], var.environment)
error_message = "Entorno inválido."
}
}
locals {
tags = { Environment = var.environment }
}
resource "terraform_data" "etiquetas" {
for_each = toset(["red", "app"])
input = local.tags
}
output "etiquetas" {
value = { for k, r in terraform_data.etiquetas : k => r.output }
}Desde un estado local que ya registrara dev, pasar environment=staging cambia input de red/app a staging; desde estado vacío propone dos altas, no dos actualizaciones. No son recursos AWS. fmt -check compara formato; validate revisa configuración con módulos/proveedores previamente inicializados, no disponibilidad en nube. En proyectos con proveedores, init -backend=false prepara validación sin inicializar backend, pero aún puede descargar dependencias. No lo hemos ejecutado.

Mapa de prácticaUna condición decide qué camino ejecuta el programa. Un bucle repite una operación mientras queden elementos, y termina cuando la lista se agota. Separar ambas ideas ayuda a seguir el flujo y comprobar casos límite.
Ver la infografía en tamaño completo ↗Concepto clave
La estructura de archivos en Terraform y la sintaxis HCL (HashiCorp Configuration Language) son el esqueleto de tu infraestructura como codigo. Imagina que estás construyendo una casa: los archivos Terraform son los planos arquitectonicos, y HCL es el lenguaje en el que escribes esos planos. Sin una estructura clara, terminas con un caos de archivos que nadie puede mantener.
HCL es un lenguaje declarativo diseñado especificamente para configuraciones. A diferencia de lenguajes de programacion tradicionales, no describes como hacer algo, sino que quieres que exista. Por ejemplo, en lugar de escribir pasos para crear una instancia EC2, declaras: "quiero una instancia EC2 con estas caracteristicas". Terraform se encarga del resto.
Como funciona en la practica
Cuando trabajas con Terraform en AWS, sigues un flujo estructurado. Primero, defines tu proveedor (AWS) y configuras la autenticacion. Luego, organizas tu codigo en archivos logicos. Un proyecto tipico incluye:
- main.tf: Contiene los recursos principales como instancias EC2, VPCs, o buckets S3.
- variables.tf: Define variables que parametrizan tu infraestructura.
- outputs.tf: Especifica que valores exponer despues del despliegue.
- terraform.tfvars: Asigna valores a las variables definidas.
Para comenzar, creas un directorio para tu proyecto y dentro, el archivo main.tf con la configuracion basica del proveedor AWS. Luego, ejecutas terraform init para inicializar el proyecto, lo que descarga el proveedor y configura el backend.
Codigo en accion
A continuacion, un ejemplo funcional de una estructura basica para desplegar una instancia EC2 en AWS:
# provider.tf
terraform {
required_providers {
aws = {
source = "hashicorp/aws"
version = "~> 5.0"
}
}
}
provider "aws" {
region = "us-east-1"
}
# main.tf
resource "aws_instance" "web_server" {
ami = "ami-0c55b159cbfafe1f0" # Amazon Linux 2 AMI
instance_type = "t2.micro"
tags = {
Name = "WebServerExample"
}
}
Antes de refactorizar, podrias tener todo en un solo archivo. Despues, separas en provider.tf y main.tf para mejorar la mantenibilidad.
Errores comunes
- No usar variables para valores repetitivos: Si tienes la misma region en multiples recursos, crea una variable en variables.tf para evitar inconsistencias.
- Olvidar
terraform inital clonar un proyecto: Sin inicializar, Terraform no puede trabajar con los proveedores necesarios. - Mala indentacion en HCL: HCL es sensible a la estructura; una indentacion incorrecta puede causar errores de sintaxis.
- No validar con
terraform validate: Siempre valida tu codigo antes de aplicar para detectar errores temprano. - Hardcodear credenciales en los archivos: Usa variables de entorno o AWS CLI config para credenciales, nunca las escribas directamente en el codigo.
Checklist de dominio
- Puedo explicar la diferencia entre HCL y un lenguaje de programacion imperativo.
- He creado una estructura basica de archivos Terraform con al menos tres archivos separados.
- Se como usar
terraform init,terraform plan, yterraform applyen secuencia. - Puedo identificar y corregir un error de sintaxis comun en HCL, como falta de llaves.
- He refactorizado codigo para mover valores hardcodeados a variables.
- Se como configurar el proveedor AWS con autenticacion segura.
- Puedo leer un archivo Terraform existente y entender que recursos declara.
Crear y desplegar una estructura basica de VPC en AWS con Terraform
En este ejercicio, practicaras la estructura de archivos Terraform y sintaxis HCL para desplegar una VPC (Virtual Private Cloud) en AWS. Sigue estos pasos:
- Crea un nuevo directorio llamado terraform-vpc-practice en tu maquina local.
- Dentro del directorio, crea los siguientes archivos: provider.tf, main.tf, variables.tf, y terraform.tfvars.
- En provider.tf, configura el proveedor AWS para usar la region us-east-1.
- En variables.tf, define una variable llamada vpc_cidr con tipo string y una descripcion.
- En terraform.tfvars, asigna el valor "10.0.0.0/16" a la variable vpc_cidr.
- En main.tf, usa la variable vpc_cidr para crear un recurso aws_vpc con un tag Name "MiVPCDePractica".
- Ejecuta
terraform initpara inicializar el proyecto. - Ejecuta
terraform planpara revisar los cambios. - Si el plan es correcto, ejecuta
terraform applyy confirma con yes para desplegar la VPC. - Verifica en la consola de AWS que la VPC se ha creado correctamente.
Pistas
- Recuerda que en HCL, los bloques de recursos usan llaves {} y cada argumento debe estar indentado.
- Puedes usar el comando
terraform validatedespues de escribir cada archivo para verificar la sintaxis. - Si tienes problemas con la autenticacion, asegurate de tener configuradas las credenciales de AWS CLI o variables de entorno.
Evalua tu comprension
Completa el quiz interactivo de arriba para ganar XP.
Sigue con Terraform en AWS: Infraestructura como Código para DevOps
Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.
Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.