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:
- verifica il pacchetto con le chiavi della release installata – prima di usare qualsiasi cosa al suo interno,
- salva un dump del database in
backups/(si tengono gli ultimi tre backup di prima di un aggiornamento, il numero si imposta conDRAFTEN_BACKUPSin.env; i backup giornalieri si contano separatamente, vedi Backup e ripristino), - esegue le migrazioni del database,
- sostituisce i worker,
- avvia la nuova versione del web accanto a quella che serve, e passa a quella nuova quando è sana,
- 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
- Impostazioni, istruzioni e fonti degli assistenti sono nel database, e un aggiornamento non le tocca.
- Il client secret di una registrazione Entra scade secondo la durata per cui l’hai emesso; rinnovalo nell’interfaccia (Organizzazione → Login e accesso alla posta → Registrazioni per caselle condivise e gestione centrale → Nuovo segreto), non con un aggiornamento.
- Il certificato HTTPS lo rinnovi tu:
./draften certificate new.pem new.key.