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