Diese Anleitung behandelt Installationsanweisungen für eine macOS-Entwicklungsumgebung. Für Produktionsanleitungen siehe: Install Discourse in production with the official supported instructions
Sie möchten also Discourse auf macOS einrichten, um daran zu arbeiten und zu entwickeln?
Wir gehen davon aus, dass Ruby/Rails/Postgres/Redis nicht auf Ihrem Mac installiert sind. Fangen wir an 
!
Discourse-Abhängigkeiten installieren
Sie benötigen die folgenden Pakete auf Ihrem System:
- Git
- rbenv oder asdf
- ruby-build
- Ruby (aktuelle stabile Version)
- Rails
- PostgreSQL
- SQLite
- Redis
- Node.js
- pnpm
- MailHog**
- ImageMagick**
** optional
Terminal neu starten
Nachdem wir die Discourse-Abhängigkeiten installiert haben, fahren wir mit der Installation von Discourse selbst fort.
Terminal neu starten
Beenden Sie Ihre Shell und starten Sie sie neu, um sicherzustellen, dass die Pfade zu den installierten Paketen vom Terminal korrekt erkannt werden.
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 sein wird.
Discourse bootstrappen
Wechseln Sie in Ihren Discourse-Ordner:
cd ~/discourse
Installieren Sie die benötigten Gems:
bundle install
Installieren Sie die JS-Abhängigkeiten:
pnpm install
Führen Sie anschließend diese Befehle aus, um Ihre lokale Discourse-Instanz einzurichten:
bundle exec rake db:create
bundle exec rake db:migrate
RAILS_ENV=test bundle exec rake db:create db:migrate
Starten Sie Rails- und Ember-Server. Sie haben hier zwei Möglichkeiten.
Option 1: Verwenden Sie zwei separate Terminal-Tabs/Fenster und starten Sie Rails und den Frontend-Bundler separat über:
bundle exec rails server
und
bin/dev --only ember
Option 2: Verwenden Sie nur ein Terminal-Tab/Fenster:
bin/dev # führt Pitchfork und den Frontend-Bundler gemeinsam aus
Sie sollten nun in der Lage sein, zu http://localhost:3000 zu navigieren, um Ihre lokale Discourse-Installation zu sehen. (Beachten Sie, dass der erste Ladevorgang bis zu einer Minute dauern kann, da der Server hochgefahren wird.)
Sie können auch versuchen, die Tests auszuführen:
bundle exec rake autospec
Alle (oder fast alle) Tests sollten erfolgreich sein.
Neuer Administrator erstellen
Um einen neuen Administrator zu erstellen, führen Sie folgenden Befehl aus:
RAILS_ENV=development bundle exec rake admin:create
Folgen Sie den Aufforderungen, um ein Administratorkonto zu erstellen.
E-Mail konfigurieren
Starten Sie MailHog:
mailhog
Herzlichen Glückwunsch! Sie sind nun der Administrator Ihrer eigenen Discourse-Installation!
Viel Spaß beim Entwickeln! Um damit zu beginnen, lesen Sie den Anfängerleitfaden zum Erstellen von Discourse-Plugins.
Dieses Dokument ist versionskontrolliert – schlagen Sie Änderungen auf GitHub vor.