https://registry.terraform.io/providers/hashicorp/aws/latest/docs

Provider: hashicorp/aws
├── Overview          <- Configuración del bloque provider {}
├── Guides            <- Guías de migración entre versiones
├── Resources         <- Recursos gestionados (aws_instance, aws_vpc, etc.)
│   ├── aws_instance
│   │   ├── Example Usage     <- Ejemplos copiables
│   │   ├── Argument Reference <- Todos los argumentos disponibles
│   │   ├── Attributes Reference <- Valores exportados por el recurso
│   │   └── Import            <- Cómo importar con terraform import
│   └── ...
└── Data Sources      <- Fuentes de datos (data "aws_ami" {}, etc.)
    ├── aws_ami
    └── ...

# Al leer la doc de aws_instance en el Registry, encontrarás:

# Required Arguments (obligatorios):
resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"  # Required: ID de la AMI
  instance_type = "t2.micro"               # Required: tipo de instancia
}

# Optional Arguments (opcionales, con sus valores por defecto):
resource "aws_instance" "example" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"

  # Optional - defaults to false
  associate_public_ip_address = true

  # Optional - defaults to null (no EBS optimization)
  ebs_optimized = false

  # Optional block
  tags = {
    Name = "example"
  }
}

# Attributes Reference (valores que puedes referenciar DESPUÉS de crear):
output "instance_id" {
  value = aws_instance.example.id  # Exportado: ID de la instancia
}

output "private_ip" {
  value = aws_instance.example.private_ip  # IP privada asignada
}

https://developer.hashicorp.com/terraform/docs
https://developer.hashicorp.com/terraform/tutorials

Título: aws_s3_bucket: Error "AccessDenied" al crear bucket con política personalizada

Entorno:
- Terraform v1.6.2
- Provider hashicorp/aws v5.25.0
- Region: eu-west-1

Problema:
Al ejecutar terraform apply, obtengo AccessDenied al intentar crear un bucket
con block_public_acls = true. Sin esa configuración, el bucket se crea correctamente.

Código:
[código mínimo reproducible]

Error completo:
[mensaje de error completo]

Lo que intenté:
1. Verificar permisos IAM - tengo s3:CreateBucket y s3:PutBucketPublicAccessBlock
2. Probar sin block_public_acls - funciona correctamente

# Búsqueda con etiqueta específica
https://stackoverflow.com/questions/tagged/terraform

# Búsqueda combinada
site:stackoverflow.com [terraform] aws_s3_bucket AccessDenied

# Búsqueda en Google
"terraform" "aws_instance" "Error: Invalid count argument" site:stackoverflow.com

# Antes de crear un nuevo issue, buscar si ya existe
# En GitHub, en el repositorio del provider:
# Issues -> Search -> "tu mensaje de error"

# También puedes buscar en la URL:
# https://github.com/hashicorp/terraform-provider-aws/issues?q=your+error+message

## Versiones de Terraform y del Provider

- Terraform: 1.6.2
- Provider AWS: 5.25.0

## Comportamiento esperado

Al crear un `aws_s3_bucket_cors_configuration`, las reglas de CORS deben
aplicarse correctamente.

## Comportamiento actual

El recurso se crea sin errores, pero las reglas de CORS no aparecen en la
consola de AWS.

## Pasos para reproducir

## Logs de debug

https://developer.hashicorp.com/terraform/tutorials

https://www.hashicorp.com/blog/category/terraform

https://www.reddit.com/r/Terraform/

# terragrunt.hcl - En lugar de repetir el backend en cada módulo
remote_state {
  backend = "s3"
  config = {
    bucket         = "mi-empresa-terraform-state"
    key            = "${path_relative_to_include()}/terraform.tfstate"
    region         = "us-east-1"
    encrypt        = true
    dynamodb_table = "terraform-state-locks"
  }
}

# Incluir configuraciones compartidas
inputs = merge(
  yamldecode(file("${get_terragrunt_dir()}/../common.yaml")),
  {
    environment = "prod"
  }
)

URL: https://terragrunt.gruntwork.io

# atlantis.yaml - Configuración básica
version: 3
projects:
- name: prod-vpc
  dir: environments/prod/vpc
  workspace: default
  terraform_version: v1.6.2
  autoplan:
    when_modified: ["*.tf", "../modules/**/*.tf"]
    enabled: true

URL: https://www.runatlantis.io

# Instalar infracost
brew install infracost  # macOS
# o
curl -fsSL https://raw.githubusercontent.com/infracost/infracost/master/scripts/install.sh | sh

# Obtener API key gratuita
infracost auth login

# Ver el costo estimado del plan actual
infracost breakdown --path .

# Comparar costos antes y después de un cambio
infracost diff --path . --compare-to main

URL: https://www.infracost.io

# Checkov - Análisis de seguridad
pip install checkov

# Analizar el directorio actual
checkov -d .

# Analizar y exportar en formato JSON
checkov -d . -o json > checkov-report.json

# Salida de ejemplo:
# Check: CKV_AWS_79: "Ensure Instance Metadata Service Version 1 is not enabled"
#   PASSED for resource: aws_instance.web
# Check: CKV_AWS_8: "Ensure all data stored in the Launch configuration EBS is securely encrypted"
#   FAILED for resource: aws_instance.web
#   File: /main.tf:10-20

# Terrascan - Cumplimiento de políticas
brew install terrascan  # macOS

# Escanear con las políticas por defecto
terrascan scan -t aws

# Escanear con políticas específicas
terrascan scan -t aws -p policies/

Checkov: https://www.checkov.io
Terrascan: https://runterrascan.io

# Instalar tfenv
git clone --depth=1 https://github.com/tfutils/tfenv.git ~/.tfenv
echo 'export PATH="$HOME/.tfenv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Listar versiones disponibles
tfenv list-remote | head -20

# Instalar una versión específica
tfenv install 1.6.2
tfenv install 1.5.7

# Cambiar la versión activa globalmente
tfenv use 1.6.2

# Usar una versión específica para un proyecto (crea .terraform-version)
echo "1.5.7" > .terraform-version
tfenv use  # Detecta automáticamente .terraform-version

# Ver versión activa
terraform --version

URL: https://github.com/tfutils/tfenv

# 1. Fork el repositorio en GitHub
# 2. Clonar tu fork
git clone https://github.com/TU_USUARIO/terraform-aws-modules-vpc.git

# 3. Crear una rama para tu contribución
git checkout -b fix/subnet-calculation-edge-case

# 4. Hacer los cambios y añadir tests
# Los módulos de HashiCorp usan terratest (Go) para testing

# 5. Ejecutar los tests
cd test
go test -v -run TestVpcWithSubnets -timeout 30m

# 6. Crear el Pull Request con descripción clara

# El repositorio debe seguir el naming convention:
# terraform-<PROVIDER>-<NAME>
# Ejemplo: terraform-aws-mi-modulo-personalizado

# Estructura recomendada:
terraform-aws-mi-modulo/
├── main.tf          # Recursos principales
├── variables.tf     # Variables de entrada
├── outputs.tf       # Valores de salida
├── versions.tf      # Versiones requeridas
├── README.md        # Documentación (generada con terraform-docs)
├── examples/        # Ejemplos de uso
│   └── basic/
│       ├── main.tf
│       └── README.md
└── test/            # Tests automatizados
    └── mi_modulo_test.go

# Generar documentación automáticamente
brew install terraform-docs  # macOS

# Generar README desde las variables y outputs del módulo
terraform-docs markdown table . > README.md

Semana 1-2: Repasar conceptos fundamentales
  - Completar la ruta de tutoriales "Get Started" para al menos un cloud
  - Leer la documentación oficial del CLI

Semana 3: Módulos y estado
  - Tutoriales de módulos en developer.hashicorp.com
  - Practicar state management (backends, workspaces)

Semana 4: Práctica y simulacros
  - Realizar proyectos prácticos completos
  - Hacer preguntas de práctica (disponibles en la web oficial y Udemy)
  - Revisar los dominios con menor puntuación

Recursos de preparación:
  - Study Guide oficial: developer.hashicorp.com/terraform/tutorials/certification-003
  - Sample questions: hashicorp.com/certification/terraform-associate
  - Cursos de práctica: Udemy, A Cloud Guru, Pluralsight

│ Error: Unsupported argument
│
│   on main.tf line 5, in resource "aws_s3_bucket" "app":
│    5:   versioning {
│
│ Blocks of type "versioning" are not expected here.

# main.tf - Solución completa basada en la documentación actual (AWS provider v5+)

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
    random = {
      source  = "hashicorp/random"
      version = "~> 3.0"
    }
  }
}

provider "aws" {
  region = "us-east-1"
}

# Sufijo aleatorio para nombre único
# Encontrado en: registry.terraform.io/providers/hashicorp/random/latest/docs/resources/string
resource "random_string" "bucket_suffix" {
  length  = 8
  special = false
  upper   = false
}

# Bucket S3 base (en v4+ muchos argumentos se movieron a recursos separados)
# Referencia: registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket
resource "aws_s3_bucket" "app" {
  bucket = "mi-aplicacion-${random_string.bucket_suffix.result}"

  tags = {
    Project     = "mi-aplicacion"
    Environment = "prod"
    ManagedBy   = "Terraform"
  }
}

# Versionado en su propio recurso (separado en provider v4+)
# Referencia: registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_versioning
resource "aws_s3_bucket_versioning" "app" {
  bucket = aws_s3_bucket.app.id  # Referencia al bucket creado arriba

  versioning_configuration {
    status = "Enabled"  # Opciones: Enabled, Suspended, Disabled
  }
}

# Bloqueo de acceso público en su propio recurso
# Referencia: registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/s3_bucket_public_access_block
resource "aws_s3_bucket_public_access_block" "app" {
  bucket = aws_s3_bucket.app.id

  block_public_acls       = true  # Bloquea ACLs públicos nuevos y existentes
  block_public_policy     = true  # Bloquea políticas de bucket que permitan acceso público
  ignore_public_acls      = true  # Ignora ACLs públicos al evaluar el acceso
  restrict_public_buckets = true  # Restringe el acceso público aunque haya políticas que lo permitan
}

# Outputs útiles
output "bucket_name" {
  value       = aws_s3_bucket.app.bucket
  description = "Nombre del bucket S3 creado"
}

output "bucket_arn" {
  value       = aws_s3_bucket.app.arn
  description = "ARN del bucket S3 para usar en políticas IAM"
}

Paso 1: Lee el mensaje de error completo
└── ¿El error menciona un archivo/línea específica?
    ├── SÍ → Ve directamente al código indicado
    └── NO → Copia el tipo de error y búscalo

Paso 2: Busca en la documentación oficial
└── registry.terraform.io/providers/<provider>/latest/docs/resources/<recurso>
    ├── ¿El argumento existe en la versión actual?
    ├── ¿Ha cambiado en versiones recientes? (ver guías de migración)
    └── ¿El tipo de valor es correcto?

Paso 3: Busca en Stack Overflow
└── Búsqueda: [terraform] "<mensaje de error exacto entre comillas>"
    ├── ¿Hay una respuesta aceptada?
    └── ¿La respuesta es para la misma versión del provider?

Paso 4: Busca en GitHub Issues del provider
└── github.com/hashicorp/terraform-provider-<nombre>/issues?q=<error>
    ├── ¿Es un bug conocido?
    └── ¿Hay un workaround en los comentarios?

Paso 5: Busca en HashiCorp Discuss
└── discuss.hashicorp.com → buscar el error

Paso 6: Activa TF_LOG=DEBUG y analiza los logs
└── ¿El problema es de autenticación, permisos o parámetros?

Paso 7: Si nada funciona, publica tu pregunta
└── Con: versión, código mínimo, error completo, lo que intentaste
    ├── HashiCorp Discuss (recomendado para bugs/comportamiento)
    └── Stack Overflow (recomendado para preguntas de configuración)