Instalar Discourse en Windows para desarrollo

[Discourse]

Este tutorial se ha probado en Windows 10 y 11.

Para configurar un entorno de desarrollo de Discourse en Windows, puedes hacerlo utilizando la función 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.

¡Empecemos!

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, pasemos a instalar Discourse en sí.

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 gemas necesarias

source ~/.bashrc
bundle install

Ahora que has instalado las gemas 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

Intenta ejecutar 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 de 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 de frontend; la aplicación sigue sirviéndose 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 abras Ubuntu en Windows tienes que iniciar manualmente el servicio de PostgreSQL y el servidor de Redis. No te preocupes, podemos tener una solución alternativa para esto 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 sale.

#!/bin/bash

# para iniciar PostgreSQL
sudo service postgresql start

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

Ahora modifica los permutos de CHMOD usando el siguiente comando

chmod +x start-discourse

Y copia el archivo a tu carpeta bin

sudo cp start-discourse /usr/bin/

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

start-discourse

---

Alternativamente, si estás usando Windows 10 enterprise, pro o education edition, entonces puedes crear una máquina virtual de 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 de Windows 10 2004 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, querrás 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 eso.

• Ve a: Descargar Windows 10
• Haz clic en el botón Actualizar ahora debajo de Windows 10 May 2020 Update para descargar el asistente de actualización y deja que se instale y termine
• Si obtienes algún error, descarga la herramienta de creación de medios, ejecútala y crea un disco flash arrancable (al menos 8GB de flash) y úsalo para instalar Windows.

Cuando termines con la instalación de Windows, necesitarás instalar manualmente WSL 2
Pero primero, necesitamos asegurarnos de que 2 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 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 tienes ambas características habilitadas:

• 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, whichever distro shows up in wsl -l -v
• La conversión toma tiempo, unos pocos 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 te encuentras con un error al instalar una de las gemas durante bundle install: Asegúrate de estar en Ubuntu-18.04 y no 20.04

Sin embargo, si ya tienes postgreSQL 12 y se está ejecutando en el puerto 5432, podrías encontrar 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 development y bajo adapter, agrega una nueva línea y luego agrega: port: 5433
• Asegúrate de hacer lo mismo para test y profile.

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á ejecutando 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 de Redis no válida a un puerto específico / conexión rechazada

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)

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 no válida al puerto de 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"?

De este error podemos ver que PostgreSQL está teniendo 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 en qué puerto está escuchando el servicio y, si es necesario, cambia el puerto al que quieras en postgresql.conf:

pg_isready

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

---

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 del terminal cmd predeterminado 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 tanto nuestras instancias de postgresql como 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

---

A partir de 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 otro problema que aparezca se puede 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 de Redis no válida a un puerto específico / conexión rechazada

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)

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 no válida al puerto de 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"?

De este error podemos ver que PostgreSQL está teniendo 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 en qué puerto está escuchando el servicio y, si es necesario, cambia el puerto al que quieras en postgresql.conf:

pg_isready

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

---

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 del terminal cmd predeterminado 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 tanto nuestras instancias de postgresql como 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

---

A partir de 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 otro problema que aparezca se puede abordar en el futuro.

---

Last Reviewed by @SaraDev on 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)