Configura un ramo di tracciamento supportato per ricevere gli aggiornamenti del software Discourse

[Discourse]

Questa guida spiega come configurare un branch di tracciamento supportato per la tua istanza Discourse per gestire gli aggiornamenti software.

Livello utente richiesto: Amministratore di sistema

È richiesto l’accesso alla console.

La gestione del branch di tracciamento della tua istanza Discourse determina la frequenza e il tipo di aggiornamenti che ricevi. Questa guida spiega le diverse opzioni di branch di tracciamento disponibili e fornisce un approccio passo passo per modificare il branch sulla tua configurazione.

Riepilogo

Discourse offre diversi branch e tag per il tracciamento degli aggiornamenti software: latest, release ed esr. Questa documentazione spiega lo scopo di ciascuno, le loro caratteristiche principali e come configurarli nella tua istanza Discourse. Per i dettagli completi sul modello di rilascio, consulta RFC: A new versioning strategy for Discourse.

Branch supportati

latest

Default Consigliato
Questo branch fornisce le ultime correzioni di bug e gli aggiornamenti di compatibilità per i plugin. Ogni commit che passa dal branch main viene testato dal server di build e aggiunto al branch latest dopo una verifica riuscita.

• Adatto per siti che desiderano rimanere aggiornati.
• I siti possono aggiornare manualmente in qualsiasi momento.

release

Per siti che preferiscono rilasci mensili
Il tag release traccia l’ultimo rilascio mensile di Discourse. Ogni mese, un branch di rilascio (ad esempio release/2026.2) viene tagliato da latest, fornendo uno snapshot stabile.

• Rilasciato circa una volta al mese.
• Ogni rilascio riceve correzioni critiche per due cicli di rilascio completi.

esr

Extended Support Release (Rilascio con Supporto Esteso)
Il tag esr traccia l’ultimo Extended Support Release, destinato ai siti che danno priorità alla stabilità e alla sicurezza a lungo termine rispetto agli aggiornamenti frequenti.

• Dichiarato circa ogni 6 mesi dai rilasci mensili.
• Riceve correzioni di sicurezza e backport critici per un periodo prolungato.
• Potrebbe avere una compatibilità limitata con i plugin della community e i componenti dei temi.

Nota: Non ricevere aggiornamenti di manutenzione regolari può lasciare alcune funzionalità obsolete o visivamente incoerenti.

Alias deprecati

Per retrocompatibilità, i seguenti vecchi nomi di branch/tag funzionano ancora ma sono considerati deprecati:

• tests-passed → latest
• beta → release
• stable → esr

Altri branch o riferimenti

Tracciare altri branch (ad esempio specifici branch release/AAAA.M o SHA di commit) è possibile ma richiede esperienza. Questi branch ricevono solo correzioni critiche per un periodo limitato.

Istruzioni per configurare il tuo branch di tracciamento

Segui questi passaggi per configurare il branch desiderato nella tua istanza Discourse:

1. Accesso al file di configurazione
   Apri il file di configurazione app.yml eseguendo i seguenti comandi nella console:

cd /var/discourse
git pull
nano containers/app.yml

L’editor nano aprirà il file di configurazione.
2. Modifica del branch di tracciamento
Individua il parametro version cercando la parola “version” nel file:

params:  
## Which Git revision should this container use? (default: latest)  
#version: latest

• Decommenta la riga version.
• Sostituisci latest con il nome del branch o del tag desiderato (ad esempio esr). Esempio:

params:  
## Which Git revision should this container use? (default: latest)  
version: esr  

3. Salva ed esci

• Premi Ctrl+O per salvare le modifiche.
• Premi Invio per confermare.
• Usa Ctrl+X per uscire dall’editor.

4. Ricostruisci il container
   Una volta apportate e salvate le modifiche, ricostruisci il container per applicare la nuova configurazione:

git pull
./launcher rebuild app

Questo processo potrebbe causare un downtime temporaneo. Se possibile, assicurati di aggiornare l’istanza durante le ore non lavorative.