# Deploy Ha

> Deployed die HA-Integration in den lokalen Kubernetes-Cluster (kubectl cp + Cache-Clear + Pod-Restart), prueft die HA-Logs auf erfolgreichen Start und meldet Fehler. Nutze diesen Skill nach Aenderungen an custom_components/kamerplanter/ um die Integration schnell zu testen. Use when this capability is needed.

- Skill: `tomevault-io/deploy-ha` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/deploy-ha`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/deploy-ha/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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:

```bash
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:

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

```bash
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

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

### 3b. Bytecode-Cache loeschen (PFLICHT)

```bash
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.

```bash
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:

```bash
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:

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

Zusaetzlich pruefe auf allgemeine Fehler beim Start:

```bash
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:

```markdown
| 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](https://github.com/nolte/kamerplanter) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-04 -->