存取永久儲存空間

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

本文適用於應用程式操作員群組中，為組織建立工作負載的開發人員。詳情請參閱「GDC 實體隔離方案的目標對象」說明文件。

事前準備

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

要求 IAM 角色

您必須具備特定角色，才能取得存取永久儲存空間所需的權限。所需角色取決於您是在組織範圍的共用叢集，還是專案範圍的標準叢集內作業。詳情請參閱「Kubernetes 叢集設定」。

共用叢集角色

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

標準叢集角色

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

準備環境

如要使用 API 對 Kubernetes 叢集執行指令，請確認您具備下列資源：

  • 找出 Kubernetes 叢集名稱，或向平台管理員群組成員詢問叢集名稱。

  • 登入並產生 Kubernetes 叢集的 kubeconfig 檔案。

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

建立永久磁碟區

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

  1. 建立 PersistentVolumeClaim 資源 (PVC)，並設定 ReadWriteOnce 存取模式和 standard-rwo 儲存空間級別：

    kubectl --kubeconfig KUBERNETES_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

    更改下列內容：

    • KUBERNETES_CLUSTER_KUBECONFIG：叢集的 kubeconfig 檔案。

    • NAMESPACE：要在其中建立 PVC 的命名空間。如果是共用叢集，則必須是專案命名空間。如果是標準叢集，則可使用任何命名空間。

    • PVC_NAME：PersistentVolumeClaim 物件的名稱。

  2. 確認 PVC 物件可用：

    kubectl get pvc --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE

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

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

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

    kubectl --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG \
    --namespace NAMESPACE apply -f - <<EOF
apiVersion: 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 KUBERNETES_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

    更改下列內容：

    • KUBERNETES_CLUSTER_KUBECONFIG：叢集的 kubeconfig 檔案。

    • NAMESPACE：PVC 資源所在的命名空間。如果是共用叢集，則必須是專案命名空間。如果是標準叢集，則可以是任何命名空間。

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

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

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

    kubectl get pv --kubeconfig KUBERNETES_CLUSTER_KUBECONFIG

後續步驟