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 geleitet wird (z. B. example.com/blog an einen Workspace und example.com/api an einen anderen).
Anwendung vorbereiten
Wichtiger Schritt
Die Anwendung muss explizit so konfiguriert sein, dass sie Inhalte aus dem jeweiligen Unterpfad (z. B. /blog) ausliefert, nicht nur aus dem Root-Pfad (/). Das Einrichten des Routings in Codesphere ist einfach, aber der Anwendungscode muss wissen, wie mit diesem spezifischen Pfad umzugehen ist. Besonders relative Links zu statischen Assets (z. B. CSS-Dateien) brechen häufig, wenn dies auf Anwendungsebene nicht berücksichtigt wird.
- Öffne die Codebasis des Services, den du unter einem Unterpfad hosten möchtest.
- Aktualisiere die Router-Konfiguration, um das Präfix einzubinden.
- Deploye die aktualisierte Version der Anwendung.
Konfigurationsbeispiele
- Express.js
- React Router
Passe die Routendefinitionen so an, dass sie dem gewünschten Unterpfad entsprechen.
app.get('/blog', (req, res) => {
res.send('Welcome to the blog!');
});
Setze die basename-Eigenschaft in der Router-Konfiguration, damit React weiß, dass die Anwendung 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.
- Erweitere die verifizierte Domain, die du konfigurieren möchtest.
- Klicke auf die Schaltfläche + Add new path.
- Gib den gewünschten Pfad ein (z. B.
/blogoder/api/v1). - Wähle den Ziel-Workspace, der den Service 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 deine Domain mit dem neu konfigurierten Pfad auf (z. B.
https://example.com/blog). - Vergewissere dich, 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 erneut. Das häufigste Problem ist, dass Codesphere den Traffic zwar erfolgreich an den Workspace weiterleitet, der Webserver innerhalb des Workspace jedoch weiterhin nur auf dem Root-Pfad (/) statt auf dem konfigurierten Unterpfad (/blog) lauscht.