Kit de Herramientas de Infraestructura como Código

# Kit de Herramientas de Infraestructura como Código — Guía de Uso

## Qué Hace Este Plugin

El Kit de Herramientas de Infraestructura como Código conecta tres habilidades para cubrir el ciclo de vida completo de despliegue en la nube: aprovisiona infraestructura con Terraform, empaqueta tu aplicación con Helm y despliégala en Kubernetes. Úsalo para pasar de cero a un entorno de producción en ejecución sin salir de tu asistente de IA.

---

## Ejemplo de Flujo de Trabajo Completo

**Escenario:** Desplegar una API de Node.js en AWS EKS.

**Paso 1 — Aprovisionar Infraestructura en la Nube** (`wshobson-terraform-module-library`)
```
Crear un módulo de Terraform para el clúster de AWS EKS:
- Región: us-east-1
- Grupo de nodos: 3x t3.medium
- VPC con subredes privadas
- Habilitar autoscaler del clúster

Ejecutar: terraform init → terraform plan → terraform apply
```
Resultado: Archivos del módulo de Terraform (`main.tf`, `variables.tf`, `outputs.tf`) con el clúster EKS, grupo de nodos y red configurados. El plan muestra ~12 recursos para crear. Apply aprovisiona el clúster en ~15 minutos.

**Paso 2 — Empaquetar la Aplicación** (`wshobson-helm-chart-scaffolding`)
```
Crear un chart de Helm para my-node-api:
- Imagen: my-registry/node-api:v1.2.0
- Réplicas: 2
- Puerto: 3000
- Verificación de salud: /health
- ConfigMap para variables de entorno
- HorizontalPodAutoscaler: 2-10 réplicas al 70% de CPU
```
Resultado: Chart de Helm completo con `Chart.yaml`, `values.yaml`, `templates/deployment.yaml`, `templates/service.yaml`, `templates/hpa.yaml` y `templates/configmap.yaml`. Incluye un script `validate-chart.sh` para lintear antes del despliegue.

**Paso 3 — Desplegar en Kubernetes** (`wshobson-k8s-manifest-generator`)
```
Generar manifiestos de K8s para desplegar my-node-api en el clúster EKS:
- Namespace: production
- Deployment: 2 réplicas, límites de recursos 256Mi/500m
- Service: ClusterIP en el puerto 80
- ConfigMap: LOG_LEVEL=info, NODE_ENV=production
- Secret: DATABASE_URL desde Secrets Manager
```
Resultado: `deployment.yaml`, `service.yaml`, `configmap.yaml`, `secret.yaml` listos para `kubectl apply -f`.

---

## Alcance y Límites

**Este kit de herramientas requiere:**
- Herramientas CLI instaladas localmente: `terraform` (>=1.0), `helm` (>=3.0), `kubectl` configurado con tu clúster
- Credenciales de la nube configuradas (AWS CLI, autenticación GCP, etc.) para que Terraform pueda aplicar
- Un clúster de Kubernetes existente o uno aprovisionado en el Paso 1

**Este kit de herramientas NO:**
- Ejecuta `terraform apply` o `kubectl apply` por ti — genera los archivos, tú ejecutas los comandos
- Reemplaza un pipeline completo de CI/CD (GitHub Actions, ArgoCD, FluxCD) — usa esos para despliegues automatizados
- Gestiona actualizaciones de clúster, rotación de certificados o rotación de secrets
- Funciona con plataformas propietarias (Heroku, Railway, Render) — está orientado a K8s/Terraform estándar

---

## Recuperación de Fallos

**Terraform: Proveedor no configurado**
Error: `No valid credential sources found`. Solución: Ejecuta `aws configure` (o equivalente para tu nube) antes de `terraform init`. Verifica con `terraform plan` — mostrará el error de autenticación antes de tocar cualquier recurso.

**Terraform: Permiso denegado**
Error: `AccessDenied` durante apply. El rol de IAM/cuenta de servicio no tiene los permisos requeridos. Verifica el error para la acción específica (ej., `eks:CreateCluster`). Agrega el permiso faltante a tu política de IAM, luego vuelve a ejecutar `terraform apply` — Terraform solo creará los recursos restantes.

**Helm: Falla la validación del chart**
Ejecuta `helm lint ./my-chart` para ver los errores específicos. Causas comunes: valores requeridos faltantes en `values.yaml`, indentación YAML inválida en plantillas. Corrige la línea reportada, luego vuelve a ejecutar lint antes de desplegar.

**Helm: Release ya existe**
Error: `cannot re-use a name that is still in use`. Usa `helm upgrade my-release ./my-chart` en lugar de `helm install`, o agrega las opciones `--create-namespace --replace`.

**kubectl: Clúster inalcanzable**
Error: `Unable to connect to the server`. Solución: Ejecuta `kubectl config get-contexts` para verificar que el clúster correcto esté seleccionado. Para EKS: `aws eks update-kubeconfig --name <cluster-name> --region <region>` para actualizar las credenciales.

**Pod CrashLoopBackOff después del despliegue**
Ejecuta `kubectl logs <pod-name> -n production` para ver los errores de la aplicación. Verifica que todas las claves de ConfigMap y referencias a Secret en el manifiesto coincidan con lo que la aplicación espera. Corrige el manifiesto y vuelve a aplicar.