Cambiar entre canales/versiones de lanzamiento de Discourse

[Discourse]

Esta guía explica cómo configurar el canal de lanzamiento de tu instancia de Discourse.

Nivel de usuario requerido: Administrador del sistema

Se requiere acceso a la consola.

Gestionar el canal de tu instancia de Discourse determina la frecuencia y el tipo de actualizaciones que recibes. Esta guía explica los canales disponibles y proporciona un enfoque paso a paso para cambiar la rama en tu configuración.

Resumen

Discourse ofrece varios canales para seguir las actualizaciones de software: latest, release y esr. Esta documentación explica el propósito de cada uno, sus características clave y cómo configurarlas en tu instancia de Discourse. Para una ilustración de los canales, consulta releases.discourse.org.

Canales compatibles

latest

Predeterminado recomendado
Este canal proporciona las últimas correcciones de errores y actualizaciones de compatibilidad para los complementos. Cada commit realizado en la rama main es probado por el servidor de compilación y añadido a la rama latest tras una verificación exitosa.

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

release

Para sitios que prefieren lanzamientos mensuales

El canal release sigue el lanzamiento mensual más reciente de Discourse. Cada mes, se crea una rama de lanzamiento (por ejemplo, release/2026.2) a partir de latest, proporcionando una instantánea estable.

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

esr

Lanzamiento con soporte extendido

La etiqueta esr sigue el último Lanzamiento con 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 extendido.
• Puede tener compatibilidad limitada con complementos de la comunidad y componentes de temas.

Nota: No recibir actualizaciones de mantenimiento regulares puede dejar algunas funciones desactualizadas o visualmente inconsistentes.

Alias obsoletos

Por compatibilidad con versiones anteriores, los siguientes nombres antiguos de ramas/etiquetas siguen funcionando pero se consideran obsoletos:

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

Otras ramas o referencias

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

Instrucciones para configurar tu canal

Sigue estos pasos para configurar la rama deseada en tu instancia de Discourse:

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

cd /var/discourse
nano containers/app.yml

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

params:  
## ¿Qué revisión Git debería usar este contenedor? (predeterminado: latest)  
#version: latest

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

params:  
## ¿Qué revisión Git debería usar este contenedor? (predeterminado: latest)  
version: esr  

3. Guardar y salir

• Presiona Ctrl+O para guardar tus cambios.
• Presiona Enter para confirmar.
• Usa Ctrl+X para salir del editor.

4. Reconstruir el contenedor
   Una vez realizados y guardados los cambios, reconstruye el contenedor para aplicar la nueva configuración:

./launcher rebuild app

La reconstrucción causará una interrupción temporal del servicio

[ghorbani (Aref)]

@Discourse

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

¿Es necesario el paso git pull o es redundante y proviene de la documentación antigua, al igual que en el caso de actualizar Discourse (Actualizar manualmente Discourse y la imagen de Docker a la última versión)?

[merefield (Robert)]

Por experiencia, git pull es ocasionalmente útil, por ejemplo, fue imprescindible cuando cambié de yarn a pnpm…

Normalmente no necesitas preocuparte por una reconstrucción regular.

[ghorbani (Aref)]

¡Qué bueno saberlo! Gracias por la información.

[merefield (Robert)]

lo que suelo hacer es intentar reconstruir, y si falla por alguna razón no muy obvia, primero intento hacer un git pull - lleva un momento.

[david (David Taylor)]

En teoría, nunca debería ser necesario. El lanzador detectará automáticamente una copia desactualizada y realizará el git pull por sí mismo:

launcher

[ghorbani (Aref)]

Gracias por los detalles. En efecto, tiene sentido. Lo intentaré sin git pul y te haré saber cómo funciona.

[Ed_S]

Eso es extraño. El código en cuestión data de 2015, mi foro data de 2018, y sin embargo estoy bastante seguro de que aquí se han discutido varios casos en los que era necesario hacer git pull.

Por mi parte, siempre haré git pull, si me acuerdo; no me cuesta nada.

[david (David Taylor)]

Se menciona mucho, creo que por estos documentos muy históricos. No creo haber visto nunca pruebas de que realmente ayude.

Pero sí, no hay ningún inconveniente en ejecutarlo manualmente también

[Ed_S]

@Discourse

## ¿Qué revisión de Git debe usar este contenedor? (predeterminado: latest)  
#version: latest

Dado que el archivo yml utiliza version y no supported tracking branch, ¿sería bueno añadir (version) al título del tema?

[ghorbani (Aref)]

Al principio, la fecha también me sorprendió un poco. Pero, al revisar el historial de versiones, la última actualización es del 18 de mayo.

[david (David Taylor)]

Hecho un intento por actualizar la publicación original para usar nuestra terminología moderna de “canal” y eliminar algunas de las referencias innecesarias a git pull.

[merefield (Robert)]

Debe haber al menos un caso extremo, porque definitivamente “me ha pasado el mal momento” en ocasiones muy raras

¿Podría ser cuando el script principal cambia en circunstancias limitadas?