Instale o Discourse no Windows para desenvolvimento

[Discourse]

Este tutorial foi testado no Windows 10 e 11.

Para configurar um ambiente de desenvolvimento para o Discourse no Windows, você pode usar o recurso Subsistema do Windows para Linux.

Esta configuração requer a instalação do WSL 2. Ele está disponível apenas nas builds do Windows 10 18917 ou superiores. Vamos assumir que você já instalou o Subsistema do Windows para Linux 2 (Ubuntu) no seu sistema Windows 10. AVISO: Instale o Ubuntu 18.04 e não o 20.04, pois algumas instalações falharão no 20.04. Para mais informações, consulte as notas de 30 de junho de 2020 no final desta postagem.

Vamos começar!

Instalando o Discourse

1. Inicialmente, siga os passos do tópico Guia para Iniciantes para Instalar o Discourse no Ubuntu para Desenvolvimento até o passo Clonar o Discourse.

@techAPJ

Instalar Dependências do Discourse

Você precisará dos seguintes pacotes no seu sistema:

• Git
• rbenv ou asdf
• ruby-build
• Ruby (última versão estável)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** opcional

Agora que instalamos as dependências do Discourse, vamos prosseguir para instalar o próprio Discourse.

2. Antes de configurar o banco de dados, você deve iniciar manualmente o serviço do PostgreSQL e o servidor Redis usando os seguintes comandos:

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Em seguida, siga todos os passos restantes do guia do Ubuntu.

@techAPJ

Clonar o Discourse

Clone o repositório do Discourse na pasta ~/discourse:

git clone https://github.com/discourse/discourse.git ~/discourse

~ indica a pasta inicial, então o código-fonte do Discourse estará disponível na sua pasta inicial.

Configurar o Banco de Dados

Crie uma função com o mesmo nome do seu usuário do sistema Ubuntu:

sudo -u postgres createuser -s "$USER"

Inicializar o Discourse

Mude para a pasta do Discourse:

cd ~/discourse

Instale as gems necessárias:

source ~/.bashrc
bundle install

Agora que você instalou as gems com sucesso, execute estes comandos:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Tente executar os testes:

bundle exec rake autospec

Todos os testes devem passar.

Inicie o servidor Rails:

bundle exec rails server

Agora você deve conseguir conectar ao seu aplicativo Discourse em http://localhost:3000 — experimente!

Em uma instância separada do terminal, navegue até a pasta do Discourse (cd ~/discourse) e execute:

bin/dev --only ember

Isso inicia o bundler do frontend; o aplicativo continua sendo servido em http://localhost:3000.

Criando um Comando para Iniciar o Discourse

Agora seu ambiente de desenvolvimento está quase pronto. O único problema é que toda vez que você abre o Ubuntu no Windows, precisa iniciar manualmente o serviço do PostgreSQL e o servidor Redis. Não se preocupe, podemos contornar isso criando um comando personalizado

cd ~

Crie um novo arquivo usando o comando nano start-discourse, cole o conteúdo abaixo, salve e saia.

#!/bin/bash

# para iniciar o PostgreSQL
sudo service postgresql start

# para iniciar o servidor Redis
redis-server --daemonize yes

Agora modifique as permissões do arquivo usando o comando abaixo:

chmod +x start-discourse

E copie o arquivo para sua pasta bin:

sudo cp start-discourse /usr/bin/

Está feito. Agora, sempre que abrir o bash do Ubuntu, basta executar o comando abaixo e começar a desenvolver

start-discourse

---

Alternativamente, se você estiver usando o Windows 10 nas edições Enterprise, Pro ou Education, pode criar uma máquina virtual Linux no Hyper-V para configurar o ambiente de desenvolvimento do Discourse.

Notas sobre o Ambiente Windows

Em 30 de junho de 2020:

@AndreaHabib

Com a introdução da build 2004 do Windows 10 e do WSL 2, muitos de vocês podem enfrentar alguns problemas, já que o Discourse agora requer o WSL 2 para funcionar de verdade.
Para começar: Se você ainda não atualizou, deseja atualizar seu sistema para o Windows 2004 (19041).
Nota: Não instale usando o Windows Update nas configurações do sistema, pois você pode receber erros durante a instalação. Além disso, certifique-se de estar no Windows 1903 (18362) ou 1909 (18363); você pode pesquisar por winver para verificar.

• Acesse: Baixar Windows 10
• Clique no botão Atualizar Agora sob a Atualização do Windows 10 de maio de 2020 para baixar o assistente de atualização e deixe-o instalar e concluir.
• Se receber algum erro, baixe a ferramenta de criação de mídia, execute-a e crie uma unidade flash inicializável (com pelo menos 8 GB) e use-a para instalar o Windows.

Quando terminar a instalação do Windows, você precisará instalar manualmente o WSL 2.
Mas primeiro, precisamos garantir que dois recursos estejam habilitados:

• Plataforma de Máquina Virtual, que pode ser habilitada diretamente no Windows, acessando Programas e Recursos e depois ativando Recursos Opcionais em Ativar ou desativar recursos do Windows.
• O outro é a Virtualização, que só pode ser habilitada na sua BIOS. No entanto, essa opção pode variar de uma placa-mãe para outra. Por exemplo: na AMD, é chamada de SVM. Portanto, procure informações sobre sua placa-mãe específica.

Agora que ambos os recursos estão habilitados:

• Instale o Ubuntu 18.04 e não o 20.04, pois algumas instalações falharão no 20.04.
• Acesse este link e atualize o Kernel Linux: Link nas respostas.
• Acesse este link e siga as instruções: Instalar o Subsistema do Windows para Linux (WSL) no Windows 10 | Microsoft Docs
• Abra o PowerShell (como administrador) e execute: wsl --set-version Ubuntu-18.04 2 ou wsl --set-version Ubuntu 2, dependendo da distribuição que aparecer em wsl -l -v.
• A conversão leva tempo, alguns minutos.
• Execute wsl -l -v para garantir que o Ubuntu esteja rodando no WSL 2.

Agora você pode executar o Ubuntu-18.04 ou o Windows Terminal com o Ubuntu e começar a instalar as dependências e ferramentas.

Nota: Se você estiver enfrentando um erro ao instalar uma das gems durante o bundle install: Certifique-se de estar no Ubuntu-18.04 e não no 20.04.

No entanto, se você já tiver o PostgreSQL 12 instalado e rodando na porta 5432, pode enfrentar alguns problemas, pois as dependências instalam o PostgreSQL 10, o que pode incrementar a porta para 5433.
Para corrigir isso:

• Abra sua pasta em um editor de texto (VS Code, por exemplo).
• Acesse config/database.yml.
• Em desenvolvimento e em adapter, adicione uma nova linha e depois adicione: port: 5433.
• Certifique-se de fazer o mesmo para teste e perfil.

Se o acima não funcionar, verifique se o PostgreSQL está rodando e em qual porta, usando pg_isready. Em seguida, siga as mesmas instruções acima, definindo a porta igual àquela em que o banco de dados está rodando.

PARA O KERNEL LINUX: Atualizando o kernel Linux do WSL 2 | Microsoft Docs

@RickyC0626

Uma solução que não requer configuração explícita de porta no database.yml.

Alguns erros durante a criação e migração do banco de dados:

Conexão inválida do Redis a uma porta específica / recusa de conexão

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

A partir deste erro, podemos ver que a porta usada pelo Redis é 6379, e podemos corrigir isso iniciando o servidor Redis via essa porta.

Por padrão, redis-server --daemonize yes deve funcionar, mas se não, use:

redis-server --daemonize yes --port 6379

Verifique o status da instância do Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Conexão inválida à porta psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

A partir deste erro, podemos ver que o PostgreSQL está com dificuldade para conectar à porta 5432. Geralmente, iniciar o serviço deve resolver.

sudo service postgresql start

Se isso ainda não funcionar e o erro persistir, tente verificar em qual porta o serviço está escutando e, se necessário, altere a porta para a desejada em postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

O Resultado

Depois de fazer o acima ou executar o comando start-discourse, as duas instâncias devem rodar em suas portas padrão/especificadas. Para verificar o status delas via o terminal padrão cmd do Windows, podemos executar:

netstat -anop tcp

O que mostrará algo assim:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

Agora confirmamos que ambas as instâncias do postgresql e redis-server estão rodando.

Também podemos verificar o status das instâncias no Ubuntu ou WSL com os seguintes comandos:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

A partir daqui, esses comandos devem funcionar sem grandes problemas, sem necessidade de modificar o arquivo database.yml:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Quaisquer problemas adicionais que surgirem podem ser abordados no futuro.

Em 1º de julho de 2020

@RickyC0626

Uma solução que não requer configuração explícita de porta no database.yml.

Alguns erros durante a criação e migração do banco de dados:

Conexão inválida do Redis a uma porta específica / recusa de conexão

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Caused by:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Caused by:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(See full trace by running task with --trace)

A partir deste erro, podemos ver que a porta usada pelo Redis é 6379, e podemos corrigir isso iniciando o servidor Redis via essa porta.

Por padrão, redis-server --daemonize yes deve funcionar, mas se não, use:

redis-server --daemonize yes --port 6379

Verifique o status da instância do Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Conexão inválida à porta psql

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

A partir deste erro, podemos ver que o PostgreSQL está com dificuldade para conectar à porta 5432. Geralmente, iniciar o serviço deve resolver.

sudo service postgresql start

Se isso ainda não funcionar e o erro persistir, tente verificar em qual porta o serviço está escutando e, se necessário, altere a porta para a desejada em postgresql.conf:

pg_isready

/var/run/postgresql:5432 - no response
or
/var/run/postgresql:5432 - accepting connections

---

O Resultado

Depois de fazer o acima ou executar o comando start-discourse, as duas instâncias devem rodar em suas portas padrão/especificadas. Para verificar o status delas via o terminal padrão cmd do Windows, podemos executar:

netstat -anop tcp

O que mostrará algo assim:

Proto    Local Address        Foreign Address        State            PID
TCP      127.0.0.1:5432       0.0.0.0:0              LISTENING        17768
TCP      127.0.0.1:6379       0.0.0.0:0              LISTENING        17768

Agora confirmamos que ambas as instâncias do postgresql e redis-server estão rodando.

Também podemos verificar o status das instâncias no Ubuntu ou WSL com os seguintes comandos:

lsof -i

COMMAND     PID        USER  FD  TYPE  DEVICE  SIZE/OFF  NODE  NAME
mailcatch  3244  rickyc0626  7u  IPv4   36127       0t0   TCP  localhost:1025 (LISTEN)
mailcatch  3244  rickyc0626  8u  IPv4   36128       0t0   TCP  *:socks (LISTEN)
redis-ser  3287  rickyc0626  6u  IPv6   29352       0t0   TCP  *:6379 (LISTEN)
redis-ser  3287  rickyc0626  7u  IPv6   29353       0t0   TCP  *:6379 (LISTEN)

---

sudo ss -plunt | grep postgres

tcp  LISTEN  0  128  127.0.0.1:5432  0.0.0.0:*  users:(("postgres",pid=3070,fd=7))

---

pg_lsclusters

Ver Cluster Port Status Owner    Data directory              Log file
10  main    5432 online postgres /var/lib/postgresql/10/main /var/log/postgresql/postgresql-10-main.log

---

A partir daqui, esses comandos devem funcionar sem grandes problemas, sem necessidade de modificar o arquivo database.yml:

bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate

Quaisquer problemas adicionais que surgirem podem ser abordados no futuro.

---

Última revisão por @SaraDev em 2022-06-16T02:00:00Z

---

Este documento está sob controle de versão — sugira alterações no GitHub.