Infrastructure-as-Code-Toolkit

# Infrastructure as Code Toolkit — Benutzerhandbuch

## Was dieses Plugin macht

Infrastructure as Code Toolkit verbindet drei Skills, um den gesamten Cloud-Deployment-Lebenszyklus abzudecken: Infrastruktur mit Terraform provisionieren, Anwendungen mit Helm verpacken und auf Kubernetes deployen. Nutzen Sie es, um von null bis zur produktionsbereiten Umgebung zu kommen, ohne Ihre KI-Assistent zu verlassen.

---

## Vollständiges Workflow-Beispiel

**Szenario:** Deploy einer Node.js-API auf AWS EKS.

**Schritt 1 – Cloud-Infrastruktur provisionieren** (`wshobson-terraform-module-library`)
```
Create a Terraform module for AWS EKS cluster:
- Region: us-east-1
- Node group: 3x t3.medium
- VPC with private subnets
- Enable cluster autoscaler

Run: terraform init → terraform plan → terraform apply
```
Output: Terraform-Moduldateien (`main.tf`, `variables.tf`, `outputs.tf`) mit dem konfigurierten EKS-Cluster, Node-Group und Networking. Der Plan zeigt ca. 12 zu erstellende Ressourcen. Apply provisioniert den Cluster in ca. 15 Minuten.

**Schritt 2 – Anwendung verpacken** (`wshobson-helm-chart-scaffolding`)
```
Create a Helm chart for my-node-api:
- Image: my-registry/node-api:v1.2.0
- Replicas: 2
- Port: 3000
- Health check: /health
- ConfigMap for environment variables
- HorizontalPodAutoscaler: 2-10 replicas at 70% CPU
```
Output: Vollständiges Helm-Chart mit `Chart.yaml`, `values.yaml`, `templates/deployment.yaml`, `templates/service.yaml`, `templates/hpa.yaml` und `templates/configmap.yaml`. Enthält ein `validate-chart.sh`-Skript zum Linten vor dem Deployment.

**Schritt 3 – Auf Kubernetes deployen** (`wshobson-k8s-manifest-generator`)
```
Generate K8s manifests to deploy my-node-api to the EKS cluster:
- Namespace: production
- Deployment: 2 replicas, resource limits 256Mi/500m
- Service: ClusterIP on port 80
- ConfigMap: LOG_LEVEL=info, NODE_ENV=production
- Secret: DATABASE_URL from Secrets Manager
```
Output: `deployment.yaml`, `service.yaml`, `configmap.yaml`, `secret.yaml` bereit für `kubectl apply -f`.

---

## Umfang & Grenzen

**Dieses Toolkit benötigt:**
- Installierte lokale CLI-Tools: `terraform` (>=1.0), `helm` (>=3.0), `kubectl` konfiguriert für Ihren Cluster
- Konfigurierte Cloud-Credentials (AWS CLI, GCP-Auth, etc.) für Terraform Apply
- Einen bestehenden Kubernetes-Cluster oder einen in Schritt 1 provisionierten

**Dieses Toolkit tut NICHT:**
- `terraform apply` oder `kubectl apply` für Sie ausführen – es generiert die Dateien, Sie führen die Befehle aus
- Eine vollständige CI/CD-Pipeline ersetzen (GitHub Actions, ArgoCD, FluxCD) – nutzen Sie diese für automatisierte Deploys
- Cluster-Upgrades, Zertifikatsrotation oder Secret-Rotation verwalten
- Mit proprietären Plattformen arbeiten (Heroku, Railway, Render) – es zielt auf standardmäßiges K8s/Terraform

---

## Fehlerbehebung

**Terraform: Provider nicht konfiguriert**
Error: `No valid credential sources found`. Fix: Führen Sie `aws configure` (oder Entsprechendes für Ihre Cloud) vor `terraform init` aus. Verifizieren Sie mit `terraform plan` – es zeigt den Auth-Fehler, bevor Ressourcen berührt werden.

**Terraform: Zugriff verweigert**
Error: `AccessDenied` während Apply. Die IAM-Rolle/Service-Account fehlt die erforderlichen Berechtigungen. Prüfen Sie den Fehler auf die spezifische Aktion (z.B. `eks:CreateCluster`). Fügen Sie die fehlende Berechtigung zu Ihrer IAM-Policy hinzu, dann führen Sie erneut `terraform apply` aus – Terraform erstellt nur die verbleibenden Ressourcen.

**Helm: Chart-Validierung schlägt fehl**
Führen Sie `helm lint ./my-chart` aus, um spezifische Fehler zu sehen. Häufige Ursachen: fehlende erforderliche Werte in `values.yaml`, ungültige YAML-Einrückung in Templates. Beheben Sie die gemeldete Zeile, dann linten Sie erneut vor dem Deployment.

**Helm: Release existiert bereits**
Error: `cannot re-use a name that is still in use`. Nutzen Sie `helm upgrade my-release ./my-chart` statt `helm install`, oder fügen Sie `--create-namespace --replace` Flags hinzu.

**kubectl: Cluster nicht erreichbar**
Error: `Unable to connect to the server`. Fix: Führen Sie `kubectl config get-contexts` aus, um zu verifizieren, dass der korrekte Cluster ausgewählt ist. Für EKS: `aws eks update-kubeconfig --name <cluster-name> --region <region>` um Credentials zu aktualisieren.

**Pod CrashLoopBackOff nach Deploy**
Führen Sie `kubectl logs <pod-name> -n production` aus, um Anwendungsfehler zu sehen. Prüfen Sie, ob alle ConfigMap-Keys und Secret-Referenzen im Manifest mit dem übereinstimmen, was die Anwendung erwartet. Beheben Sie das Manifest und wenden Sie es erneut an.