Configure um branch de rastreamento compatível para obter atualizações do software Discourse

[Discourse]

Este guia explica como configurar um branch de rastreamento suportado para sua instância do Discourse para gerenciar atualizações de software.

Nível de usuário necessário: Administrador do Sistema

O acesso ao console é necessário.

Gerenciar o branch de rastreamento da sua instância do Discourse determina a frequência e o tipo de atualizações que você recebe. Este guia explica os diferentes branches de rastreamento disponíveis e fornece uma abordagem passo a passo para alterar o branch na sua configuração.

Resumo

O Discourse oferece vários branches e tags para rastrear atualizações de software: latest, release e esr. Esta documentação explica a finalidade de cada um, seus recursos principais e como configurá-los em sua instância do Discourse. Para detalhes completos sobre o modelo de lançamento, consulte RFC: A new versioning strategy for Discourse.

Branches Suportados

latest

Padrão Recomendado
Este branch fornece as correções de bugs mais recentes e atualizações de compatibilidade para plugins. Cada commit que passa do branch main é testado pelo servidor de compilação e adicionado ao branch latest após verificação bem-sucedida.

• Adequado para sites que desejam se manter atualizados.
• Os sites podem atualizar manualmente a qualquer momento.

release

Para Sites Que Preferem Lançamentos Mensais

A tag release rastreia o lançamento mensal mais recente do Discourse. Todos os meses, um branch de lançamento (por exemplo, release/2026.2) é cortado de latest, fornecendo um snapshot estável.

• Lançado aproximadamente uma vez por mês.
• Cada lançamento recebe correções críticas por dois ciclos de lançamento completos.

esr

Lançamento com Suporte Estendido

A tag esr rastreia o mais recente Lançamento com Suporte Estendido, destinado a sites que priorizam estabilidade de longo prazo e segurança em vez de atualizações frequentes.

• Declarado aproximadamente a cada 6 meses a partir dos lançamentos mensais.
• Recebe correções de segurança e backports críticos por um período estendido.
• Pode ter compatibilidade limitada com plugins da comunidade e componentes de tema.

Nota: Não receber atualizações de manutenção regulares pode fazer com que alguns recursos fiquem desatualizados ou visualmente inconsistentes.

Aliases Depreciados

Para compatibilidade com versões anteriores, os seguintes nomes de branch/tag antigos ainda funcionam, mas são considerados obsoletos:

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

Outros branches ou referências

Rastrear outros branches (por exemplo, branches release/AAAA.M específicos ou SHAs de commit) é possível, mas requer conhecimento especializado. Esses branches recebem apenas correções críticas por um período limitado.

Instruções para configurar seu branch de rastreamento

Siga estas etapas para configurar o branch desejado em sua instância do Discourse:

1. Acesse o arquivo de configuração
   Abra o arquivo de configuração app.yml executando os seguintes comandos no seu console:

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

O editor nano abrirá o arquivo de configuração.
2. Edite o branch de rastreamento
Localize o parâmetro de versão pesquisando a palavra “version” no arquivo:

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

• Descomente a linha de versão.
• Substitua latest pelo nome do branch ou tag desejado (por exemplo, esr).Exemplo:

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

3. Salve e saia

• Pressione Ctrl+O para salvar suas alterações.
• Pressione Enter para confirmar.
• Use Ctrl+X para sair do editor.

4. Reconstrua o contêiner
   Depois que as alterações forem feitas e salvas, reconstrua o contêiner para aplicar a nova configuração:

git pull
./launcher rebuild app

Este processo pode causar tempo de inatividade temporário. Certifique-se de atualizar a instância durante horários de não funcionamento, se possível.