Newer
Older
homeassistant-infra / docs / DEPLOYMENT_SUCCESS.md

✅ Wdrożenie Solarman/Deye na PROD - Raport

Data wdrożenia: 2026-02-05

🎯 Cel

Wdrożenie integracji Solarman (Deye Solar Inverter) z TEST na PROD bez użycia SSH.

📋 Co zostało wdrożone

1. HACS (Home Assistant Community Store)

  • Rozmiar: 52 MB
  • Źródło: TEST VM (101)
  • Cel: PROD VM (100)
  • Status: ✅ Skopiowany

2. Solarman Integration

3. Konfiguracja

  • IP inwertera: 192.168.50.196
  • Tytuł: "Inverter DEYE"
  • Status: ✅ Skopiowana do core.config_entries

🛠️ Metoda wdrożenia

Bezpośredni dostęp do dysków VM przez Proxmox

# 1. Mapowanie partycji LVM
kpartx -av /dev/pve/vm-101-disk-0  # TEST
kpartx -av /dev/pve/vm-100-disk-0  # PROD

# 2. Montowanie partycji danych (p8)
mount /dev/mapper/pve-vm--101--disk--0p8 /mnt/haos-test
mount /dev/mapper/pve-vm--100--disk--0p8 /mnt/haos-prod

# 3. Kopiowanie
cp -r /mnt/haos-test/supervisor/homeassistant/custom_components/hacs \
      /mnt/haos-prod/supervisor/homeassistant/custom_components/

cp -r /mnt/haos-test/supervisor/homeassistant/custom_components/solarman \
      /mnt/haos-prod/supervisor/homeassistant/custom_components/

# 4. Modyfikacja .storage/core.config_entries
jq '.data.entries += [<solarman_config>]' core.config_entries

# 5. Odmontowanie i restart
umount /mnt/haos-*
kpartx -d /dev/pve/vm-*-disk-0
qm reboot 100

Dlaczego ta metoda?

❌ SSH addon nie był włączony na TEST i PROD
❌ HA API nie pozwala na instalację custom components
✅ Bezpośredni dostęp do filesystem przez Proxmox
✅ Pełna kontrola nad plikami
✅ Automatyzacja możliwa przez skrypty

📂 Struktura plików HAOS

/mnt/haos-*/supervisor/homeassistant/
├── .storage/
│   ├── core.config_entries      # Konfiguracje integracji
│   ├── core.device_registry     # Rejestr urządzeń
│   ├── core.entity_registry     # Rejestr encji
│   ├── hacs.data               # Dane HACS
│   └── hacs.repositories       # Repozytoria HACS
├── custom_components/
│   ├── hacs/                   # 52 MB
│   └── solarman/               # 1.7 MB
├── configuration.yaml
└── home-assistant_v2.db        # Baza danych

🚀 Zautomatyzowany skrypt

Stworzono skrypt: scripts/deploy-integration-offline.sh

Użycie:

# Domyślnie wdraża "solarman"
./scripts/deploy-integration-offline.sh

# Lub inna integracja
./scripts/deploy-integration-offline.sh <nazwa_integracji>

Co robi:

  1. ✅ Łączy się z Proxmox
  2. ✅ Mapuje i montuje dyski VM
  3. ✅ Kopiuje integrację + HACS
  4. ✅ Dodaje konfigurację do config_entries
  5. ✅ Odmontowuje dyski
  6. ✅ Restartuje PROD VM

✅ Weryfikacja

Po wdrożeniu sprawdź w PROD:

  1. Otwórz http://192.168.50.242:8123
  2. Przejdź do: Settings → Devices & Services
  3. Powinno być widoczne: "Inverter DEYE" (Solarman)
  4. Sprawdź czy wszystkie 203 encje są dostępne

📊 Encje Solarman/Deye

Główne kategorie:

  • Sensors (94): Energia, moc, napięcie, prąd, częstotliwość
  • Numbers (62): Ustawienia limitów, czasów, napięć
  • Selects (18): Tryby pracy (charge, discharge, grid)
  • Switches (15): Włączniki funkcji
  • Times (6): Harmonogramy ładowania
  • Binary Sensors (6): Statusy (błędy, ochrony)
  • Button (1): Reset liczników
  • Datetime (1): Czas systemowy

Przykładowe sensory:

  • Daily Production (kWh)
  • Total Production (kWh)
  • Battery SOC (%)
  • Battery SOH (%)
  • Grid Power (W)
  • PV Power (W)
  • Load Power (W)
  • Battery Voltage (V)
  • Battery Current (A)

🔧 Następne kroki

  1. Włącz SSH addon (opcjonalnie):

    • Settings → Add-ons → Terminal & SSH
    • Hasło: QWer!@34
    • Umożliwi synchronizację przez sync-test-to-prod.sh
  2. Skonfiguruj backup:

    crontab -e
    0 2 * * * /root/homeassistant-infra/scripts/backup-ha.sh
  3. Monitoruj działanie:

    • Sprawdzaj logi w HA
    • Monitoruj połączenie z inverterem (192.168.50.196)
    • Weryfikuj poprawność danych

📝 Uwagi

  • ⚠️ VM musi być wyłączona podczas bezpośredniego dostępu do dysków (możliwe również na żywo z ostrożnością)
  • ⚠️ Zawsze używaj sync przed odmontowaniem
  • ⚠️ Backup jest tworzony automatycznie przed każdą zmianą
  • ✅ Integracja działa identycznie jak w TEST
  • ✅ Wszystkie dane historyczne pozostają w TEST

🎉 Podsumowanie

Status: ✅ SUKCES

Integracja Solarman/Deye została wdrożona na PROD bez wykorzystania SSH, wykorzystując bezpośredni dostęp do filesystem przez Proxmox. Metoda ta jest:

  • Niezawodna
  • Automatyzowalna
  • Bezpieczna (backup przed zmianami)
  • Uniwersalna (działa dla każdej custom integration)

Wygenerowano automatycznie: 2026-02-05