Como instalar o Discourse no Ubuntu 20.04

O autor selecionou o Free and Open Source Fund para receber uma doação como parte do programa Write for DOnations.

Introdução

O Discourse é uma plataforma de discussão de código aberto. Ele pode ser usado como uma lista de e-mail, um fórum de discussões ou uma sala de bate-papo em formato longo. Neste tutorial, você instalará o Discourse em um ambiente isolado usando o Docker, um aplicativo de conteinerização.

Pré-requisitos

Antes de começar, há algumas coisas que você precisará:

• Um servidor Ubuntu 20.04 com pelo menos 2 GB de RAM, um usuário sudo não root e um firewall. Consulte nosso tutorial de configuração inicial de servidor para o Ubuntu 20.04 se precisar de orientação.
• O Docker instalado no seu servidor. Para fazer isso, é necessário seguir o passo 1 de nosso tutorial de instalação do Docker para o Ubuntu 20.04.
• Um domínio (ou subdomínio) com um registro A disponível apontado para o IP do seu servidor. Se você estiver gerenciando seu DNS na DigitalOcean, então siga este guia para associar seu IP ao seu domínio. Este tutorial irá usar o discourse.your_domain.
• Um servidor de e-mail SMTP. Se não quiser utilizar seu próprio servidor de e-mail, utilize outro serviço, como uma conta gratuita no Mailgun.

Passo 1 — Baixando o Discourse

Antes de baixar e instalar o Discourse, crie o diretório /var/discourse. Lá é onde todos os seus arquivos relacionados ao Discourse irão residir:

sudo mkdir /var/discourse

Por fim, clone a Imagem Docker oficial do Discourse em /var/discourse:

sudo git clone https://github.com/discourse/discourse_docker.git /var/discourse

Com a imagem Docker do Discourse no lugar, agora você pode instalar e configurar sua plataforma.

Passo 2 — Instalando e configurando o Discourse

Vá até o diretório /var/discourse:

cd /var/discourse

Agora, inicie o script de configuração que vem incluso:

sudo ./discourse-setup

O script de instalação do Discourse irá fazer as seguintes perguntas:

• Nome do host para seu Discourse?

Digite discourse.your_domain, ou qualquer nome de host que tenha escolhido para sua plataforma.

• Endereço de e-mail para a conta de administrador?

Escolha o endereço de e-mail que deseja usar para a conta de administrador do Discourse. Pode ser um e-mail totalmente sem relação com seu domínio do Discourse. Use um endereço de e-mail que achar conveniente.

Observe que esse endereço de e-mail se tornará o padrão do administrador do Discourse. Mais tarde, você precisará reutilizá-lo ao configurar o Discourse a partir do seu painel de controle.

• Endereço SMTP do servidor?

• Nome de usuário SMTP?

• Porta SMTP?

• Senha SMTP?

Digite os detalhes de seu servidor SMTP para essas perguntas. Se estiver usando o Mailgun, o endereço SMTP do servidor será smtp.mailgun.org. O nome de usuário e a senha são as credenciais SMTP para o seu domínio, encontrados na guia domains (domínios).

Por fim, o script de instalação do Discourse lhe irá pedir que confirme todas essas configurações. Confirme suas configurações, e o script irá gerar um arquivo de configuração chamado app.yml. O processo de instalação será iniciado automaticamente.

A instalação do Discourse irá levar de 2-8 minutos aproximadamente. Após esse tempo, sua instância entrará em funcionamento. Agora, abra um navegador Web e crie uma conta de administrador.

Passo 3 — Registrando uma conta de administrador

Visite discourse.your_domain em seu navegador Web favorito e você verá a tela inicial do Discourse, ‘Congrats’.

Se receber um erro 502 Bad Gateway, tente esperar um minuto ou dois e então atualize seu navegador; sua instalação do Discourse pode não ter sido concluída.

Quando a página carregar, clique no botão azul Register (Registrar-se). Você verá um formulário chamado Register Admin Account (Registrar conta de administrador) com os seguintes campos:

• Email: escolha o endereço de e-mail que forneceu anteriormente no menu suspenso.
• Username: escolha um nome de usuário.
• Password: escolha uma senha forte.

Em seguida, clique no botão azul Register no formulário para enviá-lo. Você verá um diálogo dizendo Confirm your Email (Confirme seu e-mail). Procure em sua caixa de entrada pelo e-mail de confirmação. Se não tiver o recebido, clique no botão Resend Activation Email (Reenviar e-mail de ativação). Se ainda assim não conseguir registrar uma nova conta de administrador, consulte a lista de verificação de solução de problemas de e-mail para o Discourse.

Após registrar sua conta de administrador, o assistente de configuração iniciará a configuração básica do Discourse e guiará você durante o processo. Você pode seguir o passo a passo agora ou clicar em Maybe Later para ignorar.

Depois de completar ou ignorar o assistente de configuração, você verá alguns tópicos e o Discourse’s Admin Quick Start Guide (Guia de início rápido de administradores do Discourse). O guia de início rápido é rotulado READ ME FIRST (Leia-me primeiro), e contém dicas para personalizar ainda mais sua instalação do Discourse.

Sua plataforma do Discourse agora está pronta para ser usada. Se precisar atualizar o Discourse no futuro, faça isso da linha de comando, obtendo a versão mais recente do código no repositório Git e recriando o aplicativo:

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

Também é possível atualizar o Discourse em seu navegador. Visite http://discourse.your_domain/admin/upgrade, clique em Upgrade to the latest Version (Atualizar para a versão mais recente) e siga as instruções.

Conclusão

Agora, você pode começar a gerenciar seu fórum do Discourse e deixar que usuários se inscrevam. Aprenda mais a respeito das funcionalidades do Discourse na página oficial About do Discourse.