Cluster aktualisieren

Nachdem Sie einen Cluster mit bmctl erstellt haben, können Sie die benutzerdefinierten Ressourcen dieses Clusters aktualisieren. Die Konfigurationsdatei wird als bmctl-workspace/CLUSTER-NAME/CLUSTER-NAME.yaml gespeichert, sofern Sie keinen anderen Speicherort angegeben haben.

Knoten in einem Cluster hinzufügen oder entfernen

In Anthos-Cluster on Bare Metal können Sie Knoten in einem Cluster hinzufügen oder entfernen, indem Sie die Knotenpooldefinitionen des Clusters bearbeiten. Sie können diese Definitionen mit dem Befehl bmctl ändern.

Es gibt drei verschiedene Arten von Knotenpools in Anthos-Cluster on Bare Metal: Steuerungsebene, Load-Balancer und Worker-Knotenpools.

Knotenstatus ansehen

Mit dem Befehl kubectl get können Sie den Status von Knoten und den zugehörigen Knotenpools anzeigen lassen.

Der folgende Befehl zeigt beispielsweise den Status der Knotenpools im Cluster-Namespace my-cluster an:

kubectl -n my-cluster get nodepools.baremetal.cluster.gke.io

Das System gibt Ergebnisse ähnlich der folgenden:

NAME                    READY   RECONCILING   STALLED   UNDERMAINTENANCE   UNKNOWN
my-cluster              3       0             0         0                  0
my-cluster-lb           2       0             0         0                  0
np1                     3       0             0         0                  0

Weitere Informationen zur Diagnose Ihrer Cluster finden Sie unter Cluster diagnostizieren und zurücksetzen.

Knoten ändern

Die meisten Knotenänderungen werden in der Clusterkonfigurationsdatei angegeben, die dann auf den Cluster angewendet wird. Wir empfehlen die Verwendung der Cluster-Konfigurationsdatei als primäre Quelle für die Aktualisierung des Clusters. Es empfiehlt sich, die Konfigurationsdatei in einem Versionsverwaltungssystem zu speichern, um Änderungen für die Fehlerbehebung zu verfolgen. Verwenden Sie für alle Clustertypen den Befehl bmctl update, um Ihren Cluster mit Ihren Knotenänderungen zu aktualisieren.

Die Clusterkonfigurationsdatei der Anthos-Cluster auf Bare-Metal- enthält einen Header-Abschnitt mit Anmeldedaten. Die Anmeldedateneinträge und der Rest der Konfigurationsdatei sind gültiges YAML, aber die Anmeldedaten sind für die Clusterressource nicht gültig. Verwenden Sie bmctl update credentials für die Aktualisierung von Anmeldedaten.

Wenn Sie Knoten aus einem Cluster entfernen, werden alle Pods zuerst per Drain beendet. Knoten können nicht aus dem Cluster entfernt werden, wenn Pods nicht auf anderen Knoten neu geplant werden können. Der Befehl bmctl update parst die Clusterkonfigurationsdatei und wendet benutzerdefinierte Ressourcen anhand des geparsten Ergebnisses an.

Hier eine Beispielkonfiguration mit zwei Knoten:

---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
  name: nodepool1
  namespace: cluster-cluster1
spec:
  clusterName: cluster1
  nodes:
  - address: 172.18.0.5
  - address: 172.18.0.6

Sie können einen Knoten aus dem Knotenpool entfernen, indem Sie seinen Eintrag löschen:

---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
  name: nodepool1
  namespace: cluster-cluster1
spec:
  clusterName: cluster1
  nodes:
  - address: 172.18.0.5

Führen Sie zum Aktualisieren des Clusters den folgenden Befehl für die selbstverwalteten Cluster aus, z. B. für Administratorcluster und für eigenständige Cluster:

bmctl update cluster -c CLUSTER_NAME \
    --kubeconfig=KUBECONFIG

Nachdem der Befehl bmctl update erfolgreich ausgeführt wurde, dauert es eine Weile, bis die Pods machine-init oder machine-reset ausgeführt werden.

In den folgenden Abschnitten werden einige wichtige Unterschiede bei der Aktualisierung bestimmter Knotentypen beschrieben.

Knoten der Steuerungsebene und der Load-Balancer

Die Steuerungsebene- und Load-Balancer-Knotenpoolspezifikationen für Anthos-Cluster auf Bare-Metal sind spezifisch. Diese Spezifikationen deklarieren und steuern wichtige Clusterressourcen. Die kanonische Quelle für diese Ressourcen sind die entsprechenden Abschnitte in der Cluster-Konfigurationsdatei:

  • spec.controlPlane.nodePoolSpec
  • spec.LoadBalancer.nodePoolSpec

Zum Hinzufügen oder Entfernen von Steuerungsebenen- oder Load-Balancer-Knoten bearbeiten Sie das Array von Adressen im korrespondierenden Abschnitt der Clusterkonfigurationsdatei unter nodes.

Bei einer Hochverfügbarkeitskonfiguration ist eine ungerade Anzahl von Knotenpools (drei oder mehr) der Steuerungsebene erforderlich, um ein Quorum zu erstellen. So wird sichergestellt, dass bei einem Ausfall einer Steuerungsebene auch andere übernommen werden. Wenn Sie vorübergehend eine gerade Anzahl von Knoten haben, während Sie Knoten zur Wartung oder zum Austausch hinzufügen oder entfernen, hält Ihre Bereitstellung HA aufrecht, solange Sie genügend Quorum haben.

Worker-Knoten

Mit dem Befehl bmctl können Sie Worker-Knoten direkt hinzufügen oder entfernen. Worker-Knotenpools müssen mindestens einen gewünschten Knoten haben. Sie können aber den gesamten Knotenpool mit dem Befehl kubectl entfernen. Im folgenden Beispiel löscht der Befehl einen Knotenpool namens np1, wobei die Variable für den Cluster-Namespace my-cluster lautet:

kubectl -n my-cluster delete nodepool np1

Sonstige veränderbare Felder

Neben dem Hinzufügen und Entfernen von Knoten können Sie auch mit dem Befehl bmctl update bestimmte Elemente der Clusterkonfiguration ändern. Zum Aktualisieren der Clusterressource bearbeiten Sie normalerweise die lokale Version der Clusterkonfigurationsdatei und wenden die Änderungen mit bmctl update an. Der Befehl bmctl update ähnelt dem Befehl kubectl apply.

In den folgenden Abschnitten werden einige gängige Beispiele zum Aktualisieren eines vorhandenen Clusters beschrieben, indem entweder ein Feldwert oder eine zugehörige benutzerdefinierte Ressource geändert wird.

loadBalancer.addressPools

Der Abschnitt addressPools enthält Felder zum Angeben von Load-Balancing-Pools für gebündelte Load-Balancer. Sie können jederzeit weitere Load-Balancing-Adresspools hinzufügen, aber keine vorhandenen Adresspools entfernen oder ändern.

addressPools:
- name: pool1
  addresses:
  - 192.168.1.0-192.168.1.4
  - 192.168.1.240/28
- name: pool2
  addresses:
  - 192.168.1.224/28

bypassPreflightCheck

Der Standardwert des Felds bypassPreflightCheck ist false. Wenn Sie dieses Feld in der Clusterkonfigurationsdatei auf true setzen, werden die internen Preflight-Prüfungen ignoriert, wenn Sie Ressourcen auf vorhandene Cluster anwenden.

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  bypassPreflightCheck: true

loginUser

Sie können das Feld loginUser unter der Konfiguration des Knotenzugriffs festlegen. Dieses Feld unterstützt die sudo-Funktion ohne Passwort für die Maschinenanmeldung.

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: cluster1
  namespace: cluster-cluster1
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  nodeAccess:
    loginUser: abm

BGPLoadBalancer

Mit bmctl können Sie BGP-basierte Load-Balancer über die gebündelte LB-Option von Google anwenden und aktualisieren.

apiVersion: "networking.gke.io/v1alpha1"
kind: BGPLoadBalancer
metadata:
 name: default
 namespace: cluster-cluster1
spec:
 localASN: 65001
 peers:
 - peerASN: 65000
   peerIP: 10.0.1.1

NetworkAttachmentDefinition

Mit dem Befehl bmctl update können Sie benutzerdefinierte NetworkAttachmentDefinition-Ressourcen ändern, die dem Netzwerk entsprechen.

apiVersion: "k8s.cni.cncf.io/v1"
kind: NetworkAttachmentDefinition
metadata:
  name: gke-network-1
  namespace: cluster-my-cluster
spec:
  config: '{
  "type": "ipvlan",
  "master": "enp2342",
  "mode": "l2",
  "ipam": {
    "type": "whereabouts",
    "range": "172.120.0.0/24"

Nachdem Sie die Konfigurationsdatei geändert haben, können Sie den Cluster mit dem Befehl bmctl update aktualisieren. Er parst die Clusterkonfigurationsdatei und wendet benutzerdefinierte Ressourcen anhand des geparsten Ergebnisses an.

Für selbstverwaltete Cluster wie Administratorcluster und eigenständige Cluster führen Sie den folgenden Befehl aus:

bmctl update cluster -c CLUSTER_NAME --kubeconfig=KUBECONFIG

Für Nutzercluster führen Sie den folgenden Befehl aus:

bmctl update cluster -c CLUSTER_NAME --admin-kubeconfig=ADMIN_KUBECONFIG