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.
- Öffne den Codebase des Dienstes, den du unter einem Unterpfad hosten möchtest.
- Aktualisiere die Router-Konfiguration, sodass der Präfix enthalten ist.
- Deploye die aktualisierte Version der Anwendung.
Konfigurationsbeispiele
- Express.js
- React Router
Passe deine Routendefinitionen an den gewünschten Unterpfad an.
app.get('/blog', (req, res) => {
res.send('Welcome to the blog!');
});
Setze die basename-Eigenschaft in der Router-Konfiguration, damit React weiß, dass es nicht aus dem Root-Verzeichnis ausgeliefert wird.
import { BrowserRouter } from 'react-router-dom';
function App() {
return (
<BrowserRouter basename="/blog">
{/* Your routes go here */}
</BrowserRouter>
);
}
Routing konfigurieren
- Navigiere zum Tab Domains im Team-Dashboard.
- Klappe die verifizierte Domain auf, die konfiguriert werden soll.
- Klicke auf die Schaltfläche + Add new path.
- Gib den gewünschten Pfad ein (z. B.
/blogoder/api/v1). - Wähle den Ziel-Workspace aus, der den Dienst für diesen Pfad enthält.
- Klicke auf Save changes, um die Konfiguration zu übernehmen.

Überprüfung
- Warte einige Sekunden, bis sich die neuen Routing-Regeln im Netzwerk verbreitet haben.
- Rufe die Domain mit dem neu konfigurierten Pfad auf (z. B.
https://example.com/blog). - 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.