Diese Anleitung behandelt die Installationsanweisungen für eine macOS-Entwicklungsumgebung. Anleitungen für die Produktion finden Sie unter: 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 Sie Ruby/Rails/Postgres/Redis noch nicht auf Ihrem Mac installiert haben. Fangen wir an 
!
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
Starten Sie Ihr Terminal neu
Nachdem wir nun die Discourse-Abhängigkeiten installiert haben, fahren wir mit der Installation von Discourse selbst fort.
Terminal neu starten
Beenden und starten Sie Ihre Shell neu, um sicherzustellen, dass die Pfade zu den installierten Paketen vom Terminal korrekt übernommen werden.
Discourse klonen
Klonen Sie das Discourse-Repository im Ordner ~/discourse:
git clone https://github.com/discourse/discourse.git ~/discourse
~ steht für das Home-Verzeichnis, sodass der Discourse-Quellcode in Ihrem Home-Verzeichnis verfügbar ist.
Discourse initialisieren (Bootstrap)
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 als Nächstes 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 die Rails- und Ember-Server. Hier haben Sie zwei Möglichkeiten.
Option 1: Verwenden Sie zwei separate Terminal-Tabs/-Fenster und führen Sie Rails und Ember CLI separat über
bundle exec rails server
und
bin/ember-cli
aus.
Option 2: Verwenden Sie nur ein Terminal-Tab/-Fenster:
bin/ember-cli -u # startet den Unicorn-Server im Hintergrund
Sie sollten nun in der Lage sein, http://localhost:4200 aufzurufen, um Ihre lokale Discourse-Installation anzuzeigen. (Beachten Sie, dass der erste Ladevorgang bis zu einer Minute dauern kann, während der Server hochgefahren wird.)
Sie können auch versuchen, die Tests auszuführen:
bundle exec rake autospec
Alle (oder fast alle) Tests sollten erfolgreich durchlaufen.
Neuen Administrator erstellen
Um einen neuen Administrator zu erstellen, führen Sie den folgenden Befehl aus:
RAILS_ENV=development bundle exec rake admin:create
Folgen Sie den Anweisungen, um ein Administratorkonto zu erstellen.
Mail konfigurieren
Führen Sie MailHog aus:
mailhog
Herzlichen Glückwunsch! Sie sind jetzt Administrator Ihrer eigenen Discourse-Installation!
Viel Spaß beim Hacking! Um damit zu beginnen, lesen Sie den Leitfaden für Anfänger zur Erstellung von Discourse-Plugins.
Dieses Dokument wird versioniert – schlagen Sie Änderungen auf github vor.