Discourse unter Windows für die Entwicklung installieren

[Discourse]

Diese Anleitung wurde unter Windows 10 und 11 getestet.

Um eine Entwicklungsumgebung für Discourse unter Windows einzurichten, können Sie die Funktion Windows Subsystem for Linux verwenden.

Diese Einrichtung erfordert die Installation von WSL 2. Sie ist nur in Windows 10 Builds 18917 oder höher verfügbar. Wir gehen davon aus, dass Sie bereits Windows Subsystem for Linux 2 (Ubuntu) auf Ihrem Windows 10-System installiert haben. WARNUNG: Installieren Sie Ubuntu 18.04 und nicht 20.04, da einige Installationen unter 20.04 fehlschlagen können. Weitere Informationen finden Sie in den Notizen vom 30. Juni 2020 am Ende dieses Beitrags.

Legen wir los!

Discourse installieren

1. Befolgen Sie zunächst die Schritte aus dem Thema Beginners Guide to Install Discourse on Ubuntu for Development bis zum Schritt Discourse klonen.

@techAPJ

Discourse-Abhängigkeiten installieren

Sie benötigen die folgenden Pakete auf Ihrem System:

• Git
• rbenv oder asdf
• ruby-build
• Ruby (neueste stabile Version)
• Rails
• PostgreSQL
• SQLite
• Redis
• Node.js
• pnpm
• MailHog**
• ImageMagick**

** optional

Da wir nun die Discourse-Abhängigkeiten installiert haben, fahren wir mit der Installation von Discourse selbst fort.

2. Bevor Sie die Datenbank einrichten, müssen Sie den PostgreSQL-Dienst und den Redis-Server manuell mit folgenden Befehlen starten:

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Folgen Sie dann allen verbleibenden Schritten des Ubuntu-Leitfadens.

@techAPJ

Discourse klonen

Klonen Sie das Discourse-Repository in den Ordner ~/discourse:

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

~ steht für den Home-Ordner, sodass der Discourse-Quellcode in Ihrem Home-Ordner verfügbar sein wird.

Datenbank einrichten

Erstellen Sie eine Rolle mit demselben Namen wie Ihr Ubuntu-Benutzername:

sudo -u postgres createuser -s "$USER"

Discourse bootstrappen

Wechseln Sie in Ihren Discourse-Ordner:

cd ~/discourse

Installieren Sie die benötigten Gems:

source ~/.bashrc
bundle install

Nachdem Sie die Gems erfolgreich installiert haben, führen Sie diese Befehle aus:

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

Versuchen Sie, die Testspezifikationen auszuführen:

bundle exec rake autospec

Alle Tests sollten erfolgreich durchlaufen.

Starten Sie den Rails-Server:

bundle exec rails server

Sie sollten nun in der Lage sein, eine Verbindung mit Ihrer Discourse-App unter http://localhost:3000 herzustellen – probieren Sie es aus!

In einer separaten Terminal-Instanz navigieren Sie zu Ihrem Discourse-Ordner (cd ~/discourse) und führen Sie aus:

bin/dev --only ember

Dies startet den Frontend-Bundler; die App bleibt unter http://localhost:3000 bereitgestellt.

Einen Befehl zum Starten von Discourse erstellen

Ihre Entwicklungsumgebung ist jetzt fast einsatzbereit. Das einzige Problem ist, dass Sie jedes Mal, wenn Sie Ubuntu unter Windows öffnen, den PostgreSQL-Dienst und den Redis-Server manuell starten müssen. Keine Sorge, wir können dies umgehen, indem wir einen benutzerdefinierten Befehl erstellen

cd ~

Erstellen Sie eine neue Datei mit dem Befehl nano start-discourse, fügen Sie den untenstehenden Inhalt ein, speichern Sie und beenden Sie.

#!/bin/bash

# zum Starten von PostgreSQL
sudo service postgresql start

# zum Starten des Redis-Servers
redis-server --daemonize yes

Ändern Sie nun die CHMOD-Berechtigungen mit dem folgenden Befehl:

chmod +x start-discourse

Und kopieren Sie die Datei in Ihren Bin-Ordner:

sudo cp start-discourse /usr/bin/

Fertig. Jetzt können Sie jedes Mal, wenn Sie Ubuntu Bash öffnen, einfach den folgenden Befehl ausführen und mit der Entwicklung beginnen

start-discourse

---

Alternativ können Sie, wenn Sie Windows 10 Enterprise, Pro oder Education Edition verwenden, eine Linux-Virtualmaschine in Hyper-V erstellen, um die Discourse-Entwicklungsumgebung einzurichten.

Hinweise zur Windows-Umgebung

Stand 30. Juni 2020:

@AndreaHabib

Mit der Einführung von Windows 10 Build 2004 und WSL 2 könnten viele von Ihnen auf einige Probleme stoßen, da Discourse nun WSL 2 für die Ausführung benötigt.
Zunächst: Falls Sie dies noch nicht getan haben, sollten Sie Ihr System auf Windows 2004 (19041) aktualisieren.
Hinweis: Installieren Sie nicht über Windows Update in den Systemeinstellungen, da dies zu Fehlern während der Installation führen kann. Stellen Sie außerdem sicher, dass Sie Windows 1903 (18362) oder 1909 (18363) verwenden; Sie können dies mit winver überprüfen.

• Gehen Sie zu: Windows 10 herunterladen
• Klicken Sie auf den Button „Jetzt aktualisieren“ unter „Windows 10 Mai 2020 Update“, um den Aktualisierungsassistenten herunterzuladen und die Installation abzuschließen.
• Falls Sie Fehler erhalten, laden Sie das Media Creation Tool herunter, führen Sie es aus und erstellen Sie einen bootfähigen Flash-Laufwerk (mindestens 8 GB), um Windows damit zu installieren.

Nach Abschluss der Windows-Installation müssen Sie WSL 2 manuell installieren.
Zunächst müssen wir jedoch sicherstellen, dass zwei Funktionen aktiviert sind:

• Die „Virtual Machine Platform“, die direkt in Windows über „Programme und Funktionen“ und dann durch Aktivieren von „Optionale Features“ in „Windows-Features aktivieren oder deaktivieren“ aktiviert werden kann.
• Die andere ist „Virtualisierung“, die nur im BIOS aktiviert werden kann. Diese Option kann je nach Mainboard variieren, z. B. heißt sie bei AMD „SVM“. Bitte recherchieren Sie daher die spezifischen Einstellungen Ihres Mainboards.

Sobald beide Funktionen aktiviert sind:

• Installieren Sie Ubuntu 18.04 und nicht 20.04, da einige Installationen unter 20.04 fehlschlagen können.
• Gehen Sie hierher und aktualisieren Sie den Linux-Kernel: Link in den Antworten.
• Gehen Sie zu diesem Link und folgen Sie den Schritten: Windows Subsystem for Linux (WSL) unter Windows 10 installieren | Microsoft Docs
• Öffnen Sie PowerShell (als Administrator) und führen Sie aus: wsl --set-version Ubuntu-18.04 2 oder wsl --set-version Ubuntu 2, je nachdem, welche Distribution in wsl -l -v angezeigt wird.
• Die Konvertierung dauert einige Minuten.
• Führen Sie wsl -l -v aus, um sicherzustellen, dass Ubuntu auf WSL 2 läuft.

Jetzt können Sie Ubuntu-18.04 oder Windows Terminal mit Ubuntu starten und die Abhängigkeiten sowie Tools installieren.

Hinweis: Wenn Sie beim Installieren eines der Gems während bundle install einen Fehler erhalten: Stellen Sie sicher, dass Sie Ubuntu-18.04 und nicht 20.04 verwenden.

Wenn Sie jedoch bereits PostgreSQL 12 auf Port 5432 laufen haben, könnten Sie auf Probleme stoßen, da die Abhängigkeiten PostgreSQL 10 installieren, was den Port möglicherweise auf 5433 erhöht.
Um dies zu beheben:

• Öffnen Sie Ihren Ordner in einem Texteditor (z. B. VS Code).
• Gehen Sie zu config/database.yml.
• Unter „development“ und unter „adapter“ fügen Sie eine neue Zeile hinzu und schreiben Sie: port: 5433.
• Stellen Sie sicher, dass Sie dasselbe für „test“ und „profile“ tun.

Wenn das oben Genannte nicht funktioniert, überprüfen Sie, ob PostgreSQL läuft und auf welchem Port, mittels pg_isready. Befolgen Sie dann die oben genannten Anweisungen und setzen Sie den Port auf den Port, auf dem die Datenbank läuft.

FÜR DEN LINUX-KERNEL: Aktualisierung des WSL 2 Linux-Kernels | Microsoft Docs

@RickyC0626

Eine Lösung, die keine explizite Portkonfiguration in database.yml erfordert.

Einige Fehler während der Erstellung und Migration der Datenbank:

Ungültige Redis-Verbindung zu einem bestimmten Port / Verbindungsverweigerung

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Verursacht durch:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Verursacht durch:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(Vollständigen Trace durch Ausführen der Aufgabe mit --trace anzeigen)

Aus diesem Fehler geht hervor, dass Redis den Port 6379 verwendet. Dies können wir beheben, indem wir den Redis-Server über diesen Port starten.

Standardmäßig sollte redis-server --daemonize yes funktionieren, aber falls nicht, verwenden Sie:

redis-server --daemonize yes --port 6379

Überprüfen Sie den Status der Redis-Instanz:

redis-cli

127.0.0.1:6379> ping
PONG

Ungültige Verbindung zum psql-Port

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Läuft der Server lokal und akzeptiert
       Verbindungen auf Unix-Domain-Socket "/var/run/postgresql/.s.PGSQL.5432"?

Aus diesem Fehler geht hervor, dass PostgreSQL Probleme hat, eine Verbindung zum Port 5432 herzustellen. Normalerweise sollte das Starten des Dienstes funktionieren.

sudo service postgresql start

Wenn dies immer noch nicht funktioniert und der Fehler bestehen bleibt, prüfen Sie, auf welchem Port der Dienst lauscht, und ändern Sie bei Bedarf den Port auf den gewünschten Port in postgresql.conf:

pg_isready

/var/run/postgresql:5432 - keine Antwort
oder
/var/run/postgresql:5432 - akzeptiert Verbindungen

---

Das Ergebnis

Sobald wir das oben Genannte durchgeführt oder den Befehl start-discourse ausgeführt haben, sollten beide Instanzen auf ihren Standard- bzw. angegebenen Ports laufen. Um ihren Status über das Standard-Windows-cmd-Terminal zu überprüfen, können wir ausführen:

netstat -anop tcp

Dies zeigt etwas wie folgt an:

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

Wir haben nun bestätigt, dass sowohl unsere PostgreSQL- als auch unsere Redis-Server-Instanzen laufen.

Wir können auch den Status der Instanzen unter Ubuntu oder WSL mit folgenden Befehlen überprüfen:

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

---

Von hier aus sollten diese Befehle ohne größere Probleme funktionieren, ohne dass die Datei database.yml geändert werden muss:

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

Weitere auftretende Probleme können in Zukunft behoben werden.

Stand 1. Juli 2020

@RickyC0626

Eine Lösung, die keine explizite Portkonfiguration in database.yml erfordert.

Einige Fehler während der Erstellung und Migration der Datenbank:

Ungültige Redis-Verbindung zu einem bestimmten Port / Verbindungsverweigerung

bundle exec rake db:create

rake aborted!
Redis::CannotConnectError: Error connecting to Redis on localhost:6379 (Errno::ECONNREFUSED)
...

Verursacht durch:
Errno::ECONNREFUSED: Connection refused - connect(2) for 127.0.0.1:6379
...

Verursacht durch:
IO::EINPROGRESSWaitWritable: Operation now in progress - connect(2) would block
...

Tasks: TOP => db:create => db:load_config => environment
(Vollständigen Trace durch Ausführen der Aufgabe mit --trace anzeigen)

Aus diesem Fehler geht hervor, dass Redis den Port 6379 verwendet. Dies können wir beheben, indem wir den Redis-Server über diesen Port starten.

Standardmäßig sollte redis-server --daemonize yes funktionieren, aber falls nicht, verwenden Sie:

redis-server --daemonize yes --port 6379

Überprüfen Sie den Status der Redis-Instanz:

redis-cli

127.0.0.1:6379> ping
PONG

Ungültige Verbindung zum psql-Port

bundle exec rake db:migrate

PG::ConnectionBad: could not connect to server: No such file or directory
       Läuft der Server lokal und akzeptiert
       Verbindungen auf Unix-Domain-Socket "/var/run/postgresql/.s.PGSQL.5432"?

Aus diesem Fehler geht hervor, dass PostgreSQL Probleme hat, eine Verbindung zum Port 5432 herzustellen. Normalerweise sollte das Starten des Dienstes funktionieren.

sudo service postgresql start

Wenn dies immer noch nicht funktioniert und der Fehler bestehen bleibt, prüfen Sie, auf welchem Port der Dienst lauscht, und ändern Sie bei Bedarf den Port auf den gewünschten Port in postgresql.conf:

pg_isready

/var/run/postgresql:5432 - keine Antwort
oder
/var/run/postgresql:5432 - akzeptiert Verbindungen

---

Das Ergebnis

Sobald wir das oben Genannte durchgeführt oder den Befehl start-discourse ausgeführt haben, sollten beide Instanzen auf ihren Standard- bzw. angegebenen Ports laufen. Um ihren Status über das Standard-Windows-cmd-Terminal zu überprüfen, können wir ausführen:

netstat -anop tcp

Dies zeigt etwas wie folgt an:

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

Wir haben nun bestätigt, dass sowohl unsere PostgreSQL- als auch unsere Redis-Server-Instanzen laufen.

Wir können auch den Status der Instanzen unter Ubuntu oder WSL mit folgenden Befehlen überprüfen:

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

---

Von hier aus sollten diese Befehle ohne größere Probleme funktionieren, ohne dass die Datei database.yml geändert werden muss:

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

Weitere auftretende Probleme können in Zukunft behoben werden.

---

Zuletzt überprüft von @SaraDev am 2022-06-16T02:00:00Z

---

Dieses Dokument ist versionskontrolliert – schlagen Sie Änderungen auf GitHub vor.