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.