Documentazione / Per iniziare
Aggiornamenti e backup
Aggiorna a una versione nuova, fai e ripristina il backup del database, controlla l'installazione.
Aggiornare
closeyourit update
Scarica prima i file della versione nuova (compose.yml, Caddyfile, le impostazioni della coda e il comando closeyourit stesso): se non esistono si ferma e non cambia niente. Poi fa un backup, scarica la versione nuova, aggiorna il database e riparte. Se le immagini della versione nuova non si scaricano, o non risponde entro 3 minuti, torna da sola alla versione e ai file di prima e ti dice quale backup ripristinare se serve. Il backup fatto prima dell'aggiornamento resta in backups/.
Tornare indietro cambia la versione dell'app, non il database: le modifiche che la versione nuova ha già fatto al database restano. Se dopo la versione vecchia si comporta male, ripristina il backup fatto prima dell'aggiornamento.
Per una versione precisa: closeyourit update 1.4.0.
Aggiornare dall'app
Quando esce una versione nuova, l'amministratore vede una striscia in alto su ogni pagina. In Amministrazione → Panoramica trova cosa cambia e il bottone Aggiorna ora. Dopo la conferma il server parte entro un minuto e fa lo stesso lavoro di closeyourit update: backup, versione nuova, ritorno indietro se non risponde. La pagina si ricarica da sola alla fine e mostra l'esito.
Dal bottone si va solo a versioni più nuove. Per tornare a una versione vecchia resta il terminale. Il log di ogni aggiornamento chiesto dall'app va in /var/log/closeyourit-update.log.
Le installazioni nuove hanno il bottone acceso. Su un server installato prima, accendilo una volta:
closeyourit update && closeyourit enable updates
Per spegnerlo: closeyourit disable updates. L'avviso resta, il bottone lascia il posto al comando da lanciare.
Cosa contiene il backup
Una copia del database principale si fa ogni notte alle 03:00. Le ultime 7 restano in /opt/closeyourit/backups/, leggibili solo da root; l'esito di ogni giro va in /var/log/closeyourit-backup.log.
| Cosa | Nel backup |
|---|---|
| Progetti, ticket, errori, log, metriche, visite | sì |
Le chiavi segrete in /opt/closeyourit/.env | no |
I file caricati (volume Docker closeyourit_storage) | no |
| Le richieste in attesa nella coda del gateway di ingest | no |
Le due che contano:
- Le chiavi segrete. Senza il
.envcon cui è stata fatta l'installazione, i dati cifrati di un backup non si possono leggere. Tieni una copia di.envfuori dal server. - I file caricati. Allegati e registrazioni delle sessioni sono file, non righe. O li tieni su S3 (
AWS_S3_BUCKET, vedi Impostazioni) o copi tu il volume.
Fare e ripristinare il backup
closeyourit backup # fa una copia adesso
closeyourit restore <file> # riporta il database a una copia
<file> è il nome di un file in /opt/closeyourit/backups/, per esempio closeyourit-20261003-030000.dump.
restore ferma l'app, cancella il database attuale, lo ricrea dalla copia e riavvia l'app. Tutto quello che è stato scritto dopo quella copia si perde. Prima di fare qualsiasi cosa ti chiede di scrivere restore.
Tenere una copia altrove
Una copia sullo stesso server non sopravvive alla perdita del server. Per mandare ogni copia anche su Amazon S3, imposta in /opt/closeyourit/.env:
BACKUP_S3_BUCKET=my-backups
AWS_REGION=eu-central-1
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...
Ogni copia va in s3://<bucket>/closeyourit/. Le copie su S3 CloseYourIt non le cancella: imposta una regola di scadenza sul bucket.
Spostarsi su un altro server
- Sul server vecchio:
closeyourit backup, poi copia in un posto sicuro il file più recente inbackups/e/opt/closeyourit/.env. - Sul server nuovo: installa la stessa versione (
CLOSEYOURIT_VERSION=<versione>, vedi Installazione). - Nel nuovo
.envsostituisciSECRET_KEY_BASE, le tre chiaviAR_ENCRYPTION_*eSECRET_ASSETS_MASTER_KEYcon i valori del vecchio. LasciaPOSTGRES_PASSWORDcome l'ha scritto la nuova installazione. Copia anche le tue impostazioni: email, S3 (AWS_*: senza, allegati e registrazioni salvati lì non si aprono), GitHub, Telegram. - Metti il file di backup in
/opt/closeyourit/backups/e lanciacloseyourit restore <file>. - Copia anche i file caricati, a meno che non siano su S3.
- Punta il dominio al server nuovo.
Controllare l'installazione
closeyourit doctor
| Controllo | Si lamenta quando |
|---|---|
| Disco | è libero meno del 10% |
| App | non risponde |
| Certificato HTTPS | scade fra meno di 14 giorni, o l'indirizzo non risponde |
| Backup | non ce n'è nessuno, o l'ultimo ha più di 26 ore |
| Gateway e coda dell'ingest | il gateway è acceso e uno dei due è spento o continua a ripartire |
| Versione | ce n'è una più nuova (una nota, non un problema) |
Altri comandi
| Comando | Fa |
|---|---|
closeyourit status | mostra i servizi e la versione |
closeyourit logs | segue il log dell'app e del worker |
closeyourit restart | riavvia dopo una modifica alle impostazioni |
closeyourit enable ingest | accende il gateway di ingest |
closeyourit disable ingest | lo spegne |
closeyourit enable updates | accende il bottone Aggiorna ora nell'app |
closeyourit disable updates | lo spegne |
Qualcosa non funziona? Vedi Risolvere i problemi.