Funktionsschalter

Diese Seite gibt einen Überblick über die verschiedenen Funktionsschalter, die Administratoren für etcd festlegen können.

Die Entwicklungsphasen einer Funktion werden unter Funktionsphasen erläutert.

Überblick

Funktionsschalter sind eine Menge von key=value-Paaren, die etcd-Funktionen beschreiben. Mit der Befehlszeilenoption --feature-gates lassen sich diese Funktionen in etcd ein- oder ausschalten.

etcd ermöglicht das Aktivieren oder Deaktivieren einer Gruppe von Funktionsschaltern. Mit der Option -h lässt sich die vollständige Liste der Funktionsschalter anzeigen. Zum Festlegen der Funktionsschalter der Option --feature-gates auf der Befehlszeile eine Liste von Funktionspaaren zuweisen:

--feature-gates=...,StopGRPCServiceOnDefrag=true

Alternativ feature-gates in der YAML-Konfigurationsdatei angeben:

feature-gates: ...,StopGRPCServiceOnDefrag=true

Änderung an der Struktur embed.Config

In 3.6 wird das Feld ServerFeatureGate zu embed.Config hinzugefügt. Es sollte die unten aufgeführten experimentellen Felder ersetzen:

package embed

type Config struct {
  // Deprecated: Use CompactHashCheck Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalCompactHashCheckEnabled bool `json:"experimental-compact-hash-check-enabled"`

  // Deprecated: Use InitialCorruptCheck Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalInitialCorruptCheck bool `json:"experimental-initial-corrupt-check"`

  // Deprecated: Use TxnModeWriteWithSharedBuffer Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalTxnModeWriteWithSharedBuffer bool `json:"experimental-txn-mode-write-with-shared-buffer"`

  // Deprecated: Use StopGRPCServiceOnDefrag Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalStopGRPCServiceOnDefrag bool `json:"experimental-stop-grpc-service-on-defrag"`

  // Deprecated: Use LeaseCheckpoint Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalEnableLeaseCheckpoint bool `json:"experimental-enable-lease-checkpoint"`
  
  // Deprecated: Use LeaseCheckpointPersist Feature Gate instead. Will be decommissioned in v3.7.
  ExperimentalEnableLeaseCheckpointPersist bool `json:"experimental-enable-lease-checkpoint-persist"`

+ // ServerFeatureGate is a server level feature gate
+ ServerFeatureGate featuregate.FeatureGate
  ...

Funktionsschalter für Alpha- oder Beta-Funktionen

Die folgenden Tabellen fassen die Funktionsschalter zusammen, die für etcd gesetzt werden können.

Eine Funktion verwenden

Funktionsphasen

Eine Funktion kann sich in der Phase Alpha, Beta, GA oder Veraltet befinden. Eine Alpha-Funktion bedeutet:

• Standardmäßig deaktiviert.
• Möglicherweise fehlerhaft. Durch das Aktivieren der Funktion können Fehler auftreten.
• Die Unterstützung der Funktion kann jederzeit ohne Ankündigung eingestellt werden.
• Die API kann sich in einer späteren Softwareversion ohne Ankündigung inkompatibel ändern.
• Aufgrund des erhöhten Fehlerrisikos und der fehlenden langfristigen Unterstützung nur für kurzlebige Testcluster empfohlen.

Eine Beta-Funktion bedeutet:

• Standardmäßig aktiviert.
• Die Funktion ist gründlich getestet. Ihre Aktivierung gilt als sicher.
• Die Unterstützung der Funktion insgesamt wird nicht eingestellt, Einzelheiten können sich jedoch ändern.
• Nur für nicht geschäftskritische Einsatzzwecke empfohlen, da bei breiterer Nutzung neue, schwer erkennbare Fehler entdeckt werden können.

Eine Funktion mit allgemeiner Verfügbarkeit (GA) wird auch als stabile Funktion bezeichnet. Das bedeutet:

• Die Funktion ist immer aktiviert und lässt sich nicht deaktivieren.
• Der zugehörige Funktionsschalter wird nicht mehr benötigt.
• Stabile Versionen von Funktionen werden in vielen nachfolgenden Softwareversionen enthalten sein.

Eine veraltete Funktion bedeutet:

• Der Funktionsschalter wird nicht mehr verwendet.
• Die Funktion hat den Status GA erreicht oder wurde entfernt.