Tutorial

Como instalar o Discourse no Ubuntu 20.04

DockerOpen SourceUbuntu 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.

Creative Commons License