Auf nichtflüchtigen Speicher zugreifen

Mit nichtflüchtigem Speicher in der GDC-Appliance (Google Distributed Cloud) mit Air Gap können Sie Containerdaten unabhängig von Pod-Lebenszyklen aufbewahren. Sie können Volumes mit PersistentVolumeClaim-Ressourcen (PVC) beanspruchen und die Kapazität erweitern, um den Status über Neustarts und Neuplanung hinweg beizubehalten.

Dieses Dokument richtet sich an Entwickler in der Gruppe der Anwendungsoperatoren, die Arbeitslasten für ihre Organisation erstellen.

Hinweis

Zum Ausführen der Aufgaben in diesem Dokument müssen Sie die erforderlichen Berechtigungen anfordern und Ihre Umgebung vorbereiten.

IAM-Rollen anfordern

Bitten Sie den IAM-Administrator Ihrer Organisation, Ihnen die Rolle Namespace-Administrator (namespace-admin) zuzuweisen, um nichtflüchtige Volumes in einem Kubernetes-Cluster zu erstellen, zu löschen, zu bearbeiten oder anzusehen. Diese Rolle ist an Ihren Projekt-Namespace gebunden.

Umgebung vorbereiten

Wenn Sie Befehle für den vorkonfigurierten Bare-Metal-Kubernetes-Cluster ausführen möchten, benötigen Sie die folgenden Ressourcen:

  1. Suchen Sie den Namen des Kubernetes-Clusters oder fragen Sie Ihren Plattformadministrator nach dem Clusternamen.

  2. Melden Sie sich an und generieren Sie die kubeconfig-Datei für den Kubernetes-Cluster, falls Sie noch keine haben.

  3. Ersetzen Sie CLUSTER_KUBECONFIG in dieser Anleitung durch den kubeconfig-Pfad des Kubernetes-Clusters.

Nichtflüchtiges Volume erstellen

In der folgenden Anleitung wird gezeigt, wie Sie ein Volume mit der GDC-standard-rwo StorageClass erstellen. Weitere Informationen zu den verfügbaren StorageClass-Ressourcen in GDC finden Sie unter Nichtflüchtiger Speicher für Container.

  1. Erstellen Sie ein PersistentVolumeClaim-Objekt und konfigurieren Sie es mit dem Zugriffsmodus ReadWriteOnce und der Speicherklasse standard-rwo:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: PVC_NAME
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: 10Gi
      storageClassName: standard-rwo
    EOF
    

    Ersetzen Sie Folgendes:

    • CLUSTER_KUBECONFIG: die kubeconfig-Datei für den Kubernetes-Cluster.

    • NAMESPACE: der Projekt-Namespace, in dem der PVC erstellt werden soll.

    • PVC_NAME: der Name des PersistentVolumeClaim-Objekts.

  2. Die PersistentVolume-Objekte (PV) werden dynamisch bereitgestellt. Prüfen Sie den Status der neuen PVs in Ihrem Kubernetes-Cluster:

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG
    

    Die Ausgabe sieht etwa so aus:

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
    pvc-uuidd  10Gi       RWO            Bound       pvc-name  standard-rwo   60s
    
  3. Konfigurieren Sie Ihre Containerarbeitslasten für die Verwendung des PVC. Hier sehen Sie ein Beispiel für einen nginx-Pod, der einen standard-rwo-PVC verwendet:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: apps/v1
    kind: Pod
    metadata:
      name: web-server-deployment
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        volumeMounts:
        - mountPath: /usr/share/nginx/html
          name: data
      volumes:
      - name: data
        persistentVolumeClaim:
          claimName: PVC_NAME
    EOF
    

    Ersetzen Sie PVC_NAME durch den von Ihnen erstellten PVC.

Volume-Kapazität erweitern

Wenn Sie die Kapazität eines PersistentVolumeClaim-Objekts erhöhen möchten, aktualisieren Sie das Feld spec.resources.storage auf die neue Kapazität. Die maximal unterstützte Volume-Größe beträgt 14,5 Ti.

  1. Aktualisieren Sie das Volume in der Manifestdatei des PersistentVolumeClaim-Objekts auf eine größere Größe:

    kubectl --kubeconfig CLUSTER_KUBECONFIG \
        --namespace NAMESPACE apply -f - <<EOF
    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: PVC_NAME
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: VOLUME_STORAGE_SIZE
    EOF
    

    Ersetzen Sie Folgendes:

    • CLUSTER_KUBECONFIG: die kubeconfig-Datei für den Kubernetes-Cluster.

    • NAMESPACE: der Projekt-Namespace, in dem sich die PVC-Ressource befindet.

    • PVC_NAME: der Name des PVC, für den Sie die Speichergröße erhöhen.

    • VOLUME_SNAPSHOT_SIZE: die Speichergröße, um die der Speicher erhöht werden soll, z. B. 50Gi.

  2. Prüfen Sie den Status der aktualisierten PVs in Ihrem Cluster:

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG
    

Nächste Schritte