访问永久性存储空间

借助 Google Distributed Cloud (GDC) 网闸隔离配置中的永久性存储，您可以独立于 Pod 生命周期保留容器数据。您可以使用 PersistentVolumeClaim (PVC) 资源声明卷并扩容，以便在重启和重新调度期间保留状态。

本文档适用于应用运维人员群组中为组织创建工作负载的开发者。如需了解详情，请参阅 GDC 网闸隔离配置文档的受众群体。

准备工作

如需完成本文档中的任务，您必须请求必要的权限并准备环境。

申请 IAM 角色

您必须拥有特定角色，才能获得访问永久性存储所需的权限。您所需的角色取决于您是在组织级共享集群还是项目级标准集群中工作。如需了解详情，请参阅 Kubernetes 集群配置。

共享集群角色

如需在共享集群中创建、删除、修改或查看永久性卷，请让您的 IAM 项目管理员为您授予命名空间管理员 (namespace-admin) 角色。此角色会绑定到您的项目命名空间。

标准集群角色

如需在标准集群中创建、删除、修改或查看永久性卷，请让您的 IAM 项目管理员为您授予 Cluster Developer (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

后续步骤