💻 Remote Development: VS Code & Home Assistant

Obiettivo: Configurare un ambiente di sviluppo professionale sulla workstation locale per gestire la configurazione remota di Home Assistant.

::: info Lavorare in remoto con VS Code permette di utilizzare funzionalità avanzate come il Linting (controllo errori in tempo reale), l’Autocomplete delle entità e la gestione dei file tramite Git, mantenendo la potenza di calcolo sulla macchina di sviluppo e i file sulla VM Proxmox. :::

1. Prerequisiti su Home Assistant

Per permettere a VS Code di connettersi, dobbiamo aprire un canale SSH sicuro.

1. Installa l’Add-on Advanced SSH & Web Terminal (da HACS o dallo store ufficiale).
2. Configura l’Add-on:
   • Imposta una password robusta o (scelta consigliata) aggiungi la tua chiave SSH pubblica (ED25519).
   • Assicurati che la porta 22 (o una porta custom come 2222) sia aperta e configurata.
   • Disabilita sftp se preferisci usare solo il protocollo SSH puro.

2. Configurazione su VS Code (Workstation)

Sulla tua macchina di sviluppo (Windows/Linux/Mac), procedi come segue:

A. Estensioni Necessarie

Installa le seguenti estensioni dal Marketplace di VS Code:

1. Remote - SSH: Per connettersi al filesystem della VM.
2. Home Assistant Config Help: Fornisce l’autocompletamento per le entità e la validazione dello schema YAML.

B. Connessione SSH

1. Premi F1 e digita Remote-SSH: Connect to Host....
2. Configura il file di config SSH locale:

   Host homeassistant-server
       HostName 192.168.1.XXX  # IP della VM HA
       User root
       Port 22
       IdentityFile ~/.ssh/id_ed25519
   

3. Connettiti e apri la cartella /config.

3. Ottimizzazione: Linting & Autocomplete

Per fare in modo che VS Code riconosca le tue luci, sensori e script, dobbiamo collegare l’estensione alle API di Home Assistant.

1. In Home Assistant: Vai sul tuo Profilo -> Long-Lived Access Tokens.
2. Genera un nuovo token chiamato VSCode-Remote.
3. In VS Code: Vai nelle impostazioni dell’estensione “Home Assistant” e inserisci:
   • Host URL: http://192.168.1.XXX:8123
   • Access Token: (Il token appena generato)
   • Certificato: Disabilita la verifica SSL se usi un IP locale senza HTTPS valido internamente.

📉 Workflow di Sviluppo (Mermaid)

graph LR
    subgraph Workstation_Locale
        VSC[VS Code IDE]
        EXT[HA Extension]
    end

    subgraph Proxmox_VM
        HA[Home Assistant OS]
        SSH[SSH Add-on]
        CONF[/config/*.yaml]
    end

    VSC -- "Remote-SSH (Filesystem)" --> SSH
    SSH <--> CONF
    EXT -- "REST/WS API (Entities/Linting)" --> HA

🛠️ Vantaggi dell’Ingegnere (Reasoning)

1. Validazione Sintattica: VS Code sottolineerà in rosso se dimentichi un’indentazione o se scrivi male un servizio, evitando di dover riavviare HA e scoprire l’errore dai log.
2. Snippets: Possibilità di creare template personalizzati per automazioni ripetitive.
3. Git Integration: Puoi inizializzare un repository Git nella cartella /config e pushare le modifiche su un server privato (Gitea/GitHub), garantendo un versionamento reale di tutta la tua domotica.

Tags: #HomeAssistant #VSCode #RemoteDevelopment #YAML #Linting*