Feature Flags
Codesphere organisiert Flags in drei Buckets in config.yaml:
| Bucket | Config-Schlüssel | Typ | Zweck |
|---|---|---|---|
| Features | codesphere.features | Map von Flag-Name zu true/false | Langlebige, stabile Fähigkeiten, die pro Installation umgeschaltet werden können |
| Preview | codesphere.preview | Map von Flag-Name zu true/false | Weniger ausgereifte oder riskantere Opt-in-Features; stabile API noch nicht garantiert |
| Internal | codesphere.internal | Liste von Flag-Namen | Codesphere-interne Flags, nicht für den Kundeneinsatz vorgesehen |
warnung
Preview- und Internal-Flags können sich in zukünftigen Releases ändern oder
entfernt werden. Verwende sie in Produktionsumgebungen mit Vorsicht und
bevorzuge, wo möglich, stabile features-Flags.
Bekannte Diskrepanz
Das Schema der Installationskonfiguration definiert codesphere.internal als
Liste von Flag-Namen. Der Installer, der Flags zum Deployment-Zeitpunkt
validiert, liest seine Liste interner Flags derzeit jedoch aus einem
Schlüssel codesphere.experiments statt 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 Fähigkeiten 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-Fähigkeiten mit geringerer Reife unter
codesphere.preview als Map von Boolean-Werten:
codesphere:
preview:
secret-management: true
workspace-ssh: true
Bekannte Preview-Flags: openfga-authz, preview-comments,
privileged-ports, secret-management, sub-path-mount, tcp-udp,
workspace-ssh.
Internal-Flags
codesphere.internal ist eine Liste von Flag-Namen für den internen Gebrauch
durch Codesphere. Aktiviere ein internes Flag in einer Kundeninstallation
nicht ohne ausdrückliche Anleitung durch Codesphere — siehe den Hinweis zur
Diskrepanz oben.