Instalar o Discourse no macOS para desenvolvimento

[Discourse]

Este guia cobre as instruções de instalação para um ambiente de desenvolvimento no macOS. Para guias de produção, consulte: Install Discourse in production with the official supported instructions

Então, você quer configurar o Discourse no macOS para fazer hacking e desenvolvimento?

Vamos assumir que você não tem Ruby/Rails/Postgres/Redis instalados no seu Mac. Vamos começar !

Instalar Dependências do Discourse

Você precisará dos seguintes pacotes em seu sistema:

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

** opcional

reinicie seu terminal

Agora que instalamos as dependências do Discourse, vamos avançar para a instalação do próprio Discourse.

Reiniciar o Terminal

Sair do seu shell e reiniciá-lo garante que os caminhos para os pacotes instalados sejam corretamente reconhecidos pelo Terminal.

Clonar o Discourse

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

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

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

Inicializar o Discourse (Bootstrap)

Mude para a sua pasta do Discourse:

cd ~/discourse

Instale os gems necessários

bundle install

Instale as dependências JS

pnpm install

Em seguida, execute estes comandos para configurar sua instância local do Discourse:

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

Inicie os servidores Rails + Ember, você tem duas opções aqui.

Opção 1: usando duas abas/janelas de Terminal separadas, execute o Rails e o bundler do frontend separadamente via

bundle exec rails server

e

bin/dev --only ember

Opção 2: usando apenas uma aba/janela de Terminal:

bin/dev # executa o Pitchfork e o bundler do frontend juntos

Agora você deve poder navegar para http://localhost:3000 para ver sua instalação local do Discourse. (Observe que o primeiro carregamento pode levar até um minuto, pois o servidor está sendo aquecido.)

Você também pode tentar executar os specs:

bundle exec rake autospec

Todos (ou quase todos) os testes devem passar.

Criar Novo Admin

Para criar um novo admin, execute o seguinte comando:

RAILS_ENV=development bundle exec rake admin:create

Siga os prompts para criar uma conta de admin.

Configurar E-mail

Execute o MailHog:

mailhog

---

Parabéns! Agora você é o admin da sua própria instalação do Discourse!

Bom hacking! E para começar com isso, veja Guia do Iniciante para Criar Plugins do Discourse.

---

Este documento é controlado por versão - sugira alterações no github.

[jamesmarkcook (James Cook)]

If anyone is getting failing specs with most of them being .count errors, then try the following:

RAILS_ENV=test bundle exec rake db:reset

I had a problem where development data somehow got into my test database and was causing lots of failures.

[henrikbg (Henrik Berg)]

Is it possible to reset a discourse completely?

[techAPJ (Arpit Jalan)]

@Henrik_B

Is it possible to reset a discourse completely?

Yes, do:

rake db:drop db:create db:migrate

Note that this will wipe everything and you will have to create your Admin user account again.

[Chaboi_3000]

Can someone assist me in how I can update my discourse?

/launcher rebuild app

returns an error.

[techAPJ (Arpit Jalan)]

./launcher rebuild app is for discourse_docker based production setup. To update local/development Discourse instance you need:

cd ~/discourse
git pull origin master

[Chaboi_3000]

@techAPJ

git pull origin master

I get this error @techAPJ,

error: Your local changes to the following files would be overwritten by merge:
	.gitignore
Please commit your changes or stash them before you merge.
Aborting

[techAPJ (Arpit Jalan)]

The error message is pretty clear:

Please commit your changes or stash them before you merge.

If you want to ignore your local changes, do:

git fetch origin
git reset --hard origin/master

[Decorbuz]

Usando o guia do fórum do Ruby on Rails, estou atualmente travado no passo 7.

Essa provavelmente é uma pergunta muito de “iniciante”, mas como faço para “apontar” para a branch experimental que foi linkada naquele tópico? Tentei algumas coisas e, por fim, recebi a mensagem Unknown command mini_racer toda vez.

[blake (Blake Erickson)]

Eles podem perguntar aqui sem problemas.

Existem algumas instruções específicas para M1 que escrevemos e referenciamos no fórum do Rails neste guia.

@Decorbuz

Provavelmente é uma pergunta muito “iniciante”, mas como faço para “apontar” para a branch experimental que foi linkada naquele tópico?

Precisaria verificar no meu M1 Air mais tarde, e talvez meus colegas de trabalho que configuraram Macs recentemente saibam melhor se isso ainda é necessário, mas há um exemplo de como apontar para uma branch no passo 7:

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

Então, você editaria essa linha na sua versão local do discourse/Gemfile:

Gemfile

e depois executaria bundle install.

[Decorbuz]

@pfaffman

Se você não seguiu essas instruções (não vejo uma etapa 7), então este não é um bom lugar para fazer sua pergunta.

O link está logo no topo da postagem original.

O tópico do fórum Ruby on Rails está inativo há muitos meses. O autor original (OP) não está ativo desde fevereiro e não respondeu a nenhum comentário lá pedindo ajuda.

Aqui há mais pessoas dispostas a me ajudar. Só dizendo.

@blake

há um exemplo de como apontar para uma branch na etapa 7:

gem 'mini_racer', github: 'rubyjs/mini_racer', branch: 'refs/pull/186/head'

Tentei copiar isso para o Terminal e recebi o mesmo erro Unknown command mini_racer de antes.

É justo admitir que o guia do fórum Ruby on Rails não é tão claro quanto eu esperava nesse aspecto.

Peço desculpas antecipadamente…

[blake (Blake Erickson)]

@Decorbuz

Tentei copiar isso para o Terminal e recebi o mesmo erro “Unknown command mini_racer” de antes.

Não é um comando para executar. Você precisará EDITAR o arquivo de texto real chamado “Gemfile” localizado dentro do diretório do Discourse.

[Decorbuz]

@blake

Você precisará EDITAR o arquivo de texto real chamado “Gemfile” localizado dentro do diretório do Discourse.

D’oh!

Obrigado! Vou tentar isso agora mesmo.

Na minha opinião, alguém deveria editar o guia do fórum do Ruby on Rails e fornecer mais esclarecimentos sobre o passo 7. Mas é só a minha opinião.

Já volto. Aguarde um momento…

[blake (Blake Erickson)]

Desculpe, mas tenho que correr. Acredito que a correção do mini_racer para Macs M1 já foi mesclada. Acabei de verificar meu Gemfile no meu Mac M1 e o meu não foi editado. Então, acho que você pode pular a etapa 7.

[Decorbuz]

Executei a etapa 8 e recebi o erro Could not locate Gemfile.

Acho que consegui resolver a etapa 7, mas a etapa 8 ainda está me dando problemas e exibindo o erro mencionado acima.

[blake (Blake Erickson)]

@Decorbuz

Executei o passo 8 e recebi o erro Could not locate Gemfile.

Você precisa estar dentro do diretório do Discourse ao executar bundle install.

@techAPJ

Clonar o Discourse

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

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

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

Inicializar o Discourse

Mude para a pasta do Discourse:

cd ~/discourse

Instale os gems necessários:

bundle install

[JQ331]

@merefield

Na verdade, é um pouco mais do que alguns dólares (é um VPS de 4GB com 8 núcleos — provavelmente exagero), mas me permite desenvolver de qualquer lugar e em qualquer plataforma. É bastante performático, mas sempre haverá um atraso de alguns segundos se você reiniciar o servidor web.

Olá @merefield: Você poderia descrever um pouco mais sua configuração remota?

Ao desenvolver um tema, posso fazer alterações em um site ao vivo, mas para desenvolver um plugin, não vejo como evitar fazer isso na minha máquina local, com toda a base de código do Discourse ali (com meu plugin sobreposto).

O resultado é que, para qualquer alteração (que não seja CSS) ao codificar um plugin, ao recarregar: 1) minha ventoinha do computador entra em ação e 2) leva cerca de 30 segundos para recarregar. E se precisar reiniciar o servidor, leva vários minutos.

Esses atrasos realmente somam — com o resultado de que pode me levar uma hora para codificar algo que, com meu fluxo normal de codificação (onde há recarregamento automático ou, no máximo, 2 a 3 segundos por alteração), levaria 15 minutos.

Portanto, agradeceria qualquer sugestão para acelerar o processo.

[merefield (Robert)]

Isso provavelmente seria melhor no tópico do Ubuntu, pois estou apenas executando essa instalação em um servidor na nuvem, com nginx e DNS completo na frente (sem Docker), então estou realmente endereçando o domínio. Tudo é executado a partir do terminal. Até mesmo o Ember CLI está funcionando bem nesse ambiente agora.

Não é tão rápido assim, mas é suficientemente rápido. Tem a vantagem de permitir executar e testar serviços completos de callback HTTPS.

O ambiente de desenvolvimento de plugins mais rápido que conheço é, de longe, o Docker Dev local no WSL2, que voa. Além disso, é extremamente simples de manter. Infelizmente, o discourse_theme ainda não funciona nesse ambiente, pelo que sei, então voltei ao meu servidor na nuvem para esse trabalho.

É um pouco estranho por que a Apple está ficando para trás nisso? Os engenheiros da Microsoft mostraram-se muito astutos.

[Nacho_Caballero]

Caso alguém receba erros ao tentar instalar o ruby 2.7.3, aparentemente algo mudou após o Xcode 12, o que quebra o processo de instalação com o rbenv:

installing older Ruby versions on OSX after XCode 12

Eu continuava recebendo isso, mesmo tendo as versões mais recentes do psych e libyaml instaladas:

Parece que sua instalação de ruby está faltando o psych (para saída YAML).
Para eliminar este aviso, por favor, instale o libyaml e reinstale seu ruby.

Eu tentei a solução alternativa que eles sugerem no guia, mas continuei recebendo o mesmo erro e acabei tendo que usar o rvm:

rvm install 2.7.3

[JQ331]

Em relação a como programar mais rápido ao fazer um plugin, recentemente mudei minha abordagem. E está funcionando muito bem. Basicamente, mova todo o conteúdo de front-end para um componente de tema e codifique apenas o conteúdo de back-end no próprio plugin. Sei que outros já descobriram isso antes. Mas agora que estou fazendo isso, a programação é muito mais rápida e agradável. Detalhes aqui.