Abgleichsstrategie
Bei der deklarativen Konfiguration definieren Sie den gewünschten Status des Systems. Das System versucht dann kontinuierlich, diesen Status so weit wie möglich zu gewährleisten. Weitere Informationen finden Sie unter Deklarative Verwaltung von Kubernetes-Objekten mithilfe von Konfigurationsdateien.
Mit Config Connector können Sie Ressourcen unabhängig von Abhängigkeitsbeziehungen in beliebiger Reihenfolge erstellen und aktualisieren. GKE verschiebt Ihre deklarierte Konfiguration in Richtung Eventual Consistency mit dem gewünschten Zustand.
Wenn Sie beispielsweise eine PubSubSubscription vor der entsprechenden PubSubTopic erstellen, wartet Config Connector, bis das Thema erstellt wurde, bevor Sie das zugehörige Abo erstellen.
Wie lange Ihre Config Connector-Installation inkonsistent bleibt, hängt von der Anzahl und der Art der verwalteten Ressourcen ab. Änderungen an einem GKE-Cluster werden in der Regel innerhalb von Sekunden ausgeführt. Die Zeit, die zum Erstellen vonGoogle Cloud -Ressourcen benötigt wird, kann jedoch je nach Ressourcentyp variieren. Beispielsweise dauert die Erstellung einer einzelnen PubSubTopic nur wenige Sekunden. Google Cloud-Ressourcen sind erst konsistent, wenn sie erstellt wurden. Wenn Sie beispielsweise eine SQLInstance und eine SQLDatabase erstellen, ist das System während der Erstellung der Datenbank für einige Minuten inkonsistent.
GKE und Config Connector gleichen jede Ressource bei jeder Aktualisierung oder nach einem Jitter-Zeitraum mit einem Durchschnitt basierend auf dem vorkonfigurierten Standardintervall ab. Das Standardintervall finden Sie auf der Referenzseite der jeweiligen Ressource unter „Config Connector Default Average Reconcile Interval In Seconds“.
Links zu den einzelnen Ressourcen finden Sie in der Ressourcenübersicht.
Wenn beim Abgleich ein Fehler auftritt, versucht Config Connector es mit exponentiellem Backoff noch einmal, wobei der maximale Backoff 2 Minuten beträgt. Für Ressourcen, die von direkten Controllern verwaltet werden, können Sie diesen Höchstwert mit der Annotation cnrm.cloud.google.com/backoff-max-delay-in-seconds konfigurieren. Sie können alle Fehler in den Ereignissen einer bestimmten Ressource aufrufen.
Abgleichintervall konfigurieren
Ab Config Connector 1.102 können Sie das durchschnittliche Abgleichsintervall für Ressourcen, die von Config Connector verwaltet werden, mit der Annotation cnrm.cloud.google.com/reconcile-interval-in-seconds konfigurieren. Der Wert der Annotation überschreibt den Standardwert von „Config Connector Default Average Reconcile Interval In Seconds“ auf der Seite Ressourcenreferenz.
Der Wert der Annotation muss eine nicht negative Ganzzahl sein, die die Zeit in Sekunden darstellt. Wenn der Wert auf 0 gesetzt ist, beendet Config Connector die Initiierung von Abgleichen für die Ressource, sobald sie den Status UpToDate erreicht. Diese Annotation steuert den regelmäßigen Abgleich, nachdem die Ressource den Status UpToDate erreicht hat. Die Annotation hat keine Auswirkungen auf die Wiederholungsintervalle, wenn der Abgleich fehlschlägt. Weitere Informationen finden Sie unter Exponentiellen Backoff für Abgleichfehler konfigurieren.
Wenn Sie beispielsweise möchten, dass Config Connector eine Ressource seltener abgleicht, um Probleme mit dem zugrunde liegenden Google Cloud API-Kontingent zu vermeiden, können Sie den durchschnittlichen Abgleichintervallwert auf 1 Stunde festlegen.
cnrm.cloud.google.com/reconcile-interval-in-seconds: "3600"
Wenn Config Connector eine Ressource häufiger abgleichen soll, um Abweichungen schneller zu korrigieren, können Sie die Annotation mit einem kleinen Wert festlegen.
Mit dem folgenden Script können Sie alle Ressourcen eines bestimmten Typs annotieren, die dieselbe GVK (Group Version Kind) haben:
#!/bin/bash
KIND=RESOURCE_KIND
NAMESPACE=RESOURCE_NAMESPACE
ANNOTATION_KEY="cnrm.cloud.google.com/reconcile-interval-in-seconds"
ANNOTATION_VALUE=RECONCILE_INTERVAL
kubectl annotate --overwrite --all ${KIND} ${ANNOTATION_KEY}=${ANNOTATION_VALUE} -n ${NAMESPACE}
echo "Annotation added to all ${KIND} RESOURCE"
Ersetzen Sie Folgendes:
RESOURCE_KIND: die Ressourcenart, die Sie annotieren möchten.RESOURCE_NAMESPACE: der Namespace, der die Ressourcen enthält, die Sie annotieren möchten.RECONCILE_INTERVAL: das Abgleichintervall in Sekunden.
Sie können das Abgleichsintervall auf 0 setzen, um die Driftkorrektur für eine Ressource zu deaktivieren. Dadurch wird die Ressourcenbetätigung jedoch nicht deaktiviert. Wenn Sie Änderungen an der Ressource Spec vornehmen, wird die Ressource noch einmal abgeglichen.
Das Festlegen des Abgleichsintervalls auf 0 kann nicht rückgängig gemacht werden. Das bedeutet, dass Config Connector die Ressource nicht noch einmal abgleicht, wenn Sie den Wert wieder in eine Zahl ungleich null ändern.
Wenn Sie das Abgleichsintervall „0“ rückgängig machen möchten, haben Sie die folgenden Optionen:
- Ändern Sie die Ressourcenspezifikation mit dem Wert für das Abgleichsintervall, um neue Abgleiche zu ermöglichen.
- Geben Sie die Ressource auf, indem Sie die Annotation
cnrm.cloud.google.com/deletion-policy: "abandon"festlegen, und erstellen Sie die Ressource mit einem anderen Wert für das Abgleichsintervall als 0 neu.
Exponentiellen Backoff für Abgleichfehler konfigurieren
Wenn eine Ressource nicht abgeglichen werden kann, versucht Config Connector den Abgleich mit exponentiellem Backoff noch einmal. Die Verzögerung beginnt bei 250 Millisekunden und verdoppelt sich nach jedem fehlgeschlagenen Versuch (z. B. 500 Millisekunden, dann 1 Sekunde, dann 2 Sekunden) bis zu einem Standardmaximum von 2 Minuten.
Die Annotation cnrm.cloud.google.com/reconcile-interval-in-seconds steuert die regelmäßige Driftkorrektur, nachdem eine Ressource den Status UpToDate erreicht hat. In Config Connector-Version 1.160.0 und höher können Sie die Annotation cnrm.cloud.google.com/backoff-max-delay-in-seconds verwenden, um das Wiederholungsverhalten zu steuern, wenn der Abgleich fehlschlägt. Legen Sie für die Annotation einen der folgenden Werte fest:
- Eine positive Ganzzahl (
"1"oder höher): Legt die maximale Verzögerung zwischen Wiederholungsversuchen in Sekunden fest. Beispiel: Mit"600"wird das Wiederholungsintervall auf 10 Minuten und mit"3600"auf 1 Stunde begrenzt. "0": beendet automatische Wiederholungsversuche nach einem fehlgeschlagenen Abgleich. Die Ressource bleibt in einem fehlgeschlagenen Zustand, bis eine Änderung den Abgleich auslöst, z. B. eine Aktualisierung vonspec,metadata.labels,metadata.annotationsoder einer referenzierten Ressource oderSecret.
Wenn Sie beispielsweise die Wiederholungsintervalle auf 30 Minuten begrenzen und den API-Kontingentverbrauch von Google Cloud für fehlerhafte Ressourcen reduzieren möchten, fügen Sie die folgende Annotation hinzu:
metadata:
annotations:
cnrm.cloud.google.com/backoff-max-delay-in-seconds: "1800"
Wenn Sie automatische Wiederholungsversuche bei Abgleichsfehlern beenden möchten, bis Sie die Ressource aktualisieren, fügen Sie die folgende Annotation hinzu:
metadata:
annotations:
cnrm.cloud.google.com/backoff-max-delay-in-seconds: "0"
Änderbare, aber nicht lesbare Felder werden nur bei Änderungen berücksichtigt
Einige APIs stellen Felder bereit, die nicht lesbar, aber änderbar sind (z. B. das Passwort für einen SQL-Nutzer). Da nicht festgestellt werden kann, ob diese Felder geändert wurden, werden veränderliche, aber nicht lesbare Felder nur aktualisiert, wenn die benutzerdefinierte Ressource geändert wird.
Ressourcen werden beim Ändern unveränderlicher Felder nicht neu erstellt.
Einige Felder in einer Ressource sind unveränderlich und können nicht abgeglichen werden, ohne die Zielressource zu löschen und anschließend neu zu erstellen.
In diesen Situationen gibt Config Connector ein Kubernetes-Ereignis „UpdatedFailed“ für die Ressource aus, anstatt diese Neuerstellung durchzuführen. Anschließend müssen Sie die Ressource löschen und neu erstellen.
Beispielereignis:
Warning UpdateFailed 37m (x643 over 15d) computeinstance-controller Update call failed: the desired mutation for the following field(s) is invalid: [bootDisk.0.InitializeParams.0.Image networkInterface.0.NetworkIp]