Discourse auf Windows für die Entwicklung installieren

[Discourse]

Dieses Tutorial wurde auf Windows 10 und 11 getestet.

Um eine Entwicklungsumgebung für Discourse auf Windows einzurichten, können Sie dies mit der Funktion Windows Subsystem for Linux tun.

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. Weitere Informationen finden Sie in den Anmerkungen vom 30. Juni 2020 am Ende dieses Beitrags.

Legen wir los!

Discourse installieren

1. Folgen Sie zunächst den Schritten aus dem Thema Beginners Guide to Install Discourse on Ubuntu for Development bis zum Schritt Clone Discourse.

@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
• libvips
• MailHog**
• ImageMagick**

** optional

Da wir nun die Discourse-Abhängigkeiten installiert haben, gehen wir dazu über, Discourse selbst zu installieren.

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

   sudo service postgresql start
   redis-server --daemonize yes
   

3. Gehen Sie dann alle verbleibenden Schritte des Ubuntu-Leitfadens durch.

@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, daher ist der Discourse-Quellcode in Ihrem Home-Ordner verfügbar.

Datenbank einrichten

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

sudo -u postgres createuser -s "$USER"

Discourse initialisieren (Bootstrap)

Wechseln Sie in Ihren Discourse-Ordner:

cd ~/discourse

Installieren Sie die benötigten Gems

source ~/.bashrc
bundle install

Da 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 Specs auszuführen:

bundle exec rake autospec

Alle Tests sollten bestanden werden.

Starten Sie den Rails-Server:

bundle exec rails server

Sie sollten sich nun mit Ihrer Discourse-App unter http://localhost:3000 verbinden können - probieren Sie es aus!

Öffnen Sie in einer separaten Terminalinstanz Ihren discourse-Ordner (cd ~/discourse) und führen Sie aus:

bin/dev --only ember

Dies startet den Frontend-Bundler; die App wird weiterhin von http://localhost:3000 bereitgestellt.

Erstellen eines Befehls zum Starten von Discourse

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

cd ~

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

#!/bin/bash

# um PostgreSQL zu starten
sudo service postgresql start

# um den Redis-Server zu starten
redis-server --daemonize yes

Ändern Sie nun die CHMOD-Rechte mit dem folgenden Befehl

chmod +x start-discourse

Und kopieren Sie die Datei in Ihren bin-Ordner

sudo cp start-discourse /usr/bin/

Es ist erledigt. Jetzt können Sie, wann immer Sie das Ubuntu-Bash öffnen, einfach den folgenden Befehl ausführen und mit der Entwicklung beginnen

start-discourse

---

Alternativ können Sie, wenn Sie die Windows 10 Editionen Enterprise, Pro oder Education verwenden, eine Linux-Virtual Machine in hyper-v erstellen, um die Discourse-Entwicklungsumgebung einzurichten.

Anmerkungen 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 benötigt, um tatsächlich ausgeführt zu werden.
Zu Beginn: Wenn Sie es noch nicht getan haben, sollten Sie Ihr System auf Windows 2004 (19041) aktualisieren.
Hinweis: Installieren Sie nicht über die Windows-Update-Einstellungen des Systems, da Sie während der Installation Fehler erhalten könnten. Stellen Sie außerdem sicher, dass Sie unter Windows 1903 (18362) oder 1909 (18363) laufen; Sie können dies mit winver prüfen.

• Gehen Sie zu: Windows 10 herunterladen
• Klicken Sie unter Windows 10 May 2020 Update auf die Schaltfläche „Jetzt aktualisieren“, um den Update-Assistenten herunterzuladen, und lassen Sie ihn installieren und beenden.
• Wenn Sie Fehler erhalten, laden Sie das Media Creation Tool herunter, führen Sie es aus und erstellen Sie einen bootfähigen USB-Stick (mindestens 8 GB), um Windows zu installieren.

Wenn Sie mit der Windows-Installation fertig sind, müssen Sie WSL 2 manuell installieren.
Zuerst müssen wir jedoch sicherstellen, dass zwei Funktionen aktiviert sind:

• Virtual Machine Platform, die direkt von Windows aus aktiviert werden kann, indem Sie zu „Programme und Features“ gehen und dann unter Windows-Funktionen aktivieren oder deaktivieren die Option „Optionale Features“ aktivieren.
• Die andere ist Virtualisierung, die nur über Ihr BIOS aktiviert werden kann. Diese Option kann jedoch von einem Mainboard zum anderen variieren. z. B. heißt es bei AMD SVM. Bitte recherchieren Sie also Ihr spezifisches Mainboard.

Da Sie nun beide Funktionen aktiviert haben:

• Installieren Sie Ubuntu 18.04, und nicht 20.04, da einige Installationen unter 20.04 fehlschlagen.
• 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
• Gehen Sie zu PowerShell (als Administrator ausführen) 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 unter WSL 2 läuft.

Jetzt können Sie Ubuntu-18.04 oder das Windows Terminal mit Ubuntu ausführen und mit der Installation der Abhängigkeiten und Tools beginnen.

Hinweis: Wenn Sie bei der Installation eines der Gems während bundle install auf einen Fehler stoßen: Stellen Sie sicher, dass Sie unter Ubuntu-18.04 und nicht 20.04 laufen.

Wenn Sie jedoch bereits PostgreSQL 12 auf Port 5432 laufen haben, könnten Sie auf einige Probleme stoßen, da die Abhängigkeiten PostgreSQL 10 installieren, was dazu führen kann, dass der Port auf 5433 erhöht wird.
Um das zu beheben:

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

Wenn das oben Genannte nicht funktioniert, stellen Sie sicher, dass Sie prüfen, ob PostgreSQL läuft und auf welchem Port, via pg_isready. Folgen Sie dann den obigen Anweisungen und setzen Sie den Port auf den, auf dem die Datenbank läuft.

FÜR DEN LINUX-KERNEL: WSL 2 Linux-Kernel aktualisieren | Microsoft Docs

@RickyC0626

Eine Lösung, die keine explizite Port-Konfiguration in database.yml erfordert

Einige Fehler bei der Datenbankerstellung und -migration:

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

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)

Aus diesem Fehler können wir sehen, dass der Port, den Redis verwendet, 6379 ist, und wir können dies beheben, indem wir den Redis-Server über diesen Port starten.

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

redis-server --daemonize yes --port 6379

Prü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
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

Aus diesem Fehler können wir sehen, dass PostgreSQL Probleme hat, sich mit Port 5432 zu verbinden. Normalerweise sollte das Starten des Dienstes funktionieren

sudo service postgresql start

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

pg_isready

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

---

Das Ergebnis

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

netstat -anop tcp

was ungefähr so aussehen wird:

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 auf Ubuntu oder WSL mit den 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

---

Ab hier sollten diese Befehle ohne größere Probleme funktionieren, ohne dass die database.yml-Datei 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 behandelt werden.

Stand 1. Juli 2020

@RickyC0626

Eine Lösung, die keine explizite Port-Konfiguration in database.yml erfordert

Einige Fehler bei der Datenbankerstellung und -migration:

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

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)

Aus diesem Fehler können wir sehen, dass der Port, den Redis verwendet, 6379 ist, und wir können dies beheben, indem wir den Redis-Server über diesen Port starten.

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

redis-server --daemonize yes --port 6379

Prü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
       Is the server running locally and accepting
       connections on Unix domain socket "/var/run/postgresql/.s.PGSQL.5432"?

Aus diesem Fehler können wir sehen, dass PostgreSQL Probleme hat, sich mit Port 5432 zu verbinden. Normalerweise sollte das Starten des Dienstes funktionieren

sudo service postgresql start

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

pg_isready

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

---

Das Ergebnis

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

netstat -anop tcp

was ungefähr so aussehen wird:

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 auf Ubuntu oder WSL mit den 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

---

Ab hier sollten diese Befehle ohne größere Probleme funktionieren, ohne dass die database.yml-Datei 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 behandelt werden.

---

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

---

Dieses Dokument wird versioniert verwaltet - schlagen Sie Änderungen auf github vor.