Vai al contenuto principale

​
Panoramica

CaseBender viene distribuito come un insieme di immagini di container versionate. Aggiornare significa scaricare le ultime immagini e ricreare i container. I tuoi dati, la licenza e la configurazione risiedono in volumi Docker con nome e nel tuo file .env — entrambi vengono conservati durante gli aggiornamenti, quindi un aggiornamento non tocca mai i tuoi casi, utenti, credenziali o licenza finché li mantieni.
Le migrazioni del database e il seeding dei dati predefiniti vengono eseguiti automaticamente all’avvio dopo ogni aggiornamento. Non è necessario eseguire manualmente alcun comando di migrazione.

​
Cosa viene conservato durante gli aggiornamenti

Non eseguire mai docker compose down -v su un sistema di produzione. L’opzione -v elimina tutti i volumi con nome — il database, la licenza e i file. Senza quei volumi, il successivo avvio crea un database nuovo, il che reimposta la password amministratore al valore predefinito e rigenera la licenza.

​
Procedura di aggiornamento (Docker Compose)

1

Esegui il backup del database e del .env

2

Scarica le ultime immagini

3

Ricrea i container

Compose ricrea solo i servizi la cui immagine è cambiata e conserva i tuoi volumi.
4

Osserva i log

Le migrazioni e il seeding vengono eseguiti all’avvio — attendi che l’applicazione risulti integra (healthy).

​
Verifica dopo l’aggiornamento

  • Accedi e verifica che i casi, gli avvisi e gli utenti esistenti siano presenti.
  • Verifica che il login funzioni ancora (la password amministratore è invariata).
  • Controlla che il worker stia elaborando i job:

​
Rollback

Se qualcosa va storto, fissa il tag dell’immagine precedente e ripristina il backup:
Aggiorna sempre prima un ambiente di staging ed esegui un backup recente del database subito prima di aggiornare la produzione.

​
Errori comuni durante l’aggiornamento

I due problemi più comuni derivano entrambi dalla perdita dello stato:
  • Cambiare il nome del progetto o la directory di Compose. Docker deriva i nomi dei volumi dal progetto. Rinominare la cartella o usare un nome di progetto -p diverso fa puntare Compose a volumi nuovi e vuoti. Aggiorna sempre dalla stessa directory/progetto per riutilizzare i volumi esistenti.
  • LICENSE_SECRET_KEY mancante e nessun volume casebender_secret. Nei deployment più vecchi senza il volume del segreto persistente, imposta LICENSE_SECRET_KEY in .env (o aggiungi il volume) affinché la licenza sopravviva. I deployment attuali la conservano automaticamente.

​
Installer desktop

Se hai eseguito il deployment con l’Installer desktop, usa il flusso di aggiornamento integrato dell’app — scarica le ultime immagini e ricrea i servizi preservando la directory dei dati, il .env e la chiave di licenza.

​
Google Cloud Run

Gli aggiornamenti su Cloud Run distribuiscono una nuova revisione. Poiché Cloud Run ha un filesystem effimero, il segreto della licenza deve essere fornito tramite Secret Manager come LICENSE_SECRET_KEY affinché persista tra le revisioni. Ridistribuisci usando la tua istanza Cloud SQL e i segreti esistenti:
Le migrazioni vengono eseguite automaticamente sulla nuova revisione.