Ce guide explique comment configurer une branche de suivi prise en charge pour votre instance Discourse afin de gérer les mises à jour logicielles.
Niveau d’utilisateur requis : Administrateur système
L’accès à la console est requis.
La gestion de la branche de suivi de votre instance Discourse détermine la fréquence et le type des mises à jour que vous recevez. Ce guide explique les différentes branches de suivi disponibles et fournit une approche étape par étape pour modifier la branche sur votre configuration.
Résumé
Discourse propose plusieurs branches et étiquettes pour le suivi des mises à jour logicielles : latest, release et esr. Cette documentation explique l’objectif de chacune, leurs caractéristiques clés et comment les configurer dans votre instance Discourse. Pour tous les détails sur le modèle de publication, consultez RFC: A new versioning strategy for Discourse.
Branches prises en charge
latest
Par défaut recommandé
Cette branche fournit les derniers correctifs de bogues et mises à jour de compatibilité pour les plugins. Chaque commit réussi provenant de la branche main est testé par le serveur de construction et ajouté à la branche latest après une vérification réussie.
- Convient aux sites qui souhaitent rester à jour.
- Les sites peuvent se mettre à jour manuellement à tout moment.
release
Pour les sites qui préfèrent les versions mensuelles
L’étiquette release suit la dernière version mensuelle de Discourse. Chaque mois, une branche de version (par exemple, release/2026.2) est coupée à partir de latest, fournissant un instantané stable.
- Publié environ une fois par mois.
- Chaque version reçoit des correctifs critiques pendant deux cycles de version complets.
esr
Version de support étendue (Extended Support Release)
L’étiquette esr suit la dernière Version de Support Étendue, destinée aux sites qui privilégient la stabilité et la sécurité à long terme par rapport aux mises à jour fréquentes.
- Déclarée environ tous les 6 mois à partir des versions mensuelles.
- Reçoit des correctifs de sécurité et des rétroportages critiques pendant une période prolongée.
- Peut avoir une compatibilité limitée avec les plugins communautaires et les composants de thème.
Alias dépréciés
Pour des raisons de rétrocompatibilité, les anciens noms de branches/étiquettes suivants fonctionnent toujours mais sont considérés comme dépréciés :
tests-passed→latestbeta→releasestable→esr
Autres branches ou références
release/AAAA.Mou des SHAs de commit) est possible mais nécessite une expertise. Ces branches ne reçoivent des correctifs critiques que pour une durée limitée.
Instructions pour configurer votre branche de suivi
Suivez ces étapes pour configurer la branche souhaitée dans votre instance Discourse :
- Accéder au fichier de configuration
Ouvrez le fichier de configurationapp.ymlen exécutant les commandes suivantes dans votre console :
cd /var/discourse
git pull
nano containers/app.yml
L’éditeur nano ouvrira le fichier de configuration.
2. Modifier la branche de suivi
Localisez le paramètre de version en recherchant le mot « version » dans le fichier :
params:
## Which Git revision should this container use? (default: latest)
#version: latest
- Décommentez la ligne de version.
- Remplacez
latestpar le nom de la branche ou de l’étiquette souhaité (par exemple,esr). Exemple :
params:
## Which Git revision should this container use? (default: latest)
version: esr
- Enregistrer et quitter
- Appuyez sur
Ctrl+Opour enregistrer vos modifications. - Appuyez sur
Entréepour confirmer. - Utilisez
Ctrl+Xpour quitter l’éditeur.
- Reconstruire le conteneur
Une fois les modifications effectuées et enregistrées, reconstruisez le conteneur pour appliquer la nouvelle configuration :
git pull
./launcher rebuild app