Instalar Discourse en macOS para desarrollo

[Discourse]

Esta guía cubre las instrucciones de instalación para un entorno de desarrollo en macOS. Para guías de producción, consulte: Install Discourse in production with the official supported instructions

¿Quieres configurar Discourse en macOS para hackear y desarrollar?

Asumiremos que no tienes Ruby/Rails/Postgres/Redis instalados en tu Mac. ¡Comencemos !

Instalar dependencias de Discourse

Necesitarás los siguientes paquetes en tu sistema:

• Git
• rbenv o asdf
• ruby-build
• Ruby (versión estable más reciente)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

Opcional

reinicia tu terminal

Ahora que hemos instalado las dependencias de Discourse, procedamos a instalar Discourse en sí.

Reinicia tu Terminal

Salir de tu shell y reiniciarla garantiza que las rutas a los paquetes instalados sean detectadas correctamente por la Terminal.

Clonar Discourse

Clona el repositorio de Discourse en la carpeta ~/discourse:

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

~ indica la carpeta de inicio, por lo que el código fuente de Discourse estará disponible en tu carpeta de inicio.

Inicializar Discourse

Cambia a tu carpeta de Discourse:

cd ~/discourse

Instala las gemas necesarias:

bundle install

Instala las dependencias de JS:

pnpm install

A continuación, ejecuta estos comandos para configurar tu instancia local de Discourse:

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

Inicia los servidores de Rails + Ember; tienes dos opciones aquí.

Opción 1: usando dos pestañas/ventanas de Terminal separadas, ejecuta Rails y el empaquetador del frontend por separado mediante:

bundle exec rails server

y

bin/dev --only ember

Opción 2: usando solo una pestaña/ventana de Terminal:

bin/dev # ejecuta Pitchfork y el empaquetador del frontend juntos

Ahora deberías poder navegar a http://localhost:3000 para ver tu instalación local de Discourse. (Ten en cuenta que la primera carga puede tardar hasta un minuto mientras el servidor se calienta.)

También puedes intentar ejecutar las especificaciones:

bundle exec rake autospec

Todas (o casi todas) las pruebas deberían pasar.

Crear nuevo administrador

Para crear un nuevo administrador, ejecuta el siguiente comando:

RAILS_ENV=development bundle exec rake admin:create

Sigue las indicaciones para crear una cuenta de administrador.

Configurar correo

Ejecuta MailHog:

mailhog

---

¡Felicidades! Ahora eres el administrador de tu propia instalación de Discourse.

¡Feliz hacking! Para comenzar, consulta la Guía para principiantes sobre la creación de complementos de Discourse.

---

Este documento está controlado por versiones: sugiere cambios en 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]

Utilizando la guía del foro de Ruby on Rails, actualmente estoy atascado en el paso 7.

Esta es probablemente una pregunta muy de “principiante”, pero ¿cómo “apunto” a la rama experimental que se vinculó en ese tema? Probé varias cosas y cada vez me daba el mensaje Unknown command mini_racer.

[blake (Blake Erickson)]

Están bien preguntando aquí.

Hay algunas instrucciones específicas para m1 que escribimos y que referenciamos en el foro de Rails en esta guía.

@Decorbuz

Esta probablemente sea una pregunta muy de “principiante”, pero ¿cómo “apunto” a la rama experimental que estaba vinculada en ese tema?

Tendría que revisar mi m1 Air más tarde, y quizás mis compañeros de trabajo que configuraron recientemente nuevos Macs podrían saber mejor si esto aún es necesario, pero hay un ejemplo de cómo apuntar a una rama en el paso 7:

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

Entonces, deberías editar esta línea en tu versión local de discourse/Gemfile:

Gemfile

y luego ejecutar bundle install.

[Decorbuz]

@pfaffman

Si no seguiste estas instrucciones (no veo un paso 7), entonces este no es un buen lugar para hacer tu pregunta.

Está enlazado justo en la parte superior de la publicación original.

El tema del foro de Ruby on Rails lleva meses inactivo. El autor original (OP) no ha estado activo desde febrero y no ha respondido a ningún comentario allí pidiendo ayuda.

Aquí hay más personas que pueden ayudarme. Solo digo.

@blake

Hay un ejemplo de cómo apuntar a una rama en el paso 7:

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

Intenté copiar eso en la Terminal y recibí el mismo error Unknown command mini_racer, que antes.

Admito que la guía del foro de Ruby on Rails no es tan clara como esperaba en ese sentido.

Mis disculpas de antemano…

[blake (Blake Erickson)]

@Decorbuz

Intenté copiar eso en la Terminal y recibí el mismo error de “Comando desconocido mini_racer” que antes.

No es un comando para ejecutar. Necesitarás EDITAR el archivo de texto real llamado “Gemfile” ubicado dentro del directorio de Discourse.

[Decorbuz]

@blake

Necesitarás EDITAR el archivo de texto real llamado “Gemfile” ubicado dentro del directorio de Discourse.

¡Doh!

¡Gracias! Lo intentaré ahora mismo.

En mi opinión, alguien debería editar la guía del foro de Ruby on Rails y proporcionar mayor claridad sobre el paso 7. Solo son mis dos centavos, aunque.

Vuelvo enseguida. Un momento…

[blake (Blake Erickson)]

Lo siento, tengo que irme, pero creo que la corrección de mini_racer para Macs M1 ya ha sido integrada. Acabo de verificar mi Gemfile en mi Mac M1 y no ha sido editado. Así que creo que puedes omitir el paso 7.

[Decorbuz]

Ejecuté el paso 8 y recibí el error Could not locate Gemfile.

(Pienso) que pude resolver el paso 7, pero el paso 8 sigue dándome problemas y muestra el error mencionado anteriormente.

[blake (Blake Erickson)]

@Decorbuz

Ejecuté el paso 8 y recibí el error Could not locate Gemfile.

Debes estar dentro del directorio de Discourse cuando ejecutes bundle install.

@techAPJ

Clonar Discourse

Clona el repositorio de Discourse en la carpeta ~/discourse:

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

~ indica la carpeta de inicio, por lo que el código fuente de Discourse estará disponible en tu carpeta de inicio.

Inicializar Discourse

Cambia a tu carpeta de Discourse:

cd ~/discourse

Instala las gems necesarias

bundle install

[JQ331]

@merefield

En realidad es un poco más que un par de dólares (es un VPS de 4 GB y 8 núcleos, probablemente excesivo), pero me permite desarrollar desde cualquier lugar y en cualquier plataforma. Es bastante eficiente, pero siempre habrá unos segundos de retraso si reinicias el servidor web.

Hola @merefield: ¿Puedes describir un poco más tu configuración remota?

Si bien desarrollar un tema me permite aplicar cambios en un sitio en vivo, para desarrollar un plugin no veo otra forma que hacerlo en mi máquina local, teniendo todo el código base de Discourse allí (con mi plugin encima).

El resultado es que para cualquier cambio (que no sea de CSS) al codificar un plugin, cuando lo recargo 1) se encienden los ventiladores de mi computadora y 2) tarda unos sólidos 30 segundos en recargarse. Y si necesito reiniciar el servidor, tarda varios minutos.

Esos retrasos se acumulan, con el resultado de que podría tardar una hora en codificar algo que, con mi flujo de codificación normal (donde hay recarga en caliente o como máximo 2-3 segundos por cambio), tardaría 15 minutos.

Por lo tanto, agradecería cualquier sugerencia para acelerar las cosas.

[merefield (Robert)]

Esto, argumentablemente, estaría mejor en el tema de Ubuntu, ya que solo estoy ejecutando esa instalación en un servidor en la nube, con nginx y un DNS completo (sin docker), por lo que en realidad estoy abordando el dominio. Ejecutando todo desde la terminal. Incluso he conseguido que Ember CLI funcione bien en esa configuración ahora.

Tampoco es tan rápido, pero lo suficientemente rápido. Tiene el beneficio de poder ejecutar y probar servicios completos de devolución de llamadas https.

El entorno de desarrollo de plugins más rápido con el que estoy familiarizado es Docker Dev en WSL2, que funciona a la perfección. También es extremadamente fácil de mantener. Desafortunadamente, discourse_theme aún no funciona en ese entorno, hasta donde sé, así que he vuelto a mi servidor en la nube para ese trabajo.

Es un poco extraño por qué Apple se está quedando atrás aquí. Los ingenieros de Microsoft han demostrado ser muy astutos.

[Nacho_Caballero]

En caso de que alguien reciba errores al intentar instalar ruby 2.7.3, aparentemente algo cambió después de Xcode 12 que rompe el proceso de instalación con rbenv:

installing older Ruby versions on OSX after XCode 12

Seguí recibiendo esto, a pesar de tener las últimas versiones de psych y libyaml instaladas:

Parece que a tu instalación de ruby le falta psych (para la salida YAML).
Para eliminar esta advertencia, por favor instala libyaml y reinstala tu ruby.

Intenté la solución alternativa que sugieren en la guía, pero seguí recibiendo el mismo error y terminé teniendo que usar rvm:

rvm install 2.7.3

[JQ331]

En cuanto a cómo programar más rápido al crear un plugin, recientemente he cambiado mi enfoque. Y está funcionando muy bien. Básicamente, mueve todo el contenido del frontend a un componente temático y solo codifica las cosas del backend en el propio plugin. Sé que otros ya lo han descubierto antes. Pero ahora que lo estoy haciendo, la programación es mucho más rápida y agradable. Detalles aquí.