存取永久儲存空間

Google Distributed Cloud (GDC) 實體隔離方案設備的永久儲存空間，可讓您保留容器資料，不受 Pod 生命週期影響。您可以使用 PersistentVolumeClaim (PVC) 資源宣告磁碟區，並擴充容量，以便在重新啟動和重新排程時保留狀態。

本文適用於應用程式操作員群組中，為組織建立工作負載的開發人員。

事前準備

如要完成本文件中的工作，您必須要求必要權限並準備環境。

要求 IAM 角色

如要在 Kubernetes 叢集中建立、刪除、編輯或查看永久磁碟區，請要求組織 IAM 管理員授予您命名空間管理員 (namespace-admin) 角色。這個角色會繫結至專案命名空間。

準備環境

如要對預先設定的裸機 Kubernetes 叢集執行指令，請確認您具備下列資源：

  1. 找出 Kubernetes 叢集名稱，或向平台管理員詢問叢集名稱。

  2. 如果沒有 Kubernetes 叢集的 kubeconfig 檔案，請登入並產生該檔案。

  3. 請使用 Kubernetes 叢集的 kubeconfig 路徑，取代這些操作說明中的 CLUSTER_KUBECONFIG。

建立永久磁碟區

下列操作說明說明如何使用 GDC standard-rwo StorageClass 建立磁碟區。如要進一步瞭解 GDC 中可用的 StorageClass 資源，請參閱「容器的永久儲存空間」。

  1. 建立 PersistentVolumeClaim，並使用 ReadWriteOnce 存取模式和 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

    更改下列內容：

    • CLUSTER_KUBECONFIG：Kubernetes 叢集的 kubeconfig 檔案。

    • NAMESPACE：要在其中建立 PVC 的專案命名空間。

    • PVC_NAME：PersistentVolumeClaim 物件的名稱。

  2. PersistentVolume (PV) 物件會動態佈建。檢查 Kubernetes 叢集中新 PV 的狀態：

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG

    輸出結果會與下列內容相似：

    NAME       CAPACITY   ACCESS MODES   STATUS      CLAIM     STORAGECLASS   AGE
pvc-uuidd  10Gi       RWO            Bound       pvc-name  standard-rwo   60s

  3. 設定容器工作負載，以便使用 PVC。以下是使用 standard-rwo PVC 的 nginx Pod 範例：

    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

    將 PVC_NAME 替換為您建立的 PVC。

擴充磁碟區容量

如要增加 PersistentVolumeClaim 物件的容量，請將 spec.resources.storage 欄位更新為新容量。支援的磁碟區大小上限為 14.5 Ti。

  1. 在 PersistentVolumeClaim 物件的資訊清單檔案中，將磁碟區更新為較大容量：

    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

    更改下列內容：

    • CLUSTER_KUBECONFIG：Kubernetes 叢集的 kubeconfig 檔案。

    • NAMESPACE：PVC 資源所在的專案命名空間。

    • PVC_NAME：要增加儲存空間大小的 PVC 名稱。

    • VOLUME_SNAPSHOT_SIZE：要增加的儲存空間大小，例如 50Gi。

  2. 檢查叢集中更新後的 PV 狀態：

    kubectl get pv --kubeconfig CLUSTER_KUBECONFIG

後續步驟