Per gli amministratori
← Tutti gli argomenti

Aggiornare dalla riga di comando

./draften update senza interruzioni, la verifica di un pacchetto, il ritorno alla versione precedente o a una più vecchia e un server senza internet.

Quando nell’installazione gira l’updater, aggiornare dall’interfaccia è la cosa più comoda – lo descrive Aggiornare con l’updater. Qui trovi la stessa procedura dalla riga di comando; funziona sempre, con l’updater o senza. Tutti i comandi si eseguono nella cartella dell’installazione.

Aggiornare a una nuova versione

Ogni release è un nuovo pacchetto. Puoi passarlo direttamente al comando:

./draften update --bundle /percorso/di/draften-<nuova versione>.tar

oppure copiarlo nella cartella updates/ ed eseguire:

./draften update <nuova versione>

Durante l’aggiornamento il web passa alla nuova versione senza interruzioni. L’aggiornamento procede passo per passo:

  1. verifica il pacchetto con le chiavi della release installata – prima di usare qualsiasi cosa al suo interno,
  2. salva un dump del database in backups/ (si tengono gli ultimi tre backup di prima di un aggiornamento, il numero si imposta con DRAFTEN_BACKUPS in .env; i backup giornalieri si contano separatamente, vedi Backup e ripristino),
  3. esegue le migrazioni del database,
  4. sostituisce i worker,
  5. avvia la nuova versione del web accanto a quella che serve, e passa a quella nuova quando è sana,
  6. sostituisce i container degli altri servizi (proxy, cloudflared, updater) la cui immagine cambia con la nuova release; gli altri restano in esecuzione. Il database non lo sostituisce mai.

Se la nuova versione non diventa sana, non si cambia nulla e quella precedente continua a servire.

Quando una release cambia l’immagine di proxy o di cloudflared, la connessione si interrompe per un momento durante la sostituzione: per proxy da una frazione di secondo a qualche secondo, per Cloudflare Tunnel per qualche secondo. Lo indicano le note di rilascio, e nell’output di ./draften update lo annuncia la riga proxy: new image … - recreating it (a short gap).

Un PROXY_IMAGE o CLOUDFLARED_IMAGE proprio in .env ha la precedenza sulla versione che porta la release. L’aggiornamento non lo modifica, quindi non ricevi né la nuova versione di proxy o di cloudflared né le sue correzioni di sicurezza. Ti consigliamo di eliminare la riga da .env; allora vale la versione della release.

Un pacchetto si può anche verificare senza installarlo:

./draften check draften-<nuova versione>.tar

Dopo l’aggiornamento

./draften status

mostra quale colore web serve, la versione e lo stato di entrambi i colori e dei worker, lo stato dell’HTTPS e i dump del database. Nella pagina Gestione i worker si fanno vivi e il giudizio è “la capacità basta”. Cosa ha cambiato la release lo trovi nel file NOTES.md.

Tornare alla versione precedente

La versione che serviva prima dell’aggiornamento resta in esecuzione senza traffico. Ci torni immediatamente:

./draften rollback

Funziona perché il database resta leggibile anche per la versione precedente.

Tornare a una versione ancora più vecchia

Si passa solo dal ripristino di un dump del database. Ogni dump in backups/ porta nel nome la versione che era in esecuzione quando è stato creato (<ora>-<versione>.sql.gz prima di un aggiornamento, <ora>-<versione>.backup.sql.gz giornaliero e su richiesta):

docker compose stop worker
gunzip -c backups/<dump>.sql.gz | docker compose exec -T db sh -c 'mariadb -uroot -p"$MARIADB_ROOT_PASSWORD"'
./draften update <versione> --no-backup

Tutto ciò che è successo in draften dopo la creazione del dump va perso.

Un dump di prima della sostituzione della chiave di cifratura si apre solo con la chiave precedente, MASTER_KEY_PREVIOUS in .env. Vedi Backup e ripristino.

Una macchina senza internet

L’updater scarica le nuove release con la chiave della licenza. Una macchina senza internet non scarica nulla: copia il pacchetto in updates/ e aggiorna con ./draften update <versione> – oppure l’updater te lo propone da lì nell’interfaccia.

Cosa non cambia da solo

Versione solo testo