Zum Hauptinhalt springen
Version: Weekly Build

Arbeiten mit benutzerdefinierten 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 zur Resource Group, die Überprüfung der Inhaberschaft und schließlich das Routing des Datenverkehrs zum gewünschten Workspace.

Eine Domain zur Resource Group hinzufügen​

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

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

Inhaberschaft überprüfen (DNS-Konfiguration)​

Nach dem Hinzufügen muss nachgewiesen werden, dass die Domain tatsächlich im eigenen Besitz ist – dies geschieht durch das Hinzufügen von DNS-Einträgen.

DNS-Verifizierungseinträge für Domains

  1. Auf das Settings-Symbol (Zahnrad) neben der neu hinzugefügten Domain klicken, um das Konfigurationspanel zu öffnen.
  2. Zum Tab Verification records wechseln.
  3. Es stehen zwei Verifizierungsoptionen zur Auswahl. Die passende je nach 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 (üblicherweise erforderlich für Root-/Apex-Domains): Einen A-Eintrag hinzufügen, der auf die bereitgestellte IP-Adresse verweist (z. B. 145.40.95.110), sowie einen TXT-Eintrag mit der bereitgestellten 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 jeweilige Domain anmelden und diese Einträge hinzufügen.
  2. Einige 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. Zum Tab Routing in den Domain-Einstellungen wechseln.
  2. Domain Access: Auswählen, ob die Domain Public (für alle zugänglich) oder Private (nur für Mitglieder der Resource Group) sein soll.
  3. Pfadbasiertes Routing:
    • Im Feld URL entweder den Standardwert / belassen, 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 gewünschten Workspace auswählen, mit dem verbunden werden soll. Es können mehrere Workspaces ausgewählt werden, um eine Traffic-Verteilung 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 zu gleichen Teilen (1/N) auf alle Workspaces verteilt.

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 ist.
  3. (Falls der Status „Domain unverified“ angezeigt wird, 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

Falls die Zertifikate selbst verwaltet werden sollen, auf die Schaltfläche Self-Managed klicken. In diesem Fall muss selbst sichergestellt werden, dass die Zertifikate aktuell bleiben und abgelaufene Zertifikate rechtzeitig ersetzt werden, um Ausfallzeiten der Anwendung zu vermeiden.

Eine Domain entfernen​

Um eine Domain zu entfernen:

  1. Auf das Papierkorb-Symbol neben der Domain in der Liste klicken.
  2. Die Aktion bestätigen, indem im Warnhinweis-Pop-up auf Remove Domain geklickt wird.
Verfügbarkeit des Workspace

Wird eine Domain mit einem Workspace verknüpft, der derzeit gestoppt ist, versucht Codesphere, diesen zu aktivieren, sobald ein Nutzer die Domain aufruft. Durch den Kaltstart kann es jedoch zu einer kurzen Verzögerung kommen. Für die beste Nutzererfahrung sollten Produktions-Workspaces auf „Always On“ gesetzt werden.