(veraltet) Anleitung zur Einrichtung der Discourse-Entwicklungsumgebung - GitHub Codespace

[jordan-violet]

Discourse Core enthält jetzt eine aktualisierte Devcontainer-Konfiguration, was bedeutet, dass die manuellen Schritte im Thema nicht mehr erforderlich sind.

Schauen Sie sich die offiziellen Dokumente hier an: Developing Discourse on GitHub Codespaces

---

Entwicklung mit GitHub Codespaces

GitHub Codespace ist eine großartige Entwicklungsoption. Es ist großartig, weil es in der Cloud gehostet wird, ich kann leicht sicherstellen, dass jeder, der hier entwickelt, die gleiche Umgebung hat, keine lokalen Docker-Installationen, einfachen Zugriff, um meine lokale Dev-Instanz öffentlich zugänglich zu machen, und auch einfach neue Technologien zu nutzen macht Spaß.

Ich lerne gerade die Entwicklung neu und habe beschlossen, GitHub Codespaces zusätzlich zum Erlernen der Discourse-Entwicklung zu nutzen. Daher habe ich diese Anleitung für alle erstellt, die auf Discourse in GitHub Codespace entwickeln möchten, anstatt eine lokale Umgebung einzurichten.

Ich habe beschlossen, diese Anleitung zu schreiben, nachdem ich selbst eine Reihe von Problemen bei der Arbeit mit GitHub Codespace hatte:

Issues attempting to run discourse in GitHub Codespaces

Following this post from @cvx on a fresh GitHub codespace install: Running bin/ember-cli -u (FYI for anyone else, you first have to cd into workspace/discourse), nets the following issue: [image]

Diese Anleitung setzt nichts voraus, damit wir keinen einzigen Schritt verpassen, um Sie einsatzbereit zu machen. Ich vermute, dass einige dieser Prozesse auf der Ebene des Kern-Repositorys für die GitHub Codespace-Konfiguration verbessert werden können, oder zumindest aufgrund meines mangelnden Verständnisses. Zögern Sie nicht, diese hinzuweisen.

Forken Sie das Discourse-Repository

1. Navigieren Sie zu https://github.com/discourse/discourse
   

   

2. Klicken Sie auf die Schaltfläche Fork oben rechts auf der Seite und klicken Sie auf der folgenden Seite auf die grüne Schaltfläche Create fork.
   

   

3. Nach einem kurzen Moment werden Sie zu Ihrem neuen Fork des discourse/discourse-Repositorys weitergeleitet:
   

   

Richten Sie Ihren GitHub Codespace ein

1. Klicken Sie auf die grüne Schaltfläche \u003c\u003e Code
   

   

2. Wechseln Sie zur Registerkarte Codespaces und klicken Sie auf die grüne Schaltfläche Create codoespace on main.
   

   

3. Sie werden zu einem neuen Fenster weitergeleitet, in dem GitHub Ihren Codespace erstellt. Dies sollte 1-3 Minuten dauern:
   

4. Nach ein paar Minuten wird Ihnen Ihr GitHub Codespace angezeigt (das ist nur VS Code in Ihrem Browser):
   

   

Richten Sie Ihre Codespace-Umgebung ein

Es sind einige Konfigurationen an Ihrer Codespace-Umgebung vorzunehmen, bevor Sie einsatzbereit sind.

1. Erstellen Sie eine neue Bash-Shell, indem Sie unter Windows/Linux Strg + Umschalt + Backtick oder unter Mac Cmd + Umschalt + Backtick drücken. Ihre Shell sollte Sie im Verzeichnis /var/www/discourse starten.
   

   

2. Navigieren Sie zum Discourse-Verzeichnis:

cd workspace/discourse

3. Installieren Sie alles aus der Projekt-Gemfile

bundle install --gemfile ./Gemfile

Der Befehl ist ziemlich lang, aber Sie werden etwas Ähnliches sehen:

4. Fügen Sie eine neue config.hosts zu development.rb hinzu
   1. Öffnen Sie aus dem Verzeichnis, in dem Sie sich gerade befinden (/var/www/discourse/workspace/discourse), die Datei config/environments/development.rb.
   2. Suchen Sie die Zeile config.hosts \u003c\u003c /\\A(([a-z0-9-]+)\\.)*localhost(\\:\\d+)?\\Z/ und erstellen Sie darunter eine neue Zeile mit Folgendem, dann speichern Sie die Datei:

config.hosts \u003c\u003c /^(.*)\\.app\\.github\\.dev$/

Das Ende Ihrer Datei sollte wie folgt aussehen (beachten Sie Zeile 102 in meinem Screenshot):

5. Führen Sie im Terminal bundle exec rake admin:create aus, um Ihr erstes Administratorkonto zu erstellen. Der Befehl fordert Sie auf, eine E-Mail-Adresse und ein Passwort zu wählen (das Passwort muss mindestens 10 Zeichen lang sein).
   
   

Starten Sie Ihre Motoren Server

Es dauert 1-2 Minuten, bis der Server erstellt und gestartet ist. An diesem Punkt sollten Sie alles haben, was Sie benötigen, um Ihre Anwendung auszuführen und darauf zuzugreifen.

1. Führen Sie in demselben Terminal, in dem Sie sich befinden, den folgenden Befehl aus, um Ihren Server zu starten:

bin/ember-cli -u

2. Wechseln Sie in Ihrer Konsole von der Registerkarte Terminal zur Registerkarte PORTS:
   

   

3. Klicken Sie auf die Forwarded Address für Port 4200 mit Strg + Klick für Windows/Linux oder Cmd + Klick für Mac, und Sie werden mit Ihrer Entwicklungsumgebung begrüßt!
   

   

Ich hoffe, das hilft jemand anderem beim Einstieg in GitHub Codespaces!

[Rick_Jing]

Großartig, das ist eine gute Option, wenn man nur mit leichtem Gepäck reist

[jordan-violet]

Oder in meinem Fall möchte ich wirklich nicht unter Windows und Docker entwickeln, aber ich möchte auch nicht zu Hause zu einer Unix-Umgebung wechseln (obwohl ich eine bei der Arbeit benutze).

Ich mag einfach die Idee, dass alles direkt in meinem GitHub-Repository vorhanden ist.

[NateDhaliwal]

Ich glaube, dieser Leitfaden muss aktualisiert werden. Er funktioniert nicht, wenn Schritt 5 ausgeführt wird, da die Datenbanken noch nicht erstellt wurden.

[NateDhaliwal]

@jordan-violet

bundle exec rake admin:create

Ich konnte es zum Laufen bringen, indem ich Folgendes ausgeführt habe:

bash <(wget -qO- https://raw.githubusercontent.com/discourse/install-rails/main/linux)

Dann

bin/rails db:create
bin/rails db:migrate
RAILS_ENV=test bin/rails db:create db:migrate

Gefolgt von

bin/ember-cli -u

Dann in einem geteilten Terminal

bin/rails admin:create

[NateDhaliwal]

@jordan-violet Ich gehe davon aus, dass dies eine unsupported-install ist? Ich kann meine app.yml nicht finden, daher kann ich keine Plugins installieren.

[Moin]

Um ein Plugin zu installieren, können Sie die Schritte unter Install plugins in your non-Docker development environment befolgen.

[merefield (Robert)]

Sie verlinken vom Plugins-Ordner zum Ordner Ihres Plugin-Codes

[david (David Taylor)]

@jordan-violet danke, dass du diese Anleitung mit all den zuvor notwendigen Workarounds erstellt hast

Ich freue mich, sagen zu können, dass wir jetzt eine Reihe von Änderungen an unserer devcontainer/codespaces-Konfiguration zusammengeführt haben, die es viel einfacher machen sollten, Dinge in Gang zu bringen, ohne forken oder manuell konfigurieren zu müssen.

Hier ist die offizielle Anleitung:

Developing Discourse on GitHub Codespaces

GitHub Codespaces is a very fast way to get started with Discourse development. Their free tier is good for 30 hours per month of a 4-core machine. Getting Started Navigate to the github repository Press the , (comma) key on your keyboard, to open GitHub codespaces Use ‘change options’ to customize the machine. Technically, the 2-core machine will work, but we recommend using at least 4-core for a better experience. [Codespace config] Click “Create Codespace” Wait for the contai…

Ich werde hier oben im OP eine Notiz hinzufügen, die die Leute auf die offiziellen Anleitungen verweist