Configurar una rama de seguimiento compatible para obtener actualizaciones del software Discourse

[Discourse]

Esta guía explica cómo configurar una rama de seguimiento compatible para su instancia de Discourse para gestionar las actualizaciones de software.

Nivel de usuario requerido: Administrador del sistema

Se requiere acceso a la consola.

Gestionar la rama de seguimiento de su instancia de Discourse determina la frecuencia y el tipo de actualizaciones que recibe. Esta guía explica las diferentes ramas de seguimiento disponibles y proporciona un enfoque paso a paso para cambiar la rama en su configuración.

Resumen

Discourse ofrece varias ramas y etiquetas para el seguimiento de las actualizaciones de software: latest, release y esr. Esta documentación explica el propósito de cada una, sus características clave y cómo configurarlas en su instancia de Discourse. Para obtener todos los detalles sobre el modelo de lanzamiento, consulte RFC: Una nueva estrategia de versionado para Discourse.

Ramas compatibles

latest

Recomendado por defecto
Esta rama proporciona las últimas correcciones de errores y actualizaciones de compatibilidad para los complementos. Cada commit que pasa desde la rama main es probado por el servidor de compilación y añadido a la rama latest después de una verificación exitosa.

• Adecuado para sitios que desean mantenerse actualizados.
• Los sitios pueden actualizar manualmente en cualquier momento.

release

Para sitios que prefieren lanzamientos mensuales

La etiqueta release rastrea el lanzamiento mensual más reciente de Discourse. Cada mes, se recorta una rama de lanzamiento (por ejemplo, release/2026.2) de latest, proporcionando una instantánea estable.

• Se publica aproximadamente una vez al mes.
• Cada lanzamiento recibe correcciones críticas durante dos ciclos de lanzamiento completos.

esr

Lanzamiento de Soporte Extendido (Extended Support Release)

La etiqueta esr rastrea el último Lanzamiento de Soporte Extendido, destinado a sitios que priorizan la estabilidad y seguridad a largo plazo sobre las actualizaciones frecuentes.

• Se declara aproximadamente cada 6 meses a partir de los lanzamientos mensuales.
• Recibe correcciones de seguridad y backports críticos durante un período prolongado.
• Puede tener compatibilidad limitada con complementos comunitarios y componentes de temas.

Nota: No recibir actualizaciones de mantenimiento periódicas puede dejar algunas características obsoletas o visualmente inconsistentes.

Alias obsoletos

Para compatibilidad con versiones anteriores, los siguientes nombres de rama/etiqueta antiguos todavía funcionan pero se consideran obsoletos:

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

Otras ramas o referencias

El seguimiento de otras ramas (por ejemplo, ramas específicas release/AAAA.M o commit SHAs) es posible pero requiere experiencia. Estas ramas solo reciben correcciones críticas durante un período limitado.

Instrucciones para configurar su rama de seguimiento

Siga estos pasos para configurar la rama deseada en su instancia de Discourse:

1. Acceder al archivo de configuración
   Abra el archivo de configuración app.yml ejecutando los siguientes comandos en su consola:

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

El editor nano abrirá el archivo de configuración.
2. Editar la rama de seguimiento
Localice el parámetro de versión buscando la palabra “version” en el archivo:

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

• Anule el comentario de la línea de versión.
• Reemplace latest con el nombre de la rama o etiqueta deseada (por ejemplo, esr). Ejemplo:

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

3. Guardar y salir

• Presione Ctrl+O para guardar sus cambios.
• Presione Enter para confirmar.
• Use Ctrl+X para salir del editor.

4. Recompilar el contenedor
   Una vez que se hayan realizado y guardado los cambios, reconstruya el contenedor para aplicar la nueva configuración:

git pull
./launcher rebuild app

Este proceso podría causar tiempo de inactividad temporal. Asegúrese de actualizar la instancia durante horas no laborables si es posible.