Passare da un canale/versione all'altro di Discourse

[Discourse]

Questa guida spiega come configurare il canale di rilascio della tua istanza Discourse.

Livello utente richiesto: Amministratore di sistema

È necessario l’accesso alla console.

La gestione del canale della tua istanza Discourse determina la frequenza e il tipo di aggiornamenti che riceverai. Questa guida spiega i canali disponibili e fornisce un approccio passo dopo passo per cambiare il branch nella tua configurazione.

Sommario

Discourse offre diversi canali per il monitoraggio degli aggiornamenti del software: latest, release e esr. Questa documentazione spiega lo scopo di ciascuno, le loro caratteristiche principali e come configurarli nella tua istanza Discourse. Per un’illustrazione dei canali, vedi releases.discourse.org.

Canali supportati

latest

Predefinito consigliato
Questo canale fornisce gli ultimi aggiornamenti di correzione di bug e di compatibilità per i plugin. Ogni commit proveniente dal branch main viene testato dal server di compilazione e aggiunto al branch latest dopo una verifica riuscita.

• Adatto per i siti che vogliono rimanere aggiornati.
• I siti possono eseguire l’aggiornamento manualmente in qualsiasi momento.

release

Per i siti che preferiscono rilasci mensili

Il canale release monitora l’ultimo rilascio mensile di Discourse. Ogni mese, un branch di rilascio (ad esempio release/2026.2) viene creato da latest, fornendo uno snapshot stabile.

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

esr

Rilascio con supporto esteso

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

• Dichiarato approssimativamente ogni 6 mesi dai rilasci mensili.
• Riceve correzioni di sicurezza e backport critici per un periodo esteso.
• Potrebbe avere compatibilità limitata con plugin della comunità e componenti dei temi.

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

Alias deprecati

Per la compatibilità con le versioni precedenti, i seguenti vecchi nomi di branch/tag funzionano ancora ma sono considerati deprecati:

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

Altri branch o riferimenti

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

Istruzioni per configurare il tuo canale

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

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

cd /var/discourse
nano containers/app.yml

L’editor nano aprirà il file di configurazione.
2. Modifica il branch di monitoraggio
Cerca il parametro della versione cercando la parola “version” nel file:

params:  
## Quale revisione Git dovrebbe utilizzare questo container? (predefinito: latest)  
#version: latest

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

params:  
## Quale revisione Git dovrebbe utilizzare questo container? (predefinito: 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:

./launcher rebuild app

La ricostruzione causerà un’interruzione temporanea del servizio

[ghorbani (Aref)]

@Discourse

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

È git pull un passaggio necessario, o è ridondante e rimane dalla documentazione legacy, simile al caso dell’aggiornamento di Discourse (Aggiorna manualmente Discourse e l’immagine Docker all’ultima versione)?

[merefield (Robert)]

Per la mia esperienza, git pull è _occasionale_mente utile: ad esempio, è stato indispensabile quando siamo passati da yarn a pnpm…

Normalmente non c’è bisogno di preoccuparsi per una rebuild regolare.

[ghorbani (Aref)]

Bene sapere! Grazie per le informazioni.

[merefield (Robert)]

Quello che faccio di solito è provare a ricostruire; se fallisce per qualche motivo non del tutto ovvio, provo prima a fare un git pull — ci vuole un attimo.

[david (David Taylor)]

In teoria non dovrebbe mai essere necessario. Il launcher rileverà automaticamente una copia obsoleta ed eseguirà il git pull da solo:

launcher

[ghorbani (Aref)]

Grazie per i dettagli. In effetti, ha senso. Ci proverò senza git pul e ti farò sapere come andrà a finire.

[Ed_S]

È strano. Il codice in questione risale al 2015, il mio forum al 2018, eppure sono abbastanza sicuro che qui siano stati discussi diversi casi in cui era necessario eseguire git pull.

Per quanto mi riguarda, eseguirò sempre git pull, se me ne ricordo — non mi costa nulla.

[david (David Taylor)]

Se ne parla spesso, penso a causa di questi documenti molto storici. Non credo di aver mai visto prove che sia stato effettivamente utile.

Ma sì, non c’è alcun danno a eseguirlo anche manualmente

[Ed_S]

@Discourse

## Quale revisione di Git dovrebbe utilizzare questo container? (default: latest)  
#version: latest

Poiché il file yml utilizza version e non supported tracking branch, sarebbe opportuno aggiungere (version) al titolo dell’argomento?

[ghorbani (Aref)]

Anche io sono rimasto un po’ sorpreso dalla data, all’inizio. Ma controllando la cronologia delle versioni, l’ultimo aggiornamento è del 18 maggio.

[david (David Taylor)]

Ho cercato di aggiornare il primo post per utilizzare la nostra moderna terminologia “canale” e rimuovere alcuni riferimenti non necessari a git pull.

[merefield (Robert)]

Deve esserci almeno un caso limite, perché sicuramente “mi ha aiutato a superare l’ostacolo” in circostanze molto rare.

Potrebbe essere quando lo script principale cambia in circostanze limitate?