Was macht terraform-skill?
Verwendung beim Schreiben, Überprüfen oder Debuggen von Terraform/OpenTofu-Modulen, -Tests, -CI, -Scans oder State-Operationen – Diagnose von Fehlermodi (Identitätsfluktuation, Secrets, Blast Radius, CI-Drift, State-Korruption) mit versionsbewussten Schutzmechanismen.
Übersicht
Diese Skill ist speziell für Entwickler konzipiert, die mit Terraform oder OpenTofu arbeiten. Sie hilft dabei, häufige Probleme zu identifizieren und zu beheben, bevor sie in Produktion gehen.
Hauptfunktionen
- Identitätsfluktuation erkennen: Findet Ressourcen, die bei jedem Plan eine neue Identität erhalten (z. B.
random_petohnekeepers). - Secrets aufspüren: Identifiziert hartcodierte Secrets in Modulen und empfiehlt den Einsatz von Vault, AWS Secrets Manager oder ähnlichen Diensten.
- Blast Radius minimieren: Analysiert Abhängigkeitsgraphen und schlägt Aufteilungen von Modulen vor, um die Auswirkungen von Änderungen zu begrenzen.
- CI-Drift beheben: Erkennt Abweichungen zwischen der aktuellen Infrastruktur und der Konfiguration in CI/CD-Pipelines.
- State-Korruption reparieren: Bietet Schritte zur Wiederherstellung eines beschädigten oder inkonsistenten Terraform State an.
- Versionskompatibilität prüfen: Stellt sicher, dass alle Konfigurationen und Module mit der verwendeten Version von Terraform oder OpenTofu kompatibel sind.
Verwendung
Als Teil eines Code-Reviews
# Beispiel: Analyse eines Moduls auf Identitätsfluktuation
tf-skill check --module ./modules/vpc --identity-churn
Beim Debuggen einer CI-Pipeline
# Beispiel: CI-Drift erkennen
tf-skill diagnose --ci-drift --plan-file plan.out
Bei State-Operationen
# Beispiel: State-Korruption prüfen
tf-skill state --inspect --state terraform.tfstate
Unterstützte Plattformen
- Claude Code: Kann als Tool in Claude Code konfiguriert werden, um Terraform-bezogene Fragen zu beantworten.
- Cursor: Als Cursor Rule nutzbar, um bei der Bearbeitung von Terraform-Dateien automatisch zu analysieren.
- Codex: Kann in Codex als Skill referenziert werden.
- Any AI agent: Grundsätzlich jeder AI-Agent, der über ein Skill-System verfügt, kann diese Skill nutzen.
Voraussetzungen
- Terraform oder OpenTofu muss installiert sein (Version >= 1.0 empfohlen).
- Für State-Operationen ist direkter Zugriff auf die State-Datei erforderlich.
- Für CI-Drift-Analysen muss der Plan als Datei exportiert werden (
terraform plan -out=plan.out).
Fehlerdiagnose-Modi
Die Skill unterscheidet zwischen verschiedenen Fehlermodi:
| Fehlermodus | Beschreibung | Beispiel-Prüfung |
|---|---|---|
| Identitätsfluktuation | Ressourcen, die bei jedem Plan eine neue ID erhalten | random_pet ohne keepers |
| Secrets | Hartcodierte Secrets oder unsichere Übergabe | Passwörter in Resource-Attributen |
| Blast Radius | Zu große Abhängigkeitsketten | Ein Modul, das die gesamte Infrastruktur definiert |
| CI-Drift | Abweichungen zwischen CI und State | Unterschiedliche Versionen von Modulen |
| State-Korruption | Beschädigte oder inkonsistente State-Dateien | Fehlende Ressourcen in der State-Datei |
Beispiele für Prompt-Vorlagen
- „Analysiere dieses Modul auf Identitätsfluktuation und gib einen Bericht über die betroffenen Ressourcen.“
- „Finde alle Secrets in dieser Konfiguration und schlage eine Lösung mit Vault oder AWS Secrets Manager vor.“
- „Überprüfe den State dieser Datei auf Korruption und gib Reparaturschritte an.“
- „Vergleiche diesen Plan mit dem aktuellen State und erkenne CI-Drift.“
- „Prüfe, ob alle Module kompatibel mit OpenTofu 1.6 sind.“
Lizenz
MIT
Mitwirken
Beiträge sind willkommen! Bitte öffne ein Issue oder einen Pull Request im GitHub-Repository.