Volume-Erweiterung verwenden

In der Google Kubernetes Engine (GKE) Version 1.24 oder höher können Sie mit dem Volume-Feature von Kubernetes die Kapazität eines nichtflüchtigen Volumes nach dessen Erstellung ändern.

Weitere Informationen zur Volume-Erweiterung finden Sie in der Open-Source-Dokumentation zu Kubernetes.

Vorbereitung

Für die Volume-Erweiterung gelten die folgenden Voraussetzungen:

  • Wenn das Volume, dessen Größe Sie anpassen möchten, von einem CSI-Treiber verwaltet wird:
    • Achten Sie darauf, dass die GKE-Clusterversion 1.16 oder höher ist. Wenn der Cluster Windows-Knotenpools hat, muss die GKE-Clusterversion 1.18 oder höher sein. Wenn Sie den verwalteten GKE Filestore-CSI-Treiber verwenden, muss die Clusterversion 1.21 oder höher sein.
    • Prüfen Sie in der Dokumentation Ihres Speicheranbieters, ob Ihr CSI-Treiber die Volume-Erweiterung unterstützt. Der Compute Engine Persistent Disk-CSI-Treiber und der Filestore-CSI-Treiber unterstützen die Volume-Erweiterung.
  • Wenn das Volume, dessen Größe Sie anpassen möchten, von einem integrierten Volume-Plug-in verwaltet wird:
    • Achten Sie darauf, dass die GKE-Clusterversion 1.11 oder höher ist. Die GKE-Clusterversionen 1.11–1.14 unterstützen zwar die Erweiterung von Volumes, die von integrierten Plug-ins verwaltet werden, erfordern jedoch, dass alle Pods, die das Volume verwenden, beendet und neu erstellt werden, um die Volume-Erweiterung abzuschließen.
    • Lesen Sie in der Dokumentation Ihres Speicheranbieters nach, ob Ihr integriertes Volume-Plug-in die Volume-Erweiterung unterstützt. (Das integrierte Volume-Plug-in für Compute Engine Persistent Disk tut dies.)

Volume-Erweiterung verwenden

Führen Sie folgende Schritte aus, um die Volume-Erweiterung zu verwenden:

  1. Fügen Sie Ihrer StorageClass allowVolumeExpansion: true hinzu, wenn Ihre StorageClass das Feld noch nicht enthält. Beispiel:

    apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: standard
provisioner: my.driver
...
allowVolumeExpansion: true

  2. Fordern Sie eine Änderung der Volumenkapazität an, indem Sie das Feld spec.resources.requests.storage Ihres PersistentVolumeClaim bearbeiten.

     kubectl edit pvc pvc-name

    Sie können beispielsweise den folgenden PVC so ändern, dass sein Speicher von 30 Gibibyte (GiB) auf 40 GiB vergrößert wird.

    Vor der Bearbeitung:

     # pvc-demo.yaml
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
   name: pvc-demo
 spec:
   accessModes:
     - ReadWriteOnce
   resources:
     requests:
       storage: 30Gi

    Nach der Bearbeitung:

     # pvc-demo.yaml
 apiVersion: v1
 kind: PersistentVolumeClaim
 metadata:
   name: pvc-demo
 spec:
   accessModes:
     - ReadWriteOnce
   resources:
     requests:
       storage: 40Gi

  3. Prüfen Sie die Änderung durch Aufrufen des PVC. Führen Sie den folgenden Befehl aus, um den PVC aufzurufen:

    kubectl get pvc pvc-name -o yaml

    Schließlich sollte das neue Volume im Feld status.capacity angezeigt werden. Beispiel:

    ...
spec:
  accessModes:
  - ReadWriteOnce
  resources:
    requests:
      storage: 40Gi
  storageClassName: standard
  volumeMode: Filesystem
  volumeName: pvc-078b7484-cc8d-4077-9bcb-2c17d8d4550c
status:
  accessModes:
  - ReadWriteOnce
  capacity:
    storage: 40Gi
...

Wenn die Kapazität eines PersistentVolume direkt geändert wird, kann dies dazu führen, dass das Containerdateisystem falsch ist. Informationen zur Behebung dieser Probleme finden Sie unter Fehlerbehebung bei Änderungen an der Volume-Erweiterung.

Volume-Erweiterungen in StatefulSets verwalten

Wenn Sie die Größe der Volumes erhöhen müssen, die von Pods in einem StatefulSet in Kubernetes verwendet werden, sollten Sie das Feld spec.resources.requests.storage der den Pods zugeordneten PersistentVolumeClaims (PVCs) anpassen. Der Versuch, das Feld volumeClaimTemplates direkt im StatefulSet-Objekt zu ändern, führt zu einem Fehler.

Wenn Sie außerdem die Anzahl der Replikate des StatefulSets erhöhen, werden weiterhin PVCs der ursprünglichen Größe erstellt. Wenn Sie die Größe der Volumes, die für die vom StatefulSet verwalteten Pods bereitgestellt werden, dauerhaft ändern möchten, müssen Sie das StatefulSet-Objekt löschen und mit der aktualisierten Größe, die im Feld volumeClaimTemplates angegeben ist, neu erstellen. Beachten Sie, dass durch diesen Vorgang die alten Pods und die entsprechenden PVCs gelöscht werden. Je nach ReclaimPolicy wird möglicherweise auch der zugrunde liegende Speicher gelöscht.

Mit den folgenden Schritten können Sie die ursprünglichen Pods weiterhin ausführen und gleichzeitig das StatefulSet anpassen, um zukünftige Replikate mit der neuen Volume-Größe bereitzustellen.

  1. Speichern Sie das vorhandene StatefulSet in einer Datei:

    kubectl get StatefulSet statefulset-name -o yaml > sts-backup.yaml

  2. Entfernen Sie das StatefulSet-Objekt aus dem Cluster, während die Pods weiterhin als eigenständige Pods ausgeführt werden:

    kubectl delete sts statefulset-name --cascade=orphan

  3. Bearbeiten Sie die neue Volume-Speichergröße in der lokal gespeicherten Datei sts-backup.yaml, insbesondere den Wert von spec.volumeClaimTemplates.spec.resources.requests.storage.

  4. Erstellen Sie das StatefulSet wieder im Cluster:

    kubectl apply -f sts-backup.yaml

Nächste Schritte