Feature Flags
Codesphere organisiert Flags in drei Kategorien in config.yaml:
| Kategorie | Konfigurationsschlüssel | Typ | Zweck |
|---|---|---|---|
| Features | codesphere.features | Map von Flag-Name zu true/false | Langlebige, stabile Funktionen, die pro Installation umgeschaltet werden können |
| Preview | codesphere.preview | Map von Flag-Name zu true/false | Weniger ausgereifte oder riskantere Opt-in-Funktionen; stabile API noch nicht garantiert |
| Internal | codesphere.internal | Liste von Flag-Namen | Codesphere-interne Flags, nicht für den Kundeneinsatz vorgesehen |
warnung
Preview- und interne Flags können sich in zukünftigen Releases ändern oder entfernt werden. Verwende sie mit
Vorsicht in Produktionsumgebungen und bevorzuge, wo möglich, stabile features-Flags.
Bekannte Abweichung
Das Installationskonfigurationsschema definiert codesphere.internal als eine Liste von Flag-
Namen. Der Installer, der Flags zum Zeitpunkt der Bereitstellung validiert, liest seine
Liste interner Flags jedoch aktuell aus einem Schlüssel codesphere.experiments, nicht aus
codesphere.internal. Kläre mit Codesphere ab, welcher Schlüssel für deine Installer-
Version gilt, bevor du dich darauf verlässt, dass ein internes Flag durchgängig aktiviert ist.
Feature-Flags
Konfiguriere stabile, langlebige Funktionen unter codesphere.features als Map von
Boolean-Werten:
codesphere:
features:
email-signup: true
email-signin: true
billing: false
standalone-teams: false
Bekannte Feature-Flags: avatar-upload, billing, dev-domains-port, email-signin,
email-signup, run-as-root-insecure, standalone-teams.
Preview-Flags
Konfiguriere Opt-in-Funktionen, die weniger ausgereift sind, unter codesphere.preview als Map von
Boolean-Werten:
codesphere:
preview:
secret-management: true
workspace-ssh: true
Bekannte Preview-Flags: cimg-private-registry, openfga-authz, preview-comments, privileged-ports,
secret-management, sub-path-mount, tcp-udp, team-container-registries, workspace-ssh.
Interne Flags
codesphere.internal ist eine Liste von Flag-Namen für den Codesphere-internen Gebrauch. Aktiviere
kein internes Flag in einer Kundeninstallation ohne ausdrückliche Anweisung von
Codesphere — siehe den obigen Hinweis zur Abweichung.