Codesphere Feature Flags
Codesphere organisiert Flags in zwei Reifegrade, die jeweils unterschiedlich in der config.yaml konfiguriert werden:
| Bucket | Config-Schlüssel | Zweck |
|---|---|---|
| Features | codesphere.features | Langlebige, stabile Funktionen, die pro Installation umschaltbar sind |
| Preview | codesphere.experiments | Weniger ausgereifte oder risikoreichere Opt-in-Funktionen; stabile API noch nicht garantiert |
warnung
Preview-Flags können sich in zukünftigen Releases ändern oder entfernt werden. In Produktionsumgebungen mit Vorsicht verwenden.
Feature Flags
Feature Flags steuern langlebige, stabile Funktionen der Codesphere-Installation. Konfiguriert werden sie unter codesphere.features als Map von Boolean-Werten.
| Flag | Beschreibung | Standard (Private Cloud) |
|---|---|---|
billing | Aktiviert Billing-Funktionen für Workspace- und Hosting-Pläne. | false |
avatar-upload | Erlaubt Nutzern, einen eigenen Profil-Avatar hochzuladen. Erfordert GCloud Storage | false |
dev-domains-port | Aktiviert portbasiertes Routing für Development-Domains. | false |
email-signup | Erlaubt Nutzern die Registrierung mit einer E-Mail-Adresse. | false |
email-signin | Erlaubt Nutzern die Anmeldung mit einer E-Mail-Adresse. | false |
run-as-root-insecure | Erlaubt, dass Workspaces als root laufen. Sicherheitsrisiko — nur in vertrauenswürdigen Umgebungen verwenden. | false |
standalone-teams | Erlaubt, dass Teams außerhalb einer Organization existieren. Wenn deaktiviert, muss jedes Team einer Organization angehören. Weitere Informationen unter Organizations & Teams. | false |
Beispiel:
codesphere:
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
Preview Flags
Preview Flags aktivieren weniger ausgereifte oder risikoreichere kundenseitig sichtbare Funktionen. Sie sind Opt-in und müssen explizit aktiviert werden. Derzeit werden Preview Flags über die experiments-Konfiguration als Liste zu aktivierender Flag-Namen gesetzt.
| Flag | Beschreibung |
|---|---|
cluster-admin | Internes/experimentelles Flag (zur experiments-Liste hinzufügen). Aktiviert die Cluster-Administrations-Endpunkte in der Public API zum Provisionieren von Organizations und Cluster-Admins. Erfordert das Flag openfga-authz. Siehe Organizations API-Referenz. |
privileged-ports | Erlaubt Workspaces, auf privilegierten Ports im Bereich [0..1024) zu lauschen. |
secret-management | Aktiviert die Secret-Management-Funktion für Workspaces. |
sub-path-mount | Aktiviert Sub-Path-Volume-Mounting in Workspaces. |
tcp-udp | Aktiviert die TCP/UDP-Port-Freigabe für Workspaces über Standard-HTTP/HTTPS hinaus. |
ws-vscode-server | Aktiviert die VS Code Server-Integration innerhalb von Workspaces. |
Beispiel:
codesphere:
# Preview Flags werden aktiviert, indem sie zur experiments-Liste hinzugefügt werden.
experiments:
- privileged-ports
- ws-vscode-server
Vollständiges Beispiel
Das folgende Beispiel zeigt alle drei Flag-Buckets gemeinsam konfiguriert:
codesphere:
# ... weitere Einstellungen ...
# Langlebige Feature Flags
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
# Preview Flags — Flag-Namen hinzufügen, um sie zu aktivieren
# Mit Vorsicht verwenden!
experiments:
- privileged-ports