Deploy Ha

HA-Integration deployen und verifizieren

Umgebung: Lokaler Kind-Cluster (Kubernetes in Docker), Skaffold-managed. HA laeuft als StatefulSet homeassistant-0 im Namespace default.

Schritt 1: Pre-Flight Check

Pruefe ob der HA-Pod laeuft:

kubectl get pod homeassistant-0 -n default -o jsonpath='{.status.phase}' 2>&1; echo ""

Falls der Pod nicht existiert oder nicht "Running" ist, melde den Fehler und brich ab.

Schritt 2: Lint-Check

Fuehre Ruff auf dem HA-Code aus:

ruff check custom_components/kamerplanter/ 2>&1; echo "EXIT:$?"

ruff format --check custom_components/kamerplanter/ 2>&1; echo "EXIT:$?"

Falls Lint-Fehler: behebe sie automatisch, dann weiter.

Schritt 3: Deploy (3-Schritt-Verfahren)

Fuehre die folgenden 3 Befehle sequentiell aus:

3a. Dateien kopieren

kubectl cp custom_components/kamerplanter/ default/homeassistant-0:/config/custom_components/kamerplanter/ 2>&1; echo "EXIT:$?"

3b. Bytecode-Cache loeschen (PFLICHT)

kubectl exec homeassistant-0 -n default -- rm -rf /config/custom_components/kamerplanter/__pycache__ 2>&1; echo "EXIT:$?"

3c. HA-Prozess neustarten (NICHT den Pod loeschen!)

WICHTIG: kubectl delete pod ist VERBOTEN fuer Hot-Reload! Der InitContainer copy-ha-integration wuerde die manuell kopierten Dateien mit dem alten Image ueberschreiben. Stattdessen: HA-Prozess im Container beenden → Kubernetes startet nur den Container neu (nicht den Pod) → InitContainers laufen NICHT erneut.

kubectl exec homeassistant-0 -n default -- kill 1 2>&1; echo "EXIT:$?"

Schritt 4: Warten auf Container-Ready

Warte bis der Container wieder laeuft (max 120s). Der Pod bleibt bestehen, nur der Container restartet:

kubectl wait --for=condition=ready pod/homeassistant-0 -n default --timeout=120s 2>&1; echo "EXIT:$?"

Schritt 5: Log-Verifizierung

Pruefe die HA-Logs auf Kamerplanter-bezogene Eintraege:

kubectl logs homeassistant-0 -n default --since=90s 2>&1 | grep -iE "(kamerplanter|custom_components)" | tail -30

Zusaetzlich pruefe auf allgemeine Fehler beim Start:

kubectl logs homeassistant-0 -n default --since=90s 2>&1 | grep -iE "(error|exception|traceback)" | grep -v "template" | tail -20

Schritt 6: Ergebnis melden

Stelle das Ergebnis in folgender Form dar:

| Schritt            | Status     | Details                        |
|--------------------|------------|--------------------------------|
| Lint               | Pass/Fail  | {details}                      |
| Copy               | Pass/Fail  | kubectl cp                     |
| Cache Clear        | Pass/Fail  | __pycache__ entfernt           |
| HA Restart         | Pass/Fail  | kill 1 (Container-Restart)     |
| Container Ready    | Pass/Fail  | {time} bis Ready               |
| Integration Loaded | Pass/Fail  | Setup-Log-Eintraege            |
| Errors             | Pass/Fail  | {n} Fehler in Logs             |

Bei Fehlern:

• Zeige die relevanten Log-Zeilen an
• Analysiere ob es ein Code-Fehler, Config-Problem oder Netzwerk-Issue ist
• Schlage einen konkreten Fix vor
• Frage ob der Fix angewendet und erneut deployed werden soll

Bei Erfolg:

• Melde "HA-Integration erfolgreich deployed und gestartet"
• Zeige die geladenen Entities/Platforms falls in den Logs sichtbar

Source: nolte/kamerplanter — distributed by TomeVault.