Atualize manualmente o Discourse e a imagem Docker para a mais recente

[Discourse]

Este guia fornece instruções passo a passo para atualizar manualmente o Discourse, o contêiner Docker e o sistema operacional Ubuntu em uma instalação auto-hospedada.

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

Acesso SSH ao servidor.

Se você hospeda o Discourse por conta própria, ocasionalmente precisa executar uma atualização manual via linha de comando para obter os lançamentos de segurança mais recentes e as bibliotecas mais novas.

Essas atualizações não são capturadas em admin/upgrade, é por isso que ocasionalmente você precisará fazer estas etapas adicionais:

Atualizando o Discourse

1. O próprio Discourse deve ser atualizado cerca de duas vezes por mês, clicando no botão “Update to Latest Version” (Atualizar para a versão mais recente) no seu painel de administração (admin/upgrade).

2. A cada dois meses, recomendamos fazer SSH no seu servidor web (usando putty ou seu cliente SSH preferido) e executar os seguintes comandos, especialmente se a página de atualização não aparecer ou se você tiver algum problema ao tentar atualizar.

cd /var/discourse
./launcher rebuild app

Atualizando a imagem Docker e o SO Ubuntu

Para atualizações do Ubuntu, certifique-se de que as atualizações de segurança automáticas estejam ativadas para o seu Ubuntu! O comando é:

dpkg-reconfigure -plow unattended-upgrades

No entanto, isso cobre apenas as atualizações de segurança críticas. De tempos em tempos, você deve obter todas as atualizações do SO como esta:

apt-get update
apt-get dist-upgrade

Isso também manterá o Docker atualizado através dos pacotes padrão docker-ce.

Para resumir:

• atualize o Discourse duas vezes por mês via atualizador web
• atualize o contêiner a cada dois meses
• atualize o SO a cada seis meses

Você poderia dobrar esses números e ainda estaria razoavelmente seguro, por exemplo, atualize o Discourse uma vez por mês, o contêiner a cada 4 meses, o SO uma vez a cada 12 meses, e assim por diante.

Mas você realmente, realmente quer ter as atualizações de segurança automáticas ativadas no Ubuntu, conforme listado acima.

FAQ

Qual é o momento certo para atualizar?

Depende apenas do tempo que você tem disponível e de quão atualizado você quer estar. Se você tiver plugins não oficiais, é altamente recomendável usar um site de teste/staging. Se você não tiver nenhum plugin não oficial, você provavelmente pode atualizar imediatamente, mas mesmo assim, alguns plugins podem falhar por alguns dias enquanto a equipe os corrige (há muitos deles).

Qual é a prática comum ao atualizar com muitos plugins instalados?

Se você tem muitos plugins, testar localmente ou em um servidor de teste é altamente aconselhável. Especialmente se você tiver plugins não oficiais, pois algo pode ter quebrado. Se você descobrir que algo quebrou, então é uma questão de: você tem tempo para consertar? O autor original do plugin tem tempo para consertar? Qualquer uma dessas coisas pode levar semanas. Então, pelo menos desta forma, você simplesmente tem um site de teste quebrado e não um site de produção quebrado.

Estou com pouco espaço em disco

Se você está com pouco espaço em disco (verifique com df), tente limpar imagens antigas usando:

./launcher cleanup
apt-get autoclean
apt-get autoremove

A atualização da versão real do Ubuntu importa já que o Discourse sempre opera no Docker?

Importa muito menos. Mas você deve estar em pelo menos uma versão LTS suportada atualmente do Ubuntu server. Um sistema operacional Linux de 64 bits com uma versão de kernel moderna é necessário.

[JammyDodger]

Os guias são revisados e atualizados com bastante frequência (este parece ter tido um pequeno ajuste em fevereiro).

O único que eu pessoalmente não conheço é o do docker:

@sam

Devido à forma como o empacotamento do docker mudou, você também pode ter que atualizar seu docker a partir dos pacotes lxc-docker ou docker-engine. Uma maneira de fazer isso é através do script Docker aqui (ele avisará sobre uma instalação existente, mas deve atualizar bem):

wget -qO- https://get.docker.com/ | sh

Isso agora usará as versões principais do docker-ce.

Isso é completamente seguro, nunca vimos nada ser quebrado por atualizações básicas do Ubuntu.

Mas posso garantir a precisão do resto.

[MarkDoerr]

Acabei de executar todos esses comandos no meu site de teste, incluindo a atualização do Docker, e eles funcionaram sem problemas.

[JammyDodger]

@sam

Devido à forma como a embalagem do Docker mudou, você também pode ter que atualizar seu Docker dos pacotes lxc-docker ou docker-engine. Uma maneira de fazer isso é através do script Docker aqui (ele avisará sobre uma instalação existente, mas deve atualizar corretamente):

wget -qO- https://get.docker.com/ | sh

Isso agora usará as versões principais do docker-ce.

Recebi um relato de que isso causou um problema ao ser executado. Acho que nunca o usei nos últimos dois anos em que tive um site de teste DO.

Alguém tem alguma experiência recente com isso para dizer se ainda é um conselho relevante ou não?

---

Acabei de dar uma olhada nas postagens excluídas e encontrei algumas onde essa parte do guia foi levantada antes ^[1] e parece que @MarkDoerr a executou sem problemas.

Embora eu ainda não tenha certeza se/em quais circunstâncias você seria obrigado a executá-lo? Tenho muita fé no Docker Manager?

---

1. Eu as restaurei ↩︎

[Architect]

Tentei executar esse comando (wget -qO- https://get.docker.com/ | sh) agora e ele relata:

Não é possível conectar ao daemon do Docker em unix:///var/run/docker.sock. O daemon do docker está em execução?

Parece que isso não funcionou para atualizar o docker.

Também parece ter causado a falha completa do site, e o aplicativo não pode ser reconstruído, relatando:

Não é possível conectar ao daemon do docker - verifique se ele está em execução e se você tem acesso

Após reiniciar o servidor, o site voltou a ficar online.

[pfaffman (Jay Pfaffman)]

@Arquiteto

Após reiniciar o servidor, o site voltou a ficar online.

Então, talvez ele tenha feito o upgrade, mas falhou ao reiniciar o docker. Você pode verificar com

docker --version

Acontece que meu laptop tinha um docker antigo e eu executei o comando recomendado e não precisei reiniciar para que ele funcionasse. Veja o que obtenho para a versão:

$ docker --version
Docker version 26.1.4, build 5650f9b

[Architect]

Tenha a mesma versão do Docker:

Docker version 26.1.4, build 5650f9b

[pfaffman (Jay Pfaffman)]

Então você está atualizado e tudo está bem!

[ToddZ]

Eu sabia que tinha visto este documento cobrindo a cadência de atualização do Discourse, mas tive dificuldade em encontrá-lo novamente porque está em Documentation em “Usando Docker” e intitulado “Atualizar Docker manualmente”.

Como ele cobre as atualizações do Discourse e do Ubuntu, ele poderia ter outro lugar ou dois no menu?

[tvavrda (Tomas Vavrda)]

Quando o Discourse recomenda que você atualize uma imagem (de modo que não seja possível atualizar pela interface do usuário), ele informa para fazer o seguinte:

    cd /var/discourse
    git pull
    ./launcher rebuild app

Para que serve esse git pull adicional e por que você não o recomenda no manual?

[Jagster (Jakke Flemming)]

É uma relíquia antiga e não é mais necessária. O Rebuild faz isso.

[tvavrda (Tomas Vavrda)]

Eu faço um PR?

[tvavrda (Tomas Vavrda)]

UX: Removed a redundant git pull statement from the docs

UX: Removed a redundant git pull statement from the user message

[david (David Taylor)]

Mesclado, obrigado @tvavrda!