Installa Discourse su Windows per lo sviluppo

[Discourse]

Questa guida è stata testata su Windows 10 e 11.

Per configurare un ambiente di sviluppo per Discourse su Windows, puoi utilizzare la funzionalità Windows Subsystem for Linux.

Questa configurazione richiede l’installazione di WSL 2. È disponibile solo nelle build di Windows 10 18917 o successive. Diamo per scontato che tu abbia già installato Windows Subsystem for Linux 2 (Ubuntu) sul tuo sistema Windows 10. ATTENZIONE: Installa Ubuntu 18.04 e non 20.04, poiché alcune installazioni potrebbero fallire su 20.04. Per ulteriori informazioni, consulta le note del 30 giugno 2020 alla fine di questo post.

Iniziamo!

Installazione di Discourse

1. Inizialmente, segui i passaggi del topic Guida per principianti per installare Discourse su Ubuntu per lo sviluppo fino al passaggio Clona Discourse.

@techAPJ

Installare le dipendenze di Discourse

Avrai bisogno dei seguenti pacchetti sul tuo sistema:

• Git
• rbenv o asdf
• ruby-build
• Ruby (ultima versione stabile)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** opzionale

Ora che abbiamo installato le dipendenze di Discourse, procediamo con l’installazione di Discourse stesso.

2. Prima di configurare il database, devi avviare manualmente il servizio PostgreSQL e il server Redis utilizzando i seguenti comandi:

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Quindi segui tutti i passaggi rimanenti della guida Ubuntu.

@techAPJ

Clonare Discourse

Clona il repository di Discourse nella cartella ~/discourse:

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

~ indica la cartella home, quindi il codice sorgente di Discourse sarà disponibile nella tua cartella home.

Configurare il database

Crea un ruolo con lo stesso nome del tuo username di sistema Ubuntu:

sudo -u postgres createuser -s "$USER"

Avviare Discourse

Passa alla cartella di Discourse:

cd ~/discourse

Installa i gem necessari:

source ~/.bashrc
bundle install

Ora che hai installato con successo i gem, esegui questi comandi:

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

Prova a eseguire gli spec:

bundle exec rake autospec

Tutti i test dovrebbero essere superati.

Avvia il server Rails:

bundle exec rails server

Ora dovresti essere in grado di connetterti alla tua applicazione Discourse su http://localhost:3000 - provaci!

In un’istanza separata del terminale, naviga nella cartella di Discourse (cd ~/discourse) ed esegui:

bin/dev --only ember

Questo avvia il bundler del frontend; l’app rimane servita da http://localhost:3000.

Creare un comando per avviare Discourse

Ora il tuo ambiente di sviluppo è quasi pronto. L’unico problema è che ogni volta che apri Ubuntu su Windows devi avviare manualmente il servizio PostgreSQL e il server Redis. Non preoccuparti, possiamo trovare una soluzione creando un comando personalizzato

cd ~

Crea un nuovo file utilizzando il comando nano start-discourse, incolla il contenuto sottostante, quindi salva ed esci.

#!/bin/bash

# per avviare PostgreSQL
sudo service postgresql start

# per avviare il server Redis
redis-server --daemonize yes

Ora modifica i permessi CHMOD utilizzando il comando seguente:

chmod +x start-discourse

E copia il file nella tua cartella bin:

sudo cp start-discourse /usr/bin/

È fatto. Ora, ogni volta che apri la shell di Ubuntu, esegui semplicemente il comando sottostante e inizia a sviluppare

start-discourse

---

In alternativa, se stai utilizzando Windows 10 Enterprise, Pro o Education, puoi creare una macchina virtuale Linux in Hyper-V per configurare l’ambiente di sviluppo di Discourse.

Note sull’ambiente Windows

A partire dal 30 giugno 2020:

@AndreaHabib

Con l’introduzione della build 2004 di Windows 10 e di WSL 2, molti di voi potrebbero riscontrare alcuni problemi, dato che Discourse richiede ora WSL 2 per funzionare effettivamente.
Per iniziare: Se non l’hai già fatto, dovresti aggiornare il tuo sistema a Windows 2004 (19041).
Nota: Non installare utilizzando Windows Update nelle impostazioni di sistema, poiché potresti riscontrare errori durante l’installazione. Assicurati inoltre di essere su Windows 1903 (18362) o 1909 (18363); puoi cercare winver per verificare.

• Vai a: Scarica Windows 10
• Clicca sul pulsante Aggiorna ora sotto Aggiornamento di Windows 10 di maggio 2020 per scaricare l’assistente di aggiornamento e lascialo completare l’installazione.
• Se ricevi errori, scarica lo strumento di creazione supporti, avvialo e crea una chiavetta USB avviabile (almeno 8 GB) e usala per installare Windows.

Quando hai completato l’installazione di Windows, dovrai installare manualmente WSL 2.
Ma prima, dobbiamo assicurarci che due funzionalità siano abilitate:

• Piattaforma macchina virtuale, che può essere abilitata direttamente da Windows andando su Programmi e funzionalità e poi abilitando Funzionalità opzionali in Attiva o disattiva funzionalità di Windows.
• L’altra è la virtualizzazione, che può essere abilitata solo dal BIOS. Tuttavia, questa opzione può variare da una scheda madre all’altra. Ad esempio, su AMD è chiamata SVM. Quindi consulta la tua scheda madre specifica.

Ora che hai abilitato entrambe le funzionalità:

• Installa Ubuntu 18.04 e non 20.04, poiché alcune installazioni potrebbero fallire su 20.04.
• Vai qui e aggiorna il kernel Linux: Link nelle risposte.
• Vai a questo link e segui i passaggi: Installa Windows Subsystem for Linux (WSL) su Windows 10 | Microsoft Docs.
• Vai a PowerShell (esegui come amministratore) ed esegui: wsl --set-version Ubuntu-18.04 2 o wsl --set-version Ubuntu 2, a seconda della distribuzione che appare in wsl -l -v.
• La conversione richiede tempo, alcuni minuti.
• Esegui wsl -l -v per assicurarti che Ubuntu stia funzionando su WSL 2.

Ora puoi eseguire Ubuntu-18.04 o Windows Terminal con Ubuntu e iniziare a installare le dipendenze e gli strumenti.

Nota: Se riscontri un errore durante l’installazione di uno dei gem durante bundle install: Assicurati di essere su Ubuntu-18.04 e non 20.04.

Tuttavia, se hai già PostgreSQL 12 in esecuzione sulla porta 5432, potresti riscontrare alcuni problemi, poiché le dipendenze installano PostgreSQL 10, che potrebbe incrementare la porta a 5433.
Per risolvere il problema:

• Apri la tua cartella in un editor di testo (ad esempio VS Code).
• Vai a config/database.yml.
• Sotto development e sotto adapter, aggiungi una nuova riga e poi aggiungi: port: 5433.
• Assicurati di fare lo stesso per test e profile.

Se quanto sopra non funziona, assicurati di verificare se PostgreSQL è in esecuzione e su quale porta tramite pg_isready. Quindi segui le stesse istruzioni sopra, impostando la porta uguale a quella su cui è in esecuzione il database.

PER IL KERNEL LINUX: Aggiornamento del kernel Linux di WSL 2 | Microsoft Docs

@RickyC0626

Una soluzione che non richiede una configurazione esplicita della porta in database.yml.

Alcuni errori durante la creazione e la migrazione del database:

Connessione Redis non valida a una porta specifica / rifiuto della connessione

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
(Vedi la traccia completa eseguendo il task con --trace)

Da questo errore possiamo vedere che la porta utilizzata da Redis è 6379, e possiamo risolvere questo problema avviando il server Redis tramite quella porta.

Per impostazione predefinita, redis-server --daemonize yes dovrebbe funzionare, ma se non funziona, usa:

redis-server --daemonize yes --port 6379

Controlla lo stato dell’istanza Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Connessione non valida alla porta 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"?

Da questo errore possiamo vedere che PostgreSQL ha problemi a connettersi alla porta 5432. Di solito, avviare il servizio dovrebbe funzionare.

sudo service postgresql start

Se questo non funziona ancora e l’errore persiste, prova a verificare su quale porta il servizio sta ascoltando e, se necessario, cambia la porta su quella desiderata in postgresql.conf:

pg_isready

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

---

Il risultato

Una volta completato quanto sopra o eseguito il comando start-discourse, le due istanze dovrebbero essere in esecuzione sulle loro porte predefinite/specificate. Per verificarne lo stato tramite il terminale cmd predefinito di Windows, possiamo eseguire:

netstat -anop tcp

che mostrerà qualcosa di simile a questo:

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

Abbiamo ora confermato che entrambe le istanze postgresql e redis-server sono in esecuzione.

Possiamo anche controllare lo stato delle istanze su Ubuntu o WSL con i seguenti comandi:

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

---

Da qui, questi comandi dovrebbero funzionare senza problemi significativi, senza bisogno di modificare il file database.yml:

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

Eventuali ulteriori problemi che si presentano potranno essere affrontati in futuro.

A partire dal 1 luglio 2020

@RickyC0626

Una soluzione che non richiede una configurazione esplicita della porta in database.yml.

Alcuni errori durante la creazione e la migrazione del database:

Connessione Redis non valida a una porta specifica / rifiuto della connessione

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
(Vedi la traccia completa eseguendo il task con --trace)

Da questo errore possiamo vedere che la porta utilizzata da Redis è 6379, e possiamo risolvere questo problema avviando il server Redis tramite quella porta.

Per impostazione predefinita, redis-server --daemonize yes dovrebbe funzionare, ma se non funziona, usa:

redis-server --daemonize yes --port 6379

Controlla lo stato dell’istanza Redis:

redis-cli

127.0.0.1:6379> ping
PONG

Connessione non valida alla porta 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"?

Da questo errore possiamo vedere che PostgreSQL ha problemi a connettersi alla porta 5432. Di solito, avviare il servizio dovrebbe funzionare.

sudo service postgresql start

Se questo non funziona ancora e l’errore persiste, prova a verificare su quale porta il servizio sta ascoltando e, se necessario, cambia la porta su quella desiderata in postgresql.conf:

pg_isready

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

---

Il risultato

Una volta completato quanto sopra o eseguito il comando start-discourse, le due istanze dovrebbero essere in esecuzione sulle loro porte predefinite/specificate. Per verificarne lo stato tramite il terminale cmd predefinito di Windows, possiamo eseguire:

netstat -anop tcp

che mostrerà qualcosa di simile a questo:

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

Abbiamo ora confermato che entrambe le istanze postgresql e redis-server sono in esecuzione.

Possiamo anche controllare lo stato delle istanze su Ubuntu o WSL con i seguenti comandi:

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

---

Da qui, questi comandi dovrebbero funzionare senza problemi significativi, senza bisogno di modificare il file database.yml:

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

Eventuali ulteriori problemi che si presentano potranno essere affrontati in futuro.

---

Ultima revisione da @SaraDev il 2022-06-16T02:00:00Z

---

Questo documento è sottoposto a controllo versione - suggerisci modifiche su GitHub.