Zum Hauptinhalt springen
Version: 1.89.x (Q2 26)

Pfadbasiertes Routing

Pfadbasiertes Routing ermöglicht es, mehrere unterschiedliche Anwendungen oder Micro-Frontends auf einer einzigen Domain zu hosten, indem der Traffic anhand des URL-Pfads weitergeleitet wird (z. B. wird example.com/blog an einen Workspace und example.com/api an einen anderen gesendet).

Anwendung vorbereiten

Wichtiger Schritt

Die Anwendung muss explizit dafür konfiguriert sein, Inhalte über den jeweiligen Unterpfad (z. B. /blog) auszuliefern, nicht nur über das Root-Verzeichnis (/). Das Routing in Codesphere einzurichten ist einfach, aber der Anwendungscode muss wissen, wie er mit dieser spezifischen Route umgeht. Insbesondere relative Links zu statischen Assets (z. B. CSS-Dateien) brechen häufig, wenn dies auf Anwendungsebene nicht berücksichtigt wird.

  1. Öffne den Codebase des Dienstes, den du unter einem Unterpfad hosten möchtest.
  2. Aktualisiere die Router-Konfiguration, sodass der Präfix enthalten ist.
  3. Deploye die aktualisierte Version der Anwendung.

Konfigurationsbeispiele

Passe deine Routendefinitionen an den gewünschten Unterpfad an.

app.get('/blog', (req, res) => {
res.send('Welcome to the blog!');
});

Routing konfigurieren

  1. Navigiere zum Tab Domains im Team-Dashboard.
  2. Klappe die verifizierte Domain auf, die konfiguriert werden soll.
  3. Klicke auf die Schaltfläche + Add new path.
  4. Gib den gewünschten Pfad ein (z. B. /blog oder /api/v1).
  5. Wähle den Ziel-Workspace aus, der den Dienst für diesen Pfad enthält.
  6. Klicke auf Save changes, um die Konfiguration zu übernehmen.

Ansicht der pfadbasierten Routing-Konfiguration, die URL-Pfade auf Zieldienste abbildet.

Überprüfung

  1. Warte einige Sekunden, bis sich die neuen Routing-Regeln im Netzwerk verbreitet haben.
  2. Rufe die Domain mit dem neu konfigurierten Pfad auf (z. B. https://example.com/blog).
  3. Bestätige, dass die richtige Anwendung geladen wird.

Fehlerbehebung bei einem 404-Fehler

Wenn ein 404 Not Found-Fehler angezeigt wird, überprüfe den Anwendungscode aus Phase 1 noch einmal. Das häufigste Problem ist, dass Codesphere den Traffic zwar erfolgreich an den Workspace weiterleitet, der Webserver innerhalb des Workspace aber weiterhin nur auf dem Root-Pfad (/) statt auf dem konfigurierten Unterpfad (/blog) lauscht.