Terraform: infraestructura como código

1# 🟦 Windows (PowerShell)
2# Opción 1: Con Chocolatey
3choco install terraform
4
5# Opción 2: Descarga directa de HashiCorp
6# https://developer.hashicorp.com/terraform/downloads → Windows AMD64
7# Extraer el .zip y añadir la carpeta al PATH
8
9# Verificar:
10terraform --version
11# Terraform v1.7.x

Instalación en Windows — Chocolatey es el método más rápido

1# 🍎 Mac (Terminal)
2brew install terraform
3
4# Verificar:
5terraform --version
6# Terraform v1.7.x

Instalación en Mac — una línea con Homebrew

1# main.tf — tu primer archivo Terraform
2# Configurar el provider AWS apuntando a LocalStack
3terraform {
4  required_providers {
5    aws = {
6      source  = "hashicorp/aws"
7      version = "~> 5.0"
8    }
9  }
10}
11
12provider "aws" {
13  region                      = "eu-west-1"
14  access_key                  = "test"
15  secret_key                  = "test"
16  s3_use_path_style           = true
17  skip_credentials_validation = true
18  skip_metadata_api_check     = true
19  skip_requesting_account_id  = true
20
21  endpoints {
22    s3             = "http://localhost:4566"
23    iam            = "http://localhost:4566"
24    lambda         = "http://localhost:4566"
25    stepfunctions  = "http://localhost:4566"
26    glue           = "http://localhost:4566"
27  }
28}
29
30# Crear un bucket S3 para el data lake
31resource "aws_s3_bucket" "datalake" {
32  bucket = "fashionstore-datalake-tf"
33}
34
35# Crear role IAM para Glue
36resource "aws_iam_role" "glue_role" {
37  name = "glue-etl-role-tf"
38  assume_role_policy = jsonencode({
39    Version = "2012-10-17"
40    Statement = [{
41      Action    = "sts:AssumeRole"
42      Effect    = "Allow"
43      Principal = { Service = "glue.amazonaws.com" }
44    }]
45  })
46}

main.tf — provider configurado para LocalStack + recursos declarativos

1# 1. Inicializar (descarga el provider AWS)
2terraform init
3
4# 2. Ver qué VA A HACER (dry run — no toca nada)
5terraform plan
6# Plan: 2 to add, 0 to change, 0 to destroy.
7
8# 3. Aplicar los cambios (CREA los recursos)
9terraform apply
10# Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
11
12# 4. Ver el estado actual
13terraform show
14
15# 5. Destruir TODO (cuidado en producción!)
16terraform destroy

Siempre: plan ANTES de apply. Nunca apliques sin revisar el plan primero.

1# variables.tf — parámetros configurables
2variable "environment" {
3  description = "Entorno: dev, staging, prod"
4  type        = string
5  default     = "dev"
6}
7
8variable "bucket_name" {
9  description = "Nombre del bucket del data lake"
10  type        = string
11}
12
13variable "enable_versioning" {
14  description = "Activar versionado en el bucket"
15  type        = bool
16  default     = true
17}
18
19# Uso en main.tf:
20resource "aws_s3_bucket" "datalake" {
21  bucket = "${var.environment}-${var.bucket_name}"
22}
23
24# outputs.tf — valores que puedes consultar después
25output "bucket_arn" {
26  value       = aws_s3_bucket.datalake.arn
27  description = "ARN del bucket del data lake"
28}
29
30output "glue_role_arn" {
31  value = aws_iam_role.glue_role.arn
32}

Variables hacen tu código reutilizable — el mismo tf sirve para dev, staging y prod

1# Estructura de módulos:
2# terraform/
3# ├── main.tf          (orquesta módulos)
4# ├── variables.tf
5# ├── outputs.tf
6# └── modules/
7#     ├── datalake/
8#     │   ├── main.tf
9#     │   ├── variables.tf
10#     │   └── outputs.tf
11#     └── iam/
12#         ├── main.tf
13#         ├── variables.tf
14#         └── outputs.tf
15
16# En main.tf principal:
17module "datalake" {
18  source      = "./modules/datalake"
19  environment = var.environment
20  bucket_name = "fashionstore-datalake"
21}
22
23module "iam" {
24  source      = "./modules/iam"
25  environment = var.environment
26  bucket_arn  = module.datalake.bucket_arn  # Output de otro módulo
27}

Módulos = componentes reutilizables. El main.tf solo los conecta.