Railway Schritt für Schritt: App deployen mit GitHub und Datenbank

👁 112 Aufrufe

Railway deployt eine Anwendung aus einem GitHub-Repository in wenigen Minuten: Sie wählen das Projekt aus, Railway baut und startet es automatisch, und die Datenbank fügen Sie mit einem Klick hinzu. Dieses Tutorial führt Sie vom leeren Account bis zur laufenden Anwendung mit Datenbank und öffentlicher Domain, basierend auf der offiziellen Railway-Dokumentation.

Bevor Sie beginnen: Projekt lokal testen

Railway baut die Anwendung so, wie sie im Repository liegt, daher lassen sich die meisten Probleme beim ersten Deployment vorher abfangen. Stellen Sie sicher, dass die Anwendung lokal aus einem frischen Repository-Clone startet, ohne Dateien, die nur bei Ihnen vorhanden sind. Notieren Sie alle Umgebungsvariablen, die benötigt werden, denn jede muss in Railway hinzugefügt werden. Prüfen Sie, auf welchem Port die Anwendung lauscht und ob sie ihn aus einer Variable ausliest statt fest codiert.

Dateien mit Secrets, zum Beispiel eine lokale Datei mit Variablen, sollten nicht ins Repository gelangen.

Schritt 1: Neues Projekt aus Repository

Im Dashboard klicken Sie auf New Project und wählen Deployment aus einem GitHub-Repository. Railway benötigt ein verbundenes GitHub-Konto und fordert Sie dazu auf, falls noch nicht geschehen. Anschließend suchen Sie Ihr Projekt und wählen es aus der Liste.

Sie haben zwei Optionen: Deploy Now startet den Build sofort, Add variables erlaubt Ihnen, zuerst Umgebungsvariablen zu setzen. Wenn die Anwendung eine Datenbank oder API-Keys benötigt, wählen Sie die zweite Option.

Schritt 2: Wie Railway die Anwendung baut

Railway erkennt automatisch, wie das Projekt zu bauen ist. Wenn im Repository ein Dockerfile vorhanden ist, wird dieses verwendet, andernfalls wählt Railway die Build-Methode basierend auf Sprache und Projektdateien. In dieser Phase sind die Build- und Deployment-Logs am wichtigsten.

Die Dokumentation gibt hier einen wertvollen Hinweis: Lesen Sie das gesamte Log, denn der eigentliche Fehler steht selten in der letzten Zeile. Meistens geht es um eine fehlende Umgebungsvariable oder eine andere Sprachversion als die, die Sie lokal verwenden.

Schritt 3: Datenbank

Eine PostgreSQL-Datenbank fügen Sie über die Schaltfläche + New im Projekt-Dashboard hinzu, indem Sie Database und PostgreSQL auswählen. Railway erstellt sie als separaten Service und stellt Variablen mit den Verbindungsdaten bereit, einschließlich der Datenbankadresse.

Schritt 4: Variablen und Referenzen

In den Einstellungen des Anwendungs-Service fügen Sie Variablen hinzu. Statt die Datenbankadresse zu kopieren, setzen Sie eine Referenz auf die Variable der Datenbank, zum Beispiel auf deren Verbindungsadresse. Dadurch erhält die Anwendung automatisch neue Daten, wenn sich die Datenbankdaten ändern. Dort fügen Sie auch Keys für externe Services und Produktionsumgebungs-Einstellungen hinzu.

Schritt 5: Öffentliche Domain

Dieser Schritt überrascht viele: Nach dem Deployment ist die Anwendung standardmäßig nicht aus dem Internet erreichbar. Sie gehen in die Service-Einstellungen, Bereich Networking, und klicken auf Generate Domain. Sie erhalten eine öffentliche Adresse, unter der die Anwendung läuft. Eine eigene Domain können Sie an derselben Stelle verbinden.

Schritt 6: Deployments nach jeder Änderung

Von nun an löst jede Änderung, die ins Repository gepusht wird, ein neues Deployment aus. Sie loggen sich auf keinen Server ein, und die Deployment-Historie erlaubt es, zur vorherigen Version zurückzukehren, wenn etwas schiefgeht.

Command Line Interface

Railway hat auch ein Command-Line-Tool. Der Befehl railway up sendet die Anwendungsdateien direkt vom Computer, ohne Repository, und separate Befehle fügen eine Datenbank hinzu oder generieren eine Domain. Nützlich für schnelle Tests und Skripte.

Beispiel: Discord-Bot mit Datenbank

Sie haben einen Discord-Bot, der Benutzerpunkte speichert. Das Repository liegt auf GitHub. In Railway erstellen Sie ein Projekt aus dem Repository, wählen das Hinzufügen von Variablen, tragen den Bot-Token ein, fügen eine PostgreSQL-Datenbank hinzu und setzen eine Referenz auf deren Adresse. Der Bot läuft rund um die Uhr, und jede Korrektur, die auf GitHub gepusht wird, landet automatisch auf dem Server.

Nach einem solchen Deployment sollten Sie sofort eine Sache tun: Eine kleine Änderung pushen und prüfen, ob der Bot sich selbst aktualisiert hat. Das bestätigt, dass automatische Deployments funktionieren, bevor sie wirklich gebraucht werden. Es lohnt sich auch, nach einigen Tagen Betrieb in die Datenbank zu schauen und sicherzustellen, dass Benutzerpunkte gespeichert werden und nach einem erneuten Deployment nicht verschwinden.

Häufigste Fehler

• Fehlende öffentliche Domain und die Annahme, die Anwendung funktioniere nicht.
• Keys im Code statt in Umgebungsvariablen.
• Nur das Ende des Logs lesen.
• Datenbankadresse fest eingetragen statt Referenz auf Variable.

Wie Sie das erste Deployment bewerten

Nach dem Deployment öffnen Sie die generierte Adresse und testen Sie die wichtigsten Funktionen, nicht nur die Startseite. Prüfen Sie, ob die Anwendung Daten in der Datenbank speichert und ob diese nach einem erneuten Deployment erhalten bleiben. Durchsuchen Sie die Logs der ersten Betriebsstunde: Warnungen, die Sie lokal ignoriert haben, sind auf dem Server oft das erste Signal für ein Problem. Pushen Sie abschließend eine kleine Änderung und prüfen Sie, ob das neue Deployment automatisch gestartet wurde.

Wenn die erste Anwendung läuft, deployen Sie weitere genauso: Projekt aus Repository, Variablen, gegebenenfalls Datenbank und Domain. Nach dem zweiten Projekt dauert die gesamte Prozedur nur wenige Minuten, und im Projekt-Dashboard sehen Sie alle Services und Verbindungen zwischen ihnen an einem Ort.

// weiterlesenLinear Schritt für Schritt: Team, Cycles, Roadmap und GitHubAnleitungenWie den Tag planen mit KI: Schritt für SchrittAnleitungenTypeless Schritt für Schritt: Berechtigungen, Shortcuts und WörterbuchAnleitungen

Kinetyra