Instalar Discourse en Windows para desarrollo

[Discourse]

Este tutorial ha sido probado en Windows 10 y 11.

Para configurar un entorno de desarrollo para Discourse en Windows, puedes hacerlo utilizando la característica Windows Subsystem for Linux.

Esta configuración requiere la instalación de WSL 2. Solo está disponible en las compilaciones de Windows 10 18917 o superiores. Asumiremos que ya has instalado Windows Subsystem for Linux 2 (Ubuntu) en tu sistema Windows 10. ADVERTENCIA: Instala Ubuntu 18.04, y no 20.04, ya que algunas instalaciones fallarán en 20.04. Para más información, consulta las notas del 30 de junio de 2020 al final de esta publicación.

¡Comencemos!

Instalación de Discourse

1. Inicialmente, sigue los pasos del tema Guía para principiantes para instalar Discourse en Ubuntu para desarrollo hasta el paso Clonar Discourse.

@techAPJ

Instalar dependencias de Discourse

Necesitarás los siguientes paquetes en tu sistema:

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

** opcional

Ahora que hemos instalado las dependencias de Discourse, procedamos a instalar el propio Discourse.

2. Antes de configurar la base de datos, debes iniciar manualmente el servicio de PostgreSQL y el servidor de Redis usando los siguientes comandos:

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Luego, sigue todos los pasos restantes de la guía de Ubuntu.

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

Configurar la base de datos

Crea un rol con el mismo nombre que tu nombre de usuario del sistema Ubuntu:

sudo -u postgres createuser -s "$USER"

Inicializar Discourse

Cambia a tu carpeta de Discourse:

cd ~/discourse

Instala las gems necesarias:

source ~/.bashrc
bundle install

Ahora que has instalado las gems con éxito, ejecuta estos comandos:

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

Prueba ejecutando las pruebas:

bundle exec rake autospec

Todas las pruebas deberían pasar.

Inicia el servidor de Rails:

bundle exec rails server

Ahora deberías poder conectarte a tu aplicación Discourse en http://localhost:3000 — ¡pruébalo!

En una instancia de terminal separada, navega a tu carpeta de Discourse (cd ~/discourse) y ejecuta:

bin/dev --only ember

Esto inicia el empaquetador del frontend; la aplicación sigue siendo servida desde http://localhost:3000.

Crear un comando para iniciar Discourse

Ahora tu entorno de desarrollo está casi listo. El único problema es que cada vez que abres Ubuntu en Windows, tienes que iniciar manualmente el servicio de PostgreSQL y el servidor de Redis. No te preocupes, podemos tener una solución creando un comando personalizado

cd ~

Crea un nuevo archivo usando el comando nano start-discourse y pega el contenido a continuación, luego guarda y sal.

#!/bin/bash

# para iniciar PostgreSQL
sudo service postgresql start

# para iniciar el servidor de Redis
redis-server --daemonize yes

Ahora modifica los permisos CHMOD usando el siguiente comando:

chmod +x start-discourse

Y copia el archivo a tu carpeta bin:

sudo cp start-discourse /usr/bin/

Listo. Ahora, cada vez que abras la terminal bash de Ubuntu, simplemente ejecuta el siguiente comando y comienza a desarrollar

start-discourse

---

Alternativamente, si estás utilizando Windows 10 Enterprise, Pro o Education, puedes crear una máquina virtual Linux en Hyper-V para configurar el entorno de desarrollo de Discourse.

Notas sobre el entorno de Windows

A partir del 30 de junio de 2020:

@AndreaHabib

Con la introducción de la compilación 2004 de Windows 10 y WSL 2, muchos de ustedes podrían encontrar algunos problemas, ya que Discourse ahora requiere WSL 2 para ejecutarse realmente.
Para empezar: Si aún no lo has hecho, deberías actualizar tu sistema a Windows 2004 (19041).
Nota: No instales usando Windows Update en la configuración del sistema, ya que podrías obtener errores durante la instalación. Además, asegúrate de estar en Windows 1903 (18362) o 1909 (18363); puedes buscar winver para verificarlo.

• Ve a: Descargar Windows 10
• Haz clic en el botón Actualizar ahora bajo la Actualización de mayo de 2020 de Windows 10 para descargar el asistente de actualización y dejar que se instale y termine.
• Si obtienes algún error, descarga la herramienta de creación de medios, ejecútala y crea una unidad flash de arranque (al menos 8 GB) y úsala para instalar Windows.

Cuando termines la instalación de Windows, necesitarás instalar manualmente WSL 2.
Pero primero, debemos asegurarnos de que dos características estén habilitadas:

• Plataforma de máquina virtual, que se puede habilitar directamente desde tu Windows yendo a Programas y características y luego habilitando Características opcionales en Activar o desactivar características de Windows.
• La otra es la virtualización, que solo se puede habilitar desde tu BIOS. Sin embargo, esta opción puede variar de una placa base a otra. Por ejemplo, en AMD se llama SVM. Así que busca tu placa base específica.

Ahora que has habilitado ambas características:

• Instala Ubuntu 18.04, y no 20.04, ya que algunas instalaciones fallarán en 20.04.
• Ve aquí y actualiza el kernel de Linux: Enlace en las respuestas.
• Ve a este enlace y sigue los pasos: Instalar Windows Subsystem for Linux (WSL) en Windows 10 | Microsoft Docs
• Ve a PowerShell (ejecutar como administrador) y ejecuta: wsl --set-version Ubuntu-18.04 2 o wsl --set-version Ubuntu 2, según la distribución que aparezca en wsl -l -v.
• La conversión toma tiempo, unos minutos.
• Ejecuta wsl -l -v para asegurarte de que Ubuntu se está ejecutando en WSL 2.

Ahora puedes ejecutar Ubuntu-18.04 o Windows Terminal con Ubuntu y comenzar a instalar las dependencias y herramientas.

Nota: Si tienes un error al instalar una de las gems durante bundle install: Asegúrate de estar en Ubuntu-18.04 y no en 20.04.

Sin embargo, si ya tienes PostgreSQL 12 ejecutándose en el puerto 5432, podrías tener algunos problemas, ya que las dependencias instalan PostgreSQL 10, lo que podría incrementar el puerto a 5433.
Para solucionarlo:

• Abre tu carpeta en un editor de texto (VS Code, por ejemplo).
• Ve a config/database.yml.
• Bajo desarrollo y bajo adaptador, agrega una nueva línea y luego agrega: port: 5433.
• Asegúrate de hacer lo mismo para prueba y perfil.

Si lo anterior no funciona, asegúrate de verificar si PostgreSQL se está ejecutando y en qué puerto mediante pg_isready. Luego, sigue las mismas instrucciones anteriores, estableciendo el puerto igual al que está utilizando la base de datos.

PARA EL KERNEL DE LINUX: Actualizar el kernel de Linux de WSL 2 | Microsoft Docs

@RickyC0626

Una solución que no requiere configuración explícita de puertos en database.yml.

Algunos errores durante la creación y migración de la base de datos:

Conexión inválida a Redis en un puerto específico / rechazo de conexión

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error conectando a Redis en localhost:6379 (Errno::ECONNREFUSED)
...

Causado por:
Errno::ECONNREFUSED: Conexión rechazada - connect(2) para 127.0.0.1:6379
...

Causado por:
IO::EINPROGRESSWaitWritable: Operación ahora en progreso - connect(2) bloquearía
...

Tareas: TOP => db:create => db:load_config => environment
(Ve la traza completa ejecutando la tarea con --trace)

De este error podemos ver que el puerto que usa Redis es 6379, y podemos solucionarlo iniciando el servidor de Redis a través de ese puerto.

Por defecto, redis-server --daemonize yes debería funcionar, pero si no, usa:

redis-server --daemonize yes --port 6379

Verifica el estado de la instancia de Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Conexión inválida al puerto psql

bundle exec rake db:migrate

PG::ConnectionBad: no se pudo conectar al servidor: No existe tal archivo o directorio
       ¿Está el servidor ejecutándose localmente y aceptando
       conexiones en el socket de dominio Unix "/var/run/postgresql/.s.PGSQL.5432"?

De este error podemos ver que PostgreSQL tiene problemas para conectarse al puerto 5432. Por lo general, iniciar el servicio debería funcionar.

sudo service postgresql start

Si esto aún no funciona y el error persiste, intenta verificar desde qué puerto está escuchando el servicio y, si es necesario, cambia el puerto al que deseas en postgresql.conf:

pg_isready

/var/run/postgresql:5432 - sin respuesta
o
/var/run/postgresql:5432 - aceptando conexiones

---

El resultado

Una vez que hayamos hecho lo anterior o ejecutado el comando start-discourse, las dos instancias deberían ejecutarse en sus puertos predeterminados/especificados. Para verificar su estado a través de la terminal cmd predeterminada de Windows, podemos ejecutar:

netstat -anop tcp

lo que mostrará algo como esto:

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

Ahora hemos confirmado que ambas instancias de postgresql y redis-server se están ejecutando.

También podemos verificar el estado de las instancias en Ubuntu o WSL con los siguientes 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

---

Desde aquí, estos comandos deberían funcionar sin problemas mayores, sin necesidad de modificar el archivo database.yml:

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

Cualquier problema adicional que aparezca se podrá abordar en el futuro.

A partir del 1 de julio de 2020

@RickyC0626

Una solución que no requiere configuración explícita de puertos en database.yml.

Algunos errores durante la creación y migración de la base de datos:

Conexión inválida a Redis en un puerto específico / rechazo de conexión

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error conectando a Redis en localhost:6379 (Errno::ECONNREFUSED)
...

Causado por:
Errno::ECONNREFUSED: Conexión rechazada - connect(2) para 127.0.0.1:6379
...

Causado por:
IO::EINPROGRESSWaitWritable: Operación ahora en progreso - connect(2) bloquearía
...

Tareas: TOP => db:create => db:load_config => environment
(Ve la traza completa ejecutando la tarea con --trace)

De este error podemos ver que el puerto que usa Redis es 6379, y podemos solucionarlo iniciando el servidor de Redis a través de ese puerto.

Por defecto, redis-server --daemonize yes debería funcionar, pero si no, usa:

redis-server --daemonize yes --port 6379

Verifica el estado de la instancia de Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Conexión inválida al puerto psql

bundle exec rake db:migrate

PG::ConnectionBad: no se pudo conectar al servidor: No existe tal archivo o directorio
       ¿Está el servidor ejecutándose localmente y aceptando
       conexiones en el socket de dominio Unix "/var/run/postgresql/.s.PGSQL.5432"?

De este error podemos ver que PostgreSQL tiene problemas para conectarse al puerto 5432. Por lo general, iniciar el servicio debería funcionar.

sudo service postgresql start

Si esto aún no funciona y el error persiste, intenta verificar desde qué puerto está escuchando el servicio y, si es necesario, cambia el puerto al que deseas en postgresql.conf:

pg_isready

/var/run/postgresql:5432 - sin respuesta
o
/var/run/postgresql:5432 - aceptando conexiones

---

El resultado

Una vez que hayamos hecho lo anterior o ejecutado el comando start-discourse, las dos instancias deberían ejecutarse en sus puertos predeterminados/especificados. Para verificar su estado a través de la terminal cmd predeterminada de Windows, podemos ejecutar:

netstat -anop tcp

lo que mostrará algo como esto:

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

Ahora hemos confirmado que ambas instancias de postgresql y redis-server se están ejecutando.

También podemos verificar el estado de las instancias en Ubuntu o WSL con los siguientes 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

---

Desde aquí, estos comandos deberían funcionar sin problemas mayores, sin necesidad de modificar el archivo database.yml:

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

Cualquier problema adicional que aparezca se podrá abordar en el futuro.

---

Última revisión por @SaraDev el 2022-06-16T02:00:00Z

---

Este documento está controlado por versiones: sugiere cambios en GitHub.

[Arkshine]

@Arkshine

En un Ubuntu 22 recién instalado (Windows 10, WSL2) y con una instalación exitosa de Discourse, todas las imágenes fallan al ser servidas en el puerto predeterminado 4200.

Bien, encontré una solución.

Noté que reemplazar 127.0.0.1 con localhost solucionaba las imágenes.

Después de buscar un poco, este es el comando que puedes usar para iniciar Discourse:

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

---

Intentaré actualizar la guía más tarde.

[Arkshine]

¿Hay alguna posibilidad de revisar esta PR?

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

Eso haría esta guía un poco más amigable.

[Will_S1 (Will S)]

¿Alguna idea de por qué obtengo “Desafortunadamente, ocurrió un error inesperado y Bundler no puede continuar”. Después de bundle install?

[D111 (D)]

mismo problema

[sam (Sam Saffron)]

¿Puede proporcionar una captura de pantalla del error? ¿Qué versión de Ruby tiene instalada?

[frocm]

Tengo problemas con las dependencias:

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
Debes usar Bundler 2 o superior con este lockfile.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versión de Bundler 1.16.1

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

Fetching: bundler-2.4.20.gem (100%)
ERROR:  Mientras se ejecutaba gem ... (Gem::FilePermissionError)
    No tienes permisos de escritura para el directorio /var/lib/gems/2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] contraseña para ux430uq:
Fetching: bundler-2.4.20.gem (100%)
ERROR:  Error al instalar bundler:
        La última versión de bundler (>= 0) que admitía tu Ruby y RubyGems fue la 2.3.26. Intenta instalarla con `gem install bundler -v 2.3.26`
        bundler requiere la versión de Ruby >= 2.6.0. La versión actual de ruby es 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versión de Bundler 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

¿Cómo puedo solucionarlo fácilmente? Estaba intentando instalar 2.6.0, luego 2.7.0, pero siempre hay otros problemas con esto.

[AliBenBongo]

Según algunos de los comentarios anteriores, yo también tuve algunas dificultades y errores al intentar seguir esta guía; probé tanto en un escritorio con Windows 10 como con Windows 11.

Después de un poco de prueba y error, finalmente tengo los pasos que resultan en un entorno de desarrollo completamente funcional en Windows 11, probado en la última compilación 22H2 y también en la próxima vista previa de lanzamiento 23H2 (supongo que también funcionará en la compilación más reciente de Windows 10).

Si a alguien le sirve, acabo de publicar la guía aquí:-

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 esto ayude a personas como yo que intentan ejecutar Discourse en Windows

[Canapin (Coin-coin le Canapin)]

Revisé esta guía oficial completa nuevamente para asegurarme de que nada se rompiera desde mi último intento.
Instalé Ubuntu (versión no especificada) a través de WSL en Windows 11, lo que instaló la última versión LTS, 22.04 en este caso.

No encontré ningún problema; todo fue sencillo, sin errores, y la instalación de desarrollo funciona.

Si tienes problemas para instalar algo usando una de nuestras guías oficiales en el futuro, por favor anota los errores y repórtalos, ¡siempre es útil!

---

Dos advertencias, sin embargo:

Al instalar Node.js:

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

                           ADVERTENCIA DE DESAPROBACIÓN DE SCRIPT


  Este script, ubicado en https://deb.nodesource.com/setup_X, que se usaba para
  instalar Node.js, ahora está obsoleto y eventualmente se desactivará.

  Por favor, visita el repositorio de Github de distribuciones de NodeSource y sigue las
  instrucciones para migrar tu repositorio.
  https://github.com/nodesource/distributions

  El repositorio de Github de distribuciones de Linux de NodeSource para Node.js contiene
  información sobre qué versiones de Node.js y qué distribuciones de Linux
  son compatibles y cómo instalarlo.
  https://github.com/nodesource/distributions


                          ADVERTENCIA DE DESAPROBACIÓN DE SCRIPT

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

PARA EVITAR ESTA ESPERA, MIGRAR EL SCRIPT
Continuando en 60 segundos (presiona Ctrl-C para abortar) ...

Al ejecutar redis-server --daemonize yes:

# ¡ADVERTENCIA! El overcommit de memoria debe estar habilitado. Sin él, un guardado en segundo plano o la replicación pueden fallar en condiciones de poca memoria. Al estar deshabilitado, también puede causar fallos sin condiciones de poca memoria, ver https://github.com/jemalloc/jemalloc/issues/1328. Para solucionar este problema, agrega 'vm.overcommit_memory = 1' a /etc/sysctl.conf y luego reinicia o ejecuta el comando 'sysctl vm.overcommit_memory=1' para que tenga efecto.

[AliBenBongo]

¡No estaba seguro de por qué tuve tantos problemas entonces! ¡Quizás había algo extraño en mi instalación de Windows que logré arreglar durante mi solución de problemas sin darme cuenta!

Aún así, todavía estoy contento con lo que he aprendido hasta ahora y espero seguir trabajando en la migración de mis foros a Discourse.

[Arkshine]

@Canapin

Volví a repasar esta guía oficial para asegurarme de que nada se rompiera desde mi último intento.

Tuve que reinstalar Windows y ahora tengo una instalación limpia de Windows 11.
Seguiré la guía y reportaré más tarde. Tendré en cuenta la guía de @AliBenBongo también.

[Arkshine]

Aquí tienes un seguimiento.

La guía seguramente necesita una actualización, pero todavía funciona de maravilla en una instalación limpia de Windows 11 22H2.

El único problema que tuve fue que, aunque el comando wsl funcionaba en una terminal, la característica WSL en realidad no estaba habilitada por defecto:

[NateDhaliwal]

Creo que esta guía está desactualizada. Los pasos mencionados en la guía de Ubuntu/Debian ya no existen.

[NateDhaliwal]

¿Hay alguna forma de deshacer todos estos pasos, por ejemplo, revertir el script de instalación de paquetes, gems y clonación?

[TempAccount]

@Discourse

ADVERTENCIA: Instala Ubuntu 18.04 y no 20.04, ya que algunas instalaciones fallarán en 20.04.

¿Sigue siendo necesario instalar 18.04 sobre 20.04?

Recibo un error al instalar nodejs:

# apt install nodejs

Leyendo lista de paquetes... Hecho
Creando árbol de dependencias

[saros]

@Arkshine

¡Listo! He encontrado una solución.

He notado que reemplazar 127.0.0.1 por localhost resuelve el problema de las imágenes.

Tras buscar un poco, puedes usar el siguiente comando para iniciar Diwsl:

Instalación en 24.04 fallida; el host no puede conectarse al puerto 3000.

[merefield (Robert)]

Lo tengo ejecutándose en 24.04. Recomiendo compartir más información sobre cómo se ven las cosas al iniciar el servidor.

Prueba FORCE_HOSTNAME=localhost bin/ember-cli -u, lo cual ejecutará simultáneamente los servidores de backend y frontend.

(De camino: de memoria)