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.

[Arkshine]

@Arkshine

Em um Ubuntu 22 recém-instalado (Windows 10, WSL2) e com uma instalação bem-sucedida do Discourse, todas as imagens falham ao serem servidas na porta padrão 4200.

Certo, encontrei uma solução.

Notei que substituir 127.0.0.1 por localhost corrigiria as imagens.

Após pesquisar um pouco, este é o comando que você pode usar para iniciar o Discourse:

DISCOURSE_HOSTNAME=localhost UNICORN_LISTENER=localhost:3000 bin/ember-cli -u

---

Tentarei atualizar o guia mais tarde.

[Arkshine]

Alguma chance de revisar este PR?

FIX: The PostgreSQL service not starting after installation (WSL2 context)

Isso tornaria este guia um pouco mais amigável.

[Will_S1 (Will S)]

Alguma ideia do porquê estou recebendo "Infelizmente, ocorreu um erro inesperado e o Bundler não pode continuar." após bundle install\n?

[D111 (D)]

mesmo problema

[sam (Sam Saffron)]

Você pode fornecer uma captura de tela do erro? Qual versão do Ruby você tem instalada?

[frocm]

Estou tendo problemas com dependências:

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
Você deve usar o Bundler 2 ou superior com este lockfile.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versão do Bundler 1.16.1

ux430uq@Asus-UX430UQ:~/discourse$ gem install bundler

Buscando: bundler-2.4.20.gem (100%)
ERRO: Enquanto executava gem ... (Gem::FilePermissionError)
Você não tem permissões de escrita para o diretório /var/lib/gems/2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] senha para ux430uq:
Buscando: bundler-2.4.20.gem (100%)
ERRO: Erro ao instalar bundler:
        A última versão do bundler (>= 0) que suporta seu Ruby e RubyGems foi a 2.3.26. Tente instalar com `gem install bundler -v 2.3.26`
        bundler requer a versão do Ruby >= 2.6.0. A versão atual do ruby é 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versão do Bundler 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

Como posso consertar isso facilmente? Eu estava tentando instalar 2.6.0, depois 2.7.0, mas sempre há outros problemas com isso.

[AliBenBongo]

Conforme alguns dos comentários anteriores, também encontrei algumas dificuldades e erros ao tentar seguir este guia - tentei em um desktop Windows 10 e Windows 11.

Após alguma tentativa e erro, finalmente tenho etapas que resultam em um ambiente de desenvolvimento totalmente funcional no Windows 11, testado na versão mais recente 22H2 e também na próxima Release Preview 23H2 (presumo que também funcionará na versão mais recente do Windows 10).

Se for útil para alguém, acabei de postar o guia aqui:-

Guide to Setting Up Discourse Development Environment - Windows 11

Hi Everyone, After spending some time attempting to get a working development environment up and running under Windows 11 / WSL2 I thought I would share the steps that I have followed. This is my first post here so I hope that this is of use to somebody I am a Systems Administrator used to working with Windows so this has been an interesting journey learning Linux / Ruby / Discourse etc. A few things seem to have changed since the guide for Windows 10 was written and I ran into…

Espero que isso ajude pessoas como eu que estão tentando fazer o Discourse funcionar no Windows

[Canapin (Coin-coin le Canapin)]

Revisei todo este guia oficial novamente para garantir que nada quebrou desde a minha última tentativa.
Instalei o Ubuntu (versão não especificada) via WSL no Windows 11, que instalou a última versão LTS, 22.04 neste caso.

Não encontrei nenhum problema; tudo foi direto, sem erros, e a instalação de desenvolvimento funciona.

Se você tiver problemas para instalar algo usando um de nossos guias oficiais no futuro, por favor, anote os erros e relate-os para nós, é sempre útil

---

Dois avisos, no entanto:

Ao instalar o Node.js:

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

                           AVISO DE DEPRECIAÇÃO DE SCRIPT


  Este script, localizado em https://deb.nodesource.com/setup_X, usado para
  instalar o Node.js está obsoleto agora e eventualmente será desativado.

  Por favor, visite o Github de distribuições NodeSource e siga as
  instruções para migrar seu repositório.
  https://github.com/nodesource/distributions

  O repositório Github de distribuições Linux NodeSource Node.js contém
  informações sobre quais versões do Node.js e quais distribuições Linux
  são suportadas e como instalá-lo.
  https://github.com/nodesource/distributions


                          AVISO DE DEPRECIAÇÃO DE SCRIPT

================================================================================
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
================================================================================

PARA EVITAR ESTA ESPERA, MIGRE O SCRIPT
Continuando em 60 segundos (pressione Ctrl-C para abortar) ...

Ao executar redis-server --daemonize yes:

# AVISO A sobrealocação de memória deve estar habilitada! Sem ela, um salvamento em segundo plano ou a replicação podem falhar em condições de pouca memória. Sendo desabilitada, também pode causar falhas sem condições de pouca memória, veja https://github.com/jemalloc/jemalloc/issues/1328. Para corrigir este problema, adicione 'vm.overcommit_memory = 1' a /etc/sysctl.conf e então reinicie ou execute o comando 'sysctl vm.overcommit_memory=1' para que isso tenha efeito.

[AliBenBongo]

Não sei por que tive tantos problemas então! Talvez houvesse algo estranho na minha instalação do Windows que consegui consertar durante a minha solução de problemas sem perceber!

Ainda assim, estou feliz com o que aprendi até agora e ansioso para continuar trabalhando na migração dos meus fóruns para o Discourse.

[Arkshine]

@Canapin

Revisei todo este guia oficial novamente para garantir que nada quebrou desde a minha última tentativa.

Tive que reinstalar o Windows e agora tenho um Windows 11 limpo instalado.
Seguirei o guia e reportarei mais tarde! Terei o guia de @AliBenBongo em mente também.

[Arkshine]

Aqui está um acompanhamento.

O guia certamente poderia usar uma atualização, mas ainda funciona maravilhosamente bem em um Windows 11 22H2 recém-instalado.

O único problema que tive foi que, mesmo que o comando wsl estivesse funcionando em um terminal, o recurso WSL na verdade não estava habilitado por padrão:

[NateDhaliwal]

Acho que este guia está desatualizado. As etapas mencionadas no guia Ubuntu/Debian não existem mais.

[NateDhaliwal]

Existe uma maneira de desfazer todas essas etapas, por exemplo, reverter o script de instalação de pacotes, gems e clonagem?

[TempAccount]

@Discourse

AVISO: Instale o Ubuntu 18.04 e não o 20.04, pois algumas instalações falharão no 20.04.

Ainda é necessário instalar o 18.04 sobre o 20.04?

Recebendo erro ao instalar nodejs:

# apt install nodejs

Reading package lists... Done
Building dependency tree
Reading state information... Done
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 nodejs : Depends: libc6 (>= 2.28) but 2.27-3ubuntu1.6 is to be installed
E: Unable to correct problems, you have held broken packages.```

[saros]

@Arkshine

Pronto, encontrei uma solução.

Percebi que substituir 127.0.0.1 por localhost resolve o problema das imagens.

Pesquisei e você pode usar o seguinte comando para iniciar o Diwsl

Falha na instalação do 24.04; o host não consegue conectar à porta 3000

[merefield (Robert)]

Eu tenho funcionando na versão 24.04. Recomendo compartilhar mais informações sobre como as coisas se apresentam ao iniciar o servidor.

Tente FORCE_HOSTNAME=localhost bin/ember-cli -u, que executará simultaneamente os servidores de back-end e front-end.

(Em trânsito: de memória)