// Tutorial //

Como instalar o Discourse no Ubuntu 20.04

Published on August 19, 2020
Default avatar
By Arpit Jalan
Developer and author at DigitalOcean.
Português
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á:

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.

Nota: se precisar modificar ou corrigir essas configurações após a inicialização, edite seu arquivo /containers/app.yml e execute ./launcher rebuild app. Caso contrário, suas alterações não entrarão em vigor.

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’.

Tela de congratulações do Discourse

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.

Assistente de configuração do Discourse

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.

Pagina inicial do Discourse e link para o Guia de inicio rápido de administradores

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.

Pagina de administrador de atualização do Discourse

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.


Want to learn more? Join the DigitalOcean Community!

Join our DigitalOcean community of over a million developers for free! Get help and share knowledge in our Questions & Answers section, find tutorials and tools that will help you grow as a developer and scale your project or business, and subscribe to topics of interest.

Sign up
About the authors
Default avatar
Developer and author at DigitalOcean.

Default avatar
Developer and author at DigitalOcean.

Still looking for an answer?

Was this helpful?
Leave a comment

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!