Discourse für die Entwicklung unter Windows installieren

[Discourse]

Dieses Tutorial 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 ab 18917 verfügbar. Wir gehen davon aus, dass Sie bereits Windows Subsystem for Linux 2 (Ubuntu) auf Ihrem Windows 10-System installiert haben. ACHTUNG: Installieren Sie Ubuntu 18.04 und nicht 20.04, da einige Installationen unter 20.04 fehlschlagen. Weitere Informationen finden Sie in den Notizen vom 30. Juni 2020 am Ende dieses Beitrags.

Los geht’s!

Discourse installieren

1. Befolgen Sie zunächst die Schritte aus dem Thema Einsteiger-Guide zur Installation von Discourse auf Ubuntu für die Entwicklung, 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

Nun, da wir die Discourse-Abhängigkeiten installiert haben, installieren wir Discourse selbst.

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. Gehen Sie dann alle restlichen Schritte des Ubuntu-Guides durch.

@techAPJ

Discourse klonen

Klonen Sie das Discourse-Repository im 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 ist.

Datenbank einrichten

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

sudo -u postgres createuser -s "$USER"
```\n
## Discourse bootstrappen

Wechseln Sie in Ihren Discourse-Ordner:

```sh
cd ~/discourse
```\n
Installieren Sie die benötigten Gems

```sh
source ~/.bashrc
bundle install
```\n
Nun, da Sie die Gems erfolgreich installiert haben, führen Sie diese Befehle aus:

```sh
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
```\n
Versuchen Sie, die Spezifikationen auszuführen:

```sh
bundle exec rake autospec

Alle Tests sollten bestanden werden.

Starten Sie den Rails-Server:

bundle exec rails server

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

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

bin/dev --only ember

Dadurch wird der Frontend-Bundler gestartet; die App wird weiterhin von http://localhost:3000 bereitgestellt.

Einen Befehl zum Starten von Discourse erstellen

Ihre Entwicklungsumgebung ist jetzt fast bereit. 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 durch Erstellen eines benutzerdefinierten Befehls umgehen

cd ~
```\n
Erstellen Sie eine neue Datei mit dem Befehl `nano start-discourse` und fügen Sie den folgenden Inhalt ein, speichern und schließen Sie dann.

```sh
#!/bin/bash

# um PostgreSQL zu starten
sudo service postgresql start

# um den Redis-Server zu starten
redis-server --daemonize yes
```\n
Ändern Sie nun die CHMOD-Berechtigung mit dem folgenden Befehl

```sh
chmod +x start-discourse
```\n
Und kopieren Sie die Datei in Ihren bin-Ordner

```sh
sudo cp start-discourse /usr/bin/
```\n
**Es ist erledigt.** Wenn Sie nun die Ubuntu-Bash öffnen, führen Sie einfach den folgenden Befehl aus und beginnen Sie mit der Entwicklung :+1:

```sh
start-discourse

---

Alternativ können Sie, wenn Sie Windows 10 Enterprise, Pro oder Education Edition verwenden, eine Linux-VM 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 Probleme stoßen, da Discourse nun WSL 2 benötigt, um tatsächlich ausgeführt zu werden.
Zunächst: Wenn Sie es noch nicht getan haben, sollten Sie Ihr System auf Windows 2004 (19041) aktualisieren.
Hinweis: Installieren Sie nicht über Windows Update in den Systemeinstellungen, da Sie während der Installation Fehler erhalten könnten. Stellen Sie außerdem sicher, dass Sie Windows 1903 (18362) oder 1909 (18363) verwenden, Sie können dafür winver suchen.

• Gehen Sie zu: Windows 10 herunterladen
• Klicken Sie auf die Schaltfläche „Jetzt aktualisieren“ unter Windows 10 May 2020 Update, um den Update-Assistenten herunterzuladen, und lassen Sie ihn installieren und abschließen.
• Wenn 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 Flash) und verwenden Sie es, um Windows zu installieren.

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

• Virtual Machine Platform, die direkt in Windows aktiviert werden kann, indem Sie zu „Programme und Features“ gehen und dann „Optionale Features“ in Windows-Funktionen aktivieren oder deaktivieren aktivieren.
• Die andere ist Virtualisierung, die nur im BIOS aktiviert werden kann. Diese Option kann jedoch von Mainboard zu Mainboard variieren. z. B. heißt es bei AMD SVM. Bitte suchen Sie nach Ihrem spezifischen Mainboard.

Nun, da Sie 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 befolgen Sie die Schritte: Windows Subsystem for Linux (WSL) auf 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 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 Ubuntu-18.04 und nicht 20.04 verwenden.

Wenn Sie jedoch bereits postgreSQL 12 haben und auf Port 5432 läuft, könnten Sie auf Probleme stoßen, da die Abhängigkeiten postgreSQL 10 installieren, was den Port möglicherweise auf 5433 erhöht.
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 ein und fügen Sie 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 PostgreSQL läuft und auf welchem Port, über pg_isready. Befolgen Sie dann die gleichen Anweisungen wie oben und setzen Sie den Port auf den, auf dem die Datenbank läuft.

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

@RickyC0626

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

Einige Fehler während der Datenbankerstellung und -migration:

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

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 beim Verbinden mit Port 5432 hat. Normalerweise sollte das Starten des Dienstes funktionieren

sudo service postgresql start
```\n
Wenn dies immer noch nicht funktioniert und der Fehler weiterhin besteht, versuchen Sie, zu prüfen, auf welchem Port der Dienst hört, und ändern Sie bei Bedarf den Port in den gewünschten Port in [postgresql.conf](https://stackoverflow.com/questions/187438/change-pgsql-port):

```sh
pg_isready

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

---

Das Ergebnis

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

netstat -anop tcp
```\n
was etwas wie folgt anzeigen 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 redis-server-Instanzen laufen.

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

```sh
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 behoben werden.

Stand 1. Juli 2020

@RickyC0626

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

Einige Fehler während der Datenbankerstellung und -migration:

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

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 beim Verbinden mit Port 5432 hat. Normalerweise sollte das Starten des Dienstes funktionieren

sudo service postgresql start
```\n
Wenn dies immer noch nicht funktioniert und der Fehler weiterhin besteht, versuchen Sie, zu prüfen, auf welchem Port der Dienst hört, und ändern Sie bei Bedarf den Port in den gewünschten Port in [postgresql.conf](https://stackoverflow.com/questions/187438/change-pgsql-port):

```sh
pg_isready

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

---

Das Ergebnis

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

netstat -anop tcp
```\n
was etwas wie folgt anzeigen 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 redis-server-Instanzen laufen.

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

```sh
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 behoben werden.

---

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

---

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