Edit This Page

—approvers:

• msau42
• jsafrane title: Persistent Volume Claim 保护 cn-approvers:

• lichuqiang

FEATURE STATE: Kubernetes v1.9 alpha

从 Kubernetes 1.9 版本起，用户可以对正在被 pod 使用的 persistent volume claim（PVC）进行保护， 防止其在使用结束前被移除。

• lichuqiang
• Before you begin
• PVC 保护验证
  • 场景 1：PVC 没有在被 pod 使用
  • 场景 2：PVC 在被 pod 使用

Before you begin

• 必须安装 1.9 或更高版本的 Kubernetes。
• 由于 PVC 保护是 Kubernetes 1.9 版本的 alpha 特性，必须（按下面的方式）启用它：
  1. 准入控制器 启动时须启用 PVC 保护插件。
  2. 所有的 Kubernetes 组件在启动时都须启用 PVCProtection alpha 特性。

PVC 保护验证

下面的示例使用了 GCE PD StorageClass，然而，您可以按照类似的步骤对任何 volume 类型执行操作：

为方便存储供应（provisioning），创建一个 StorageClass：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: slow
provisioner: kubernetes.io/gce-pd
parameters:
  type: pd-standard

存在两种场景： 用户所删除的 PVC 正在被 pod 使用，或没有在被 pod 使用。

场景 1：PVC 没有在被 pod 使用

• 创建一个 PVC：

kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: slzc
spec:
  accessModes:
    - ReadWriteOnce
  storageClassName: slow
  resources:
    requests:
      storage: 3.7Gi

• 检查 PVC，确认其设置了 kubernetes.io/pvc-protection 终结器（finalizer）：

  $ kubectl describe pvc slzc
  Name:          slzc
  Namespace:     default
  StorageClass:  slow
  Status:        Bound
  Volume:        pvc-bee8c30a-d6a3-11e7-9af0-42010a800002
  Labels:        <none>
  Annotations:   pv.kubernetes.io/bind-completed=yes
               pv.kubernetes.io/bound-by-controller=yes
               volume.beta.kubernetes.io/storage-provisioner=kubernetes.io/gce-pd
  Finalizers:    [kubernetes.io/pvc-protection]
  Capacity:      4Gi
  Access Modes:  RWO
  Events:
  Type    Reason                 Age   From                         Message
  ----    ------                 ----  ----                         -------
  Normal  ProvisioningSucceeded  2m    persistentvolume-controller  Successfully provisioned volume pvc-bee8c30a-d6a3-11e7-9af0-42010a800002 using kubernetes.io/gce-pd
  

• 删除 PVC，并确认 PVC（没有在被 pod 使用）被成功移除。

场景 2：PVC 在被 pod 使用

• 再次创建同样的 PVC.
• 创建一个使用该 PVC 的 pod：

kind: Pod
apiVersion: v1
metadata:
  name: app1
spec:
  containers:
  - name: test-pod
    image: k8s.gcr.io/busybox:1.24
    command:
      - "/bin/sh"
    args:
      - "-c"
      - "date > /mnt/app1.txt; sleep 60 && exit 0 || exit 1"
    volumeMounts:
      - name: path-pvc
        mountPath: "/mnt"
  restartPolicy: "Never"
  volumes:
    - name: path-pvc
      persistentVolumeClaim:
        claimName: slzc

• 等待 pod 状态变为 Running，也就是 PVC 变成被使用的状态。
• 删除当前正在被 pod 使用的 PVC，并验证该 PVC 没有被移除，但其状态变为 Terminating：

Name:          slzc
Namespace:     default
StorageClass:  slow
Status:        Terminating (since Fri, 01 Dec 2017 14:47:55 +0000)
Volume:        pvc-803a1f4d-d6a6-11e7-9af0-42010a800002
Labels:        <none>
Annotations:   pv.kubernetes.io/bind-completed=yes
               pv.kubernetes.io/bound-by-controller=yes
               volume.beta.kubernetes.io/storage-provisioner=kubernetes.io/gce-pd
Finalizers:    [kubernetes.io/pvc-protection]
Capacity:      4Gi
Access Modes:  RWO
Events:
  Type    Reason                 Age   From                         Message
  ----    ------                 ----  ----                         -------
  Normal  ProvisioningSucceeded  52s   persistentvolume-controller  Successfully provisioned volume pvc-803a1f4d-d6a6-11e7-9af0-42010a800002 using kubernetes.io/gce-pd

• 等待 pod 状态变为 Terminated（删除 pod 或者等到它结束），然后检查，确认 PVC 被移除。