Backup Snapshot su Dropbox

Aggiornamento 15/01/2019

Questo addon presente in Hassio consente di salvare gli snapshot (istantanea di Home Assistant completa di file e configurazione degli addon installati) su un account Dropbox, in questo modo metteremo al sicuro la configurazione di Home Assistant e sempre disponibile in caso di guasto dell’hardware o di errori di compilazione. I caricamenti vengono attivati ​​tramite una chiamata di servizio, facilitando l’automatizzazione di backup periodici o l’attivazione di caricamenti su Dropbox tramite script, proprio come viene fatto con qualsiasi altro servizio di Home Assistant.

Questo componente aggiuntivo utilizza lo script bash di Dropbox-Uploader per caricare i file su Dropbox. Richiede la generazione di un token di accesso tramite l’interfaccia utente Web Dropbox, che deve essere aggiunta alla configurazione del component.

Dropbox Sync caricherà tutti i file di snapshot (in particolare tutti i file .tar ) nella directory Hass.io /backup su un percorso specificato in Dropbox. Questo percorso target viene specificato tramite l’opzione di output . Una volta avviato il componente aggiuntivo, sarà in attesa di una chiamate di servizio.

Per eseguire in automatico il tutto, Home Assistant deve avere il sensore time_date già installato lo potete trovare su https://www.home-assistant.io/components/sensor.time_date/

1.   INSTALLAZIONE ADDON DROPBOX SYNC

Per aggiungere nuovi add-on andiamo su Hassio/Add-on Store e scriviamo sulla casella vuota dove c’è scritto Add new repository by URL inseriamo il seguente indirizzo:

https://github.com/danielwelch/hassio-addons

Installate poi l’addon dandogli install

Il pannello di configurazione si presenterà in questo modo

L’addon va configurato in questo modo:

dove:
<YOUR_ACCESS_TOKEN>  sarà il token che ci fornirà Dropbox
/hassioBackup  sarà la cartella di destinazione in Dropbox
keep_last  se impostato eliminerà i vecchi snapshot presenti in locale lasciando solo gli ultimi 3 dopo averli caricati in Dropbox

 

2. DROPBOX: Creazione Token

Per accedere al tuo Dropobox personale, questo componente aggiuntivo richiede un token di accesso. Vediamo ora i passaggi per crearlo:

Andiamo su  https://www.dropbox.com/developers/apps

 

 

Fare clic sul pulsante Crea app

Impostate come nell’immagine, nel punto 3 date un nome che volete

In questa pagina nella sezione OAuth 2 basterà premere il tasto Generate per creare il token

Il token che avete generato va inserito nella configurazione dell’addon Dropbox Sync

 

3. PACKAGE PER HOME ASSISTANT

Creare un file di nome pkg_dropbox.yaml o copiatevi quello presente in questo file pkg_dropbox_v1_2.zip e mettetelo nella cartella dei package, se non l’avete ancora configurata date uno sguardo all’articolo Package Configurazione, poi riavviate Home Assistant.

Con questo package si potrà selezionare queste opzioni:
– l’ora del backup
– la frequenza con cui eseguirlo:
tutti i giorni,
il lun, Mer e Ven,
il lun e ven,
il sabato,
la domenica
mai.

In aggiunta ci sarà un sensore di conferma avvenuto backup e una notifica Telegram.
Fate attenzione alle righe 132 e 196   - service: notify.telegram  viene richiamato il servizio di notifica con il nome telegram  il quale dovrà essere lo stesso che avete impostato nel file configuration.yaml sotto notify:  alla voce name:  come riportato nell’esempio qui sotto:

 

5. SINCRONIZZAZIONE CON IFTTT

Questa parte ci permetterà di conoscere o meno se il backup su DropBox è andato a buon fine, quindi è del tutto facoltativa non influenza sul funzionamento del backup. IFTTT ad ogni nuovo file di backup andrà a comunicarlo ad Home Assistant mediante l’impostazione di un boolean.
Per chi ancora non conoscesse IFTTT o non l’abbia ancora configurata segua la Guida Integrazione IFTTT

Andiamo nel sito https://ifttt.com/ e creiamo una nuova applet

Cerchiamo il servizio dropbox e selezioniamolo	premiamo su connetti
inseriamo le credenziali di dropbox	connettiamo il servizio IFTTT a DropBox
comparirà la scelta del trigger e selezioniamo la prima New file in your folder	scriviamo /hassioBackup che dovrà essere la stessa che abbiamo inserito dell’addon Dropbox Sync di Hassio
premiamo su +thath per selezionare l’azione da compiere da parte di IFTTT	cerchiamo i servizio webhooks e selezioniamolo
e selezioniamo l’unica opzione che ci propone

LE API_PASSWORD SONO ORA DEPRECATE!!!!

Inseriamo i seguenti dati:
URL: https://ilmiodominio.duckdns.org:8123/api/services/input_boolean/turn_on?api_password=api_pw
– dove avremmo da inserire il proprio dominio (con o senza porta finale)
– e come api_pw la password che avete impostato su Home Assistant nel file configuration.yaml nella dichiarazione htpp: alla voce api_password
Method: POST
Conect Type: application/json
Body: {"entity_id": "input_boolean.dropbox_sync_completed"}   Fate molta attenzione al tipo di virgolette che usate, ad HA non vanno bene quelle rovesciate  “xx”  ma quelle dritte "xx" , queta è una regola generale non solo per IFTTT.

Salvate ora la vostra applet e se volete dategli un nome.

 

4. LOVELACE

Di seguito vi lascio anche la configurazione di Lovelace per questo package, lo potrete inserire sia nella versione yaml o quella grafica facendo delle piccole modifiche sugli spazi antecedenti al codice. Se non conoscete ancora Lovelace leggete la guida su Lovelace