CLI avanzado: import, logging y debugging

# Ejemplo completo: importar una VPC existente

# Paso 1: Obtener el ID de la VPC desde AWS
# aws ec2 describe-vpcs --query 'Vpcs[?Tags[?Key==`Name`&&Value==`legacy-vpc`]].VpcId'
# Output: "vpc-0abc123def456"

# Paso 2: Crear el bloque resource (mínimo requerido)
# main.tf:
resource "aws_vpc" "legacy" {
  cidr_block = "172.16.0.0/16"  # valor real — obtén de la consola
}

# Paso 3: Importar
terraform import aws_vpc.legacy vpc-0abc123def456

# Paso 4: Ver el plan
terraform plan
# ~ aws_vpc.legacy  (modificar porque faltan atributos)

# Paso 5: Actualizar el código con todos los atributos
resource "aws_vpc" "legacy" {
  cidr_block           = "172.16.0.0/16"
  enable_dns_support   = true     # ajustar según plan
  enable_dns_hostnames = true
  tags = {
    Name = "legacy-vpc"
  }
}

# Repetir plan hasta ver: "No changes. Your infrastructure matches the configuration."

# ALTERNATIVA: import block + generate-config (Terraform 1.5+)
import {
  to = aws_vpc.legacy
  id = "vpc-0abc123def456"
}

terraform plan -generate-config-out=vpc_legacy.tf  # genera el bloque resource automáticamente

# Habilitar logging en la sesión actual
export TF_LOG=DEBUG
terraform plan

# Guardar logs en un archivo (sin esto, van a stderr)
export TF_LOG=TRACE
export TF_LOG_PATH=/tmp/terraform-debug.log
terraform apply

# Separar logs del Core y del Provider (Terraform 0.15+)
export TF_LOG_CORE=INFO       # logs del núcleo de Terraform
export TF_LOG_PROVIDER=DEBUG  # logs del provider (llamadas a AWS API, etc.)

# Desactivar logging
unset TF_LOG
# O:
export TF_LOG=OFF

# Windows PowerShell:
$env:TF_LOG = "DEBUG"
$env:TF_LOG_PATH = "C:\temp\tf-debug.log"
terraform plan

# Error típico cuando el estado está bloqueado:
# Error acquiring the state lock: ConditionalCheckFailedException: ...
# Lock Info:
#   ID:        3a1c2fa8-b5d9-4f71-a3c7-123456789abc  ← este es el Lock ID
#   Path:      terraform.tfstate
#   Operation: OperationTypeApply
#   Who:       user@hostname
#   Version:   1.6.3
#   Created:   2024-01-15 10:23:45 UTC
#   Info:

# Liberar el lock con el ID mostrado en el error
terraform force-unlock 3a1c2fa8-b5d9-4f71-a3c7-123456789abc

# Confirmar con -force (omite la confirmación interactiva)
terraform force-unlock -force 3a1c2fa8-b5d9-4f71-a3c7-123456789abc

# Valor por defecto: 10 operaciones concurrentes
terraform apply

# Aumentar el paralelismo (más rápido pero más carga en la API)
terraform apply -parallelism=20

# Reducir el paralelismo (útil si la API de la nube tiene rate limiting)
terraform apply -parallelism=5

# El mismo flag funciona con plan y destroy
terraform plan -parallelism=15
terraform destroy -parallelism=5

# ⚠️ Aumentar mucho puede causar errores de throttling en las APIs cloud
# AWS, Azure y GCP tienen límites de rate en sus APIs