Feature Flags

Codesphere organisiert Flags in config.yaml in drei Bereiche:

Bereich	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 die Nutzung durch Kunden vorgesehen

warnung

Preview- und Internal-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 Liste von Flag- Namen. Der Installer, der Flags zum Zeitpunkt des Deployments validiert, liest seine Internal-Flag-Liste jedoch derzeit aus einem Schlüssel codesphere.experiments und 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 boolescher Werte:

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 noch weniger ausgereift sind, unter codesphere.preview als Map boolescher Werte:

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.

secret-management erfordert zusätzlich, dass OpenBao installiert und konfiguriert ist (oms install openbao); wird das Flag ohne dies aktiviert, bleibt das Secret Management funktionslos, ohne dass zum Installationszeitpunkt ein Fehler angezeigt wird.

Internal-Flags

codesphere.internal ist eine Liste von Flag-Namen für die Codesphere-interne Nutzung. Aktiviere kein internes Flag in einer Kunden-Installation ohne ausdrückliche Anweisung von Codesphere — siehe den Hinweis zur Abweichung oben.