Installare Discourse su Windows per lo sviluppo

[Discourse]

Questo tutorial è stato testato su Windows 10 e 11.

Per configurare un ambiente di sviluppo per Discourse su Windows, puoi farlo utilizzando la funzione Windows Subsystem for Linux.

Questa configurazione richiede l’installazione di WSL 2. È disponibile solo nelle build di Windows 10 18917 o successive. Daremo 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 falliranno su 20.04. Per ulteriori informazioni, vedi le note del 30 giugno 2020 in fondo a questo post.

Iniziamo!

Installazione di Discourse

1. Inizialmente segui i passaggi dell’argomento Guida per principianti all’installazione di Discourse su Ubuntu per lo sviluppo fino al passaggio Clona Discourse.

@techAPJ

Installa 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, passiamo all’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 per Ubuntu.

@techAPJ

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

Configura il database

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

sudo -u postgres createuser -s "$USER"

Avvia Discourse (Bootstrap)

Passa alla tua cartella Discourse:

cd ~/discourse

Installa le gemme necessarie

source ~/.bashrc
bundle install

Ora che hai installato con successo le gemme, 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 passare.

Avvia il server Rails:

bundle exec rails server

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

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

bin/dev --only ember

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

Creazione di 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 usando il comando nano start-discourse e incolla il contenuto sottostante, poi salva ed esci.

#!/bin/bash

# per avviare PostgreSQL
sudo service postgresql start

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

Ora modifica le CHMOD usando il comando sottostante

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 bash di Ubuntu, esegui semplicemente il comando sottostante e inizia a sviluppare

start-discourse

---

In alternativa, se stai utilizzando Windows 10 enterprise, pro o education edition, puoi creare una macchina virtuale Linux in hyper-v per configurare l’ambiente di sviluppo di Discourse.

Note sull’ambiente Windows

Al 30 giugno 2020:

@AndreaHabib

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

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

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

• Piattaforma Macchina Virtuale che può essere abilitata direttamente da Windows andando su Programmi e funzionalità e poi abilitando Funzionalità facoltative in Attiva o disattiva funzionalità di Windows
• L’altra è la Virtualizzazione che può essere abilitata solo dal tuo BIOS. Tuttavia, questa opzione può variare da una scheda madre all’altra. ad esempio: su AMD si chiama SVM. Quindi cerca la tua scheda madre specifica.

Ora che hai entrambe le funzionalità abilitate:

• Installa Ubuntu 18.04, e non 20.04 poiché alcune installazioni falliranno 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 | Documentazione Microsoft
• Vai su powershell (esegui come amministratore) ed esegui: wsl --set-version Ubuntu-18.04 2 o wsl --set-version Ubuntu 2, a seconda della distro che appare in wsl -l -v
• La conversione richiede tempo, alcuni minuti
• Esegui wsl -l -v per assicurarti che Ubuntu sia in esecuzione 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 stai riscontrando un errore durante l’installazione di una delle gemme 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 (VS Code ad esempio)
• 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. Segui quindi le stesse istruzioni sopra, impostando la porta uguale a quella su cui è in esecuzione il database.

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

@RickyC0626

Una soluzione che non richiede la 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
(See full trace by running task with --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.

Di default, redis-server --daemonize yes dovrebbe funzionare, ma se non dovesse funzionare, usa:

redis-server --daemonize yes --port 6379

Verifica 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 dovesse funzionare e l’errore persiste, prova a verificare su quale porta il servizio è in ascolto e, se necessario, cambia la porta a 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 del genere:

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 nostre istanze postgresql e redis-server sono in esecuzione.

Possiamo anche verificare 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 maggiori, 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

Qualsiasi ulteriore problema che dovesse sorgere può essere affrontato in futuro.

Al 1 luglio 2020

@RickyC0626

Una soluzione che non richiede la 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
(See full trace by running task with --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.

Di default, redis-server --daemonize yes dovrebbe funzionare, ma se non dovesse funzionare, usa:

redis-server --daemonize yes --port 6379

Verifica 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 dovesse funzionare e l’errore persiste, prova a verificare su quale porta il servizio è in ascolto e, se necessario, cambia la porta a 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 del genere:

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 nostre istanze postgresql e redis-server sono in esecuzione.

Possiamo anche verificare 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 maggiori, 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

Qualsiasi ulteriore problema che dovesse sorgere può essere affrontato in futuro.

---

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

---

Questo documento è sotto controllo versione - suggerisci modifiche su github.

[Arkshine]

@Arkshine

Su una nuova installazione di Ubuntu 22 (Windows 10, WSL2) e un’installazione di Discourse riuscita, tutte le immagini non vengono servite sulla porta predefinita 4200.

Ok, ho trovato una soluzione.

Ho notato che sostituire 127.0.0.1 con localhost risolveva il problema delle immagini.

Dopo aver cercato un po’, questo è il comando che puoi usare per avviare Discourse:

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

---

Tenterò di aggiornare la guida più tardi.

[Arkshine]

C’è qualche possibilità di rivedere questa PR?

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

Questo renderebbe questa guida un po’ più amichevole.

[Will_S1 (Will S)]

Hai qualche idea sul motivo per cui ricevo "Sfortunatamente, si è verificato un errore imprevisto e Bundler non può continuare." dopo bundle install\n?

[D111 (D)]

stesso problema

[sam (Sam Saffron)]

Puoi fornire uno screenshot dell’errore? Quale versione di Ruby hai installato?

[frocm]

Ho problemi con le dipendenze:

ux430uq@Asus-UX430UQ:~/discourse$ bundle install
Devi usare Bundler 2 o superiore con questo lockfile.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versione di Bundler 1.16.1

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

Fetching: bundler-2.4.20.gem (100%)
ERRORE:  Durante l'esecuzione di gem ... (Gem::FilePermissionError)
    Non hai i permessi di scrittura per la directory /var/lib/gems/2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$
ux430uq@Asus-UX430UQ:~/discourse$ sudo gem install bundler
[sudo] password per ux430uq:
Fetching: bundler-2.4.20.gem (100%)
ERRORE:  Errore durante l'installazione di bundler:
        L'ultima versione di bundler (>= 0) che supportava il tuo Ruby e RubyGems era la 2.3.26. Prova a installarla con `gem install bundler -v 2.3.26`
        bundler richiede la versione di Ruby >= 2.6.0. La versione corrente di ruby è 2.5.0.
ux430uq@Asus-UX430UQ:~/discourse$ bundler -v
Versione di Bundler 1.16.1
ux430uq@Asus-UX430UQ:~/discourse$

Come posso risolvere facilmente? Stavo cercando di installare la 2.6.0, poi la 2.7.0, ma ci sono sempre altri problemi.

[AliBenBongo]

Come da alcuni commenti precedenti, anch’io ho riscontrato alcune difficoltà ed errori mentre cercavo di seguire questa guida - provato sia su un desktop Windows 10 che Windows 11.

Dopo un po’ di tentativi ed errori, ho finalmente trovato i passaggi che portano a un ambiente di sviluppo completamente funzionante su Windows 11, testato sull’ultima build 22H2 e anche sulla prossima Release Preview 23H2 (presumo che funzionerà anche sulla build più recente di Windows 10).

Se può essere utile a qualcuno, ho appena pubblicato la guida qui:-

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…

Spero che questo aiuti persone come me che stanno cercando di far funzionare Discourse su Windows

[Canapin (Coin-coin le Canapin)]

Ho ripercorso tutta questa guida ufficiale per assicurarmi che nulla si fosse rotto dall’ultima volta.
Ho installato Ubuntu (versione non specificata) tramite WSL su Windows 11, che ha installato l’ultima versione LTS, in questo caso la 22.04.

Non ho riscontrato alcun problema; tutto è stato semplice, nessun errore e l’installazione per sviluppatori funziona.

Se in futuro avrai problemi ad installare qualcosa utilizzando una delle nostre guide ufficiali, per favore scrivi gli errori e segnalaceli, è sempre utile

---

Due avvisi però:

Durante l’installazione di Node.js:

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

                           AVVISO DI DEPRECIAZIONE SCRIPT


  Questo script, situato su https://deb.nodesource.com/setup_X, utilizzato per
  installare Node.js è ora deprecato e verrà reso inattivo in futuro.

  Si prega di visitare il repository GitHub delle distribuzioni NodeSource e seguire le
  istruzioni per migrare il proprio repository.
  https://github.com/nodesource/distributions

  Il repository GitHub delle distribuzioni Linux NodeSource per Node.js contiene
  informazioni su quali versioni di Node.js e quali distribuzioni Linux
  sono supportate e come installarlo.
  https://github.com/nodesource/distributions


                          AVVISO DI DEPRECIAZIONE SCRIPT

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

PER EVITARE QUESTA ATTESA, MIGRARE LO SCRIPT
Continuo tra 60 secondi (premi Ctrl-C per interrompere) ...

Eseguendo redis-server --daemonize yes:

# ATTENZIONE La sovra-allocazione della memoria deve essere abilitata! Senza di essa, un salvataggio in background o la replica potrebbero fallire in condizioni di memoria insufficiente. Essendo disabilitata, può anche causare fallimenti senza condizioni di memoria insufficiente, vedere https://github.com/jemalloc/jemalloc/issues/1328. Per risolvere questo problema aggiungere 'vm.overcommit_memory = 1' a /etc/sysctl.conf e poi riavviare o eseguire il comando 'sysctl vm.overcommit_memory=1' affinché abbia effetto.

[AliBenBongo]

Non sono sicuro del perché abbia avuto così tanti problemi allora! Forse c’era qualcosa di strano nella mia installazione di Windows che sono riuscito a risolvere durante la risoluzione dei problemi senza rendermene conto!

Comunque, sono ancora felice di ciò che ho imparato finora e non vedo l’ora di continuare a lavorare alla migrazione dei miei forum su Discourse.

[Arkshine]

@Canapin

Ho ripercorso tutta questa guida ufficiale per assicurarmi che nulla si fosse rotto dall’ultima volta.

Ho dovuto reinstallare Windows e ora ho una nuova installazione di Windows 11.
Seguirò la guida e ti farò sapere più tardi! Terrò a mente anche la guida di @AliBenBongo.

[Arkshine]

Ecco un aggiornamento.

La guida potrebbe sicuramente necessitare di un aggiornamento, ma funziona ancora meravigliosamente bene su una Windows 11 22H2 appena installata.

L’unico problema che ho riscontrato è stato che, anche se il comando wsl funzionava in un terminale, la funzionalità WSL in realtà non era abilitata per impostazione predefinita:

[NateDhaliwal]

Penso che questa guida sia obsoleta. I passaggi menzionati nella guida Ubuntu/Debian non esistono più.

[NateDhaliwal]

C’è un modo per annullare tutti questi passaggi, ad esempio invertire lo script di installazione di pacchetti, gemme e clonazione?

[TempAccount]

@Discourse

ATTENZIONE: Installa Ubuntu 18.04 e non 20.04 poiché alcune installazioni falliranno su 20.04.

È ancora necessaria l’installazione di 18.04 su 20.04?

Ricevo un errore durante l’installazione di nodejs:

# apt install nodejs

Lettura elenco dei pacchetti... Fatto
Generazione albero delle dipendenze
Lettura informazioni sullo stato... Fatto
Alcuni pacchetti non possono essere installati. Questo potrebbe significare che è stata richiesta una situazione impossibile oppure, se si utilizza la distribuzione non stabile, che alcuni pacchetti richiesti non sono ancora stati creati o sono stati spostati da Incoming.
Le informazioni seguenti potrebbero aiutare a risolvere la situazione:

I seguenti pacchetti hanno dipendenze non soddisfatte:
 nodejs : Dipende: libc6 (>= 2.28) ma la versione 2.27-3ubuntu1.6 è da installare
E: Impossibile correggere i problemi, sono stati bloccati pacchetti interrotti.```

[saros]

@Arkshine

Ecco, ho trovato una soluzione.

Ho notato che sostituire 127.0.0.1 con localhost risolve il problema delle immagini.

Dopo una ricerca, puoi avviare Diwsl con il seguente comando

Installazione 24.04 fallita, l’host non riesce a connettersi alla porta 3000

[merefield (Robert)]

Lo sto eseguendo su 24.04. Consiglio di condividere maggiori informazioni su come appare l’ambiente quando avvii il server.

Prova FORCE_HOSTNAME=localhost bin/ember-cli -u, che avvierà contemporaneamente sia il server backend che quello frontend.

(In viaggio: a memoria)