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

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 den eigenen Workloads zu verbinden. Dieser Prozess umfasst das Hinzufügen der Domain zum Team, die Verifizierung des Eigentums und anschließend das Routing des Datenverkehrs zum jeweiligen Workspace.

Hinzufügen einer Domain zum Team​

Übersichtsseite für eigene Domains mit Liste der verbundenen Domains und deren Verifizierungsstatus.

  1. Im Team-Dashboard zum Tab Domains 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 der Nachweis des Domain-Eigentums durch das Hinzufügen von DNS-Einträgen erfolgen.

Verifizierungseinträge für Domains

  1. Auf das Settings-Symbol (Zahnrad) neben der neu hinzugefügten Domain klicken, um das Konfigurationsfenster zu öffnen.
  2. Zum Tab Verification records wechseln.
  3. Es stehen zwei Verifizierungsoptionen zur Auswahl. Die passende für den jeweiligen Anwendungsfall wä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. Beim DNS-Anbieter (z. B. Cloudflare oder Azure DNS) für die entsprechende Domain anmelden und diese Einträge hinzufügen.
  2. Ein paar Minuten warten, bis die Änderungen propagiert sind, und anschließend in Codesphere auf Check Status klicken.

Datenverkehr zu den eigenen Services routen​

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

Routing-Einstellungen für Domains

  1. Im Domain-Einstellungsbereich zum Tab Routing wechseln.
  2. Domain Access: Auswählen, 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 / beibehalten, um den gesamten Datenverkehr zu routen, oder ein Pfadpräfix (z. B. /api/) angeben, um nur passende Anfragen zu routen.
    • Im Dropdown-Menü Workspaces den zu verbindenden Workspace auswählen. Es können mehrere Workspaces ausgewählt werden, um den Datenverkehr aufzuteilen (z. B. für A/B-Tests oder schrittweise Rollouts).
    • Auf + Add new path klicken, um bestimmte Pfade (z. B. /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. (Falls der Status "Domain unverified" angezeigt wird, zunächst Schritt 2 durchführen.)

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 Papierkorb-Symbol neben der Domain in der Liste klicken.
  2. Die Aktion durch Klicken auf Remove Domain im Warnhinweis-Popup bestätigen.

Verfügbarkeit des Workspace

Wird eine Domain mit einem derzeit gestoppten Workspace verbunden, versucht Codesphere, diesen zu aktivieren, sobald ein Nutzer die Domain aufruft. Ein Cold Start kann dabei jedoch zu einer kurzen Verzögerung führen. Für die beste Nutzererfahrung sollten produktive Workspaces auf "Always On" gesetzt werden.