Zum Hauptinhalt springen
Version: Weekly Build

Arbeiten mit eigenen Domains

Codesphere ermöglicht es, eigene Domains (z. B. example.com) zusätzlich zu den generierten <workspace-id>.<data-center>.<your-codesphere-instance-domain>-URLs mit Workloads zu verbinden. Dieser Vorgang umfasst das Hinzufügen der Domain zum Team, die Verifizierung des Eigentums und das anschließende Routing des Datenverkehrs zum jeweiligen Workspace.

Hinzufügen einer Domain zum Team​

Übersichtsseite für eigene Domains mit einer Liste verbundener Domains und deren Verifizierungsstatus.

  1. Zum Tab Domains im Team-Dashboard navigieren.
  2. Auf die Schaltfläche + Add Domain oben rechts klicken.
  3. Den Domainnamen (z. B. your-domain.com) im Popup-Fenster eingeben und auf Add klicken.

Eigentum verifizieren (DNS-Konfiguration)​

Nach dem Hinzufügen muss das Eigentum an der Domain durch das Hinzufügen von DNS-Einträgen nachgewiesen werden.

Verifizierungseinträge für Domains

  1. Auf Settings (Zahnrad-Symbol) neben der neu hinzugefügten Domain klicken, um das Konfigurationspanel zu öffnen.
  2. Zum Tab Verification records wechseln.
  3. Es werden zwei Verifizierungsoptionen angezeigt. Die passende für den jeweiligen Anwendungsfall auswählen:

Verifizierungsoptionen

  • Option 1 (empfohlen für Subdomains): Einen CNAME-Eintrag hinzufügen, der auf den angezeigten Wert verweist (z. B. ...workspaces.codesphere.com).
  • Option 2 (in der Regel für Root-/Apex-Domains erforderlich): Einen A-Eintrag hinzufügen, der auf die angegebene IP-Adresse verweist (z. B. 145.40.95.110), sowie einen TXT-Eintrag mit der angegebenen Verifizierungszeichenfolge. Hinweis: Manche DNS-Anbieter (z. B. Cloudflare) unterstützen auch CNAME-Einträge für Root-Domains.
  1. Bei dem für die jeweilige Domain zuständigen DNS-Anbieter (z. B. Cloudflare oder Azure DNS) anmelden und diese Einträge hinzufügen.
  2. Einige Minuten warten, bis die Änderungen propagiert wurden, und anschließend in Codesphere auf Check Status klicken.

Datenverkehr zu den eigenen Services leiten​

Nach der Verifizierung muss Codesphere mitgeteilt werden, welcher Workspace den Datenverkehr für diese Domain empfangen soll.

Routing-Einstellungen für Domains

  1. Im Bereich der Domain-Einstellungen zum Tab Routing wechseln.
  2. Domain Access: Festlegen, ob die Domain Public (für alle zugänglich) oder Private (nur für Teammitglieder zugänglich) sein soll.
  3. Pfadbasiertes Routing:
    • Im Feld URL den Standardwert / belassen, um den gesamten Datenverkehr zu routen, oder ein Pfadpräfix angeben (z. B. /api/), um nur passende Anfragen zu routen.
    • Im Dropdown-Menü Workspaces den Workspace auswählen, mit dem verbunden werden soll. Es können mehrere Workspaces ausgewählt werden, um einen Traffic-Split zu erstellen (z. B. für A/B-Tests oder schrittweise Rollouts).
    • Auf + Add new path klicken, um bestimmte Pfade (wie /api) zu unterschiedlichen Workspaces zu routen.
  4. Auf Save changes klicken.

Mehrere Workspaces mit derselben Domain verbinden

Es können mehrere Workspaces mit derselben Domain verbunden werden. In diesem Fall wird der Datenverkehr im Verhältnis 1/N auf alle Workspaces aufgeteilt.

TLS/SSL-Zertifikate​

Codesphere verwaltet TLS-Zertifikate für verifizierte Domains automatisch.

  1. Zum Tab TLS Certificate wechseln.
  2. Sicherstellen, dass Automated ausgewählt ist. Codesphere generiert und erneuert Zertifikate automatisch, sobald die Domain verifiziert wurde.
  3. (Wenn der Status "Domain unverified" lautet, zuerst Schritt 2 abschließen.)

Private Cloud-Installationen

Bei Private Cloud-Installationen hängt die automatische Bereitstellung von TLS-Zertifikaten von der jeweiligen Konfiguration ab.

Selbst verwaltete Zertifikate

Um die Zertifikate selbst zu verwalten, auf die Schaltfläche Self-Managed klicken. In diesem Fall muss sichergestellt werden, dass die Zertifikate stets aktuell gehalten und abgelaufene Zertifikate eigenständig ersetzt werden, um Ausfallzeiten der Anwendung zu vermeiden.

Domain entfernen​

Um eine Domain zu entfernen:

  1. Auf das Mülleimer-Symbol neben der Domain in der Liste klicken.
  2. Die Aktion durch Klicken auf Remove Domain im Warn-Popup bestätigen.

Verfügbarkeit des Workspaces

Wenn eine Domain mit einem Workspace verbunden wird, der derzeit gestoppt ist, versucht Codesphere, diesen zu aktivieren, sobald ein Nutzer die Domain aufruft. Kaltstarts können dabei jedoch zu einer leichten Verzögerung führen. Für die beste Nutzererfahrung sollten Produktions-Workspaces auf "Always On" gesetzt sein.