Работа с PersistentVolume

Механизм Persistent Volume Claim (PVC) позволяет динамически выделять и подключать к вашим подам блочные диски с необходимыми характеристиками.

Для того, чтобы динамически создать PV на базе PVC, вам потребуется указать корректный класс хранения (storage class). Чтобы получить полный список классов хранения и типов дисков, доступных для вашего кластера, необходимо выполнить команду:

1
kubectl get storageclasses

Пример результата выполнения команды:

1
NAME                      PROVISIONER              RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
2
mts-ssd-basic             csi.vsphere.vmware.com   Delete          Immediate           false                  6d5h
3
mts-ssd-fast (default)    csi.vsphere.vmware.com   Delete          Immediate           false                  6d5h
4
mts-ssd-ultra             csi.vsphere.vmware.com   Delete          Immediate           false                  6d5h
5
mts-ssd-ultra-plus        csi.vsphere.vmware.com   Delete          Immediate           false                  6d5h

Отметка default означает, что если не указать параметр storageClassName, то будет использован класс хранилищ по умолчанию: mts-ssd-fast.

• Reservation - минимально гарантированная производительность канала в операциях ввода-вывода (IOPS). Она выделяется машине безусловно (резервируется для данной машины).

• Limit - верхний предел в IOPS, которые машина может потреблять.

• Shares - относительная доля диска по отношению к остальным виртуальным дискам в хранилище. Более высокое значение IOPS Shares позволяет диску поддерживать большее количество одновременных операций ввода-вывода в условиях конкуренции за ресурсы.

Стоимость 1Gb для каждой дисковой политики равна цене аналогичной дисковой политики для диска worker-нод.

Сохраните следующую спецификацию для создания объекта PersistentVolumeClaim в YAML-файл с названием test-pvc.yaml. Подробнее о спецификации для создания объекта PersistentVolumeClaim можно узнать в документации Kubernetes.

При подготовке спецификации задайте необходимый объем дискового пространства.

1
kind: PersistentVolumeClaim
2
apiVersion: v1
3
metadata:
4
  name: test-pvc
5
  annotations:
6
    volume.beta.kubernetes.io/storage-class: mts-ssd-fast
7
spec:
8
  accessModes:
9
    - ReadWriteOnce
10
  resources:
11
    requests:
12
      storage: 1Gi

Выполните команду:

1
kubectl create -f test-pvc.yaml

Результат выполнения команды:

1
persistentvolumeclaim/test-pvc created

Сохраните следующую спецификацию для создания пода в YAML-файл с названием pod.yaml. Подробнее о спецификации для создания пода можно узнать в документации Kubernetes.

1
apiVersion: v1
2
kind: Pod
3
metadata:
4
  name: pod
5
spec:
6
  containers:
7
  - name: app
8
    image: ubuntu
9
    command: ["/bin/sh"]
10
    args: ["-c", "while true; do echo $(date -u) >> /data/out.txt; sleep 5; done"]
11
    volumeMounts:
12
    - name: persistent-storage
13
      mountPath: /data
14
  volumes:
15
  - name: persistent-storage
16
    persistentVolumeClaim:
17
      claimName:  test-pvc

• mountPath — это точка монтирования PersistentVolume в файловую систему контейнера.

Все данные, которые приложение в контейнере будет писать в директорию /data будут сохранятся на PersistentVolume.

Выполните команду:

1
kubectl create -f pod.yaml

Результат выполнения команды:

1
pod/pod created

Выполните команду:

1
kubectl describe pods pod

Результат выполнения команды:

1
Name:         pod
2
Namespace:    default
3
Priority:     0
4
Node:         beloved-walrus-b3f5dc-b15729/10.100.0.137
5
Start Time:   Mon, 26 Apr 2021 17:26:22 +0300
6
Labels:       <none>
7
Annotations:  cni.projectcalico.org/podIP: 192.168.199.16/32
8
Status:       Running
9
...
10
Volumes:
11
  persistent-storage:
12
    Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
13
    ClaimName:  test-pvc
14
    ReadOnly:   false
15
  default-token-nzmgl:
16
    Type:        Secret (a volume populated by a Secret)
17
    SecretName:  default-token-nzmgl
18
    Optional:    false
19
QoS Class:       BestEffort
20
Node-Selectors:  <none>
21
Tolerations:     node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
22
                 node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
23
Events:
24
  Type    Reason                  Age    From                     Message
25
  ----    ------                  ----   ----                     -------
26
  Normal  Scheduled               4m12s  default-scheduler        Successfully assigned default/pod to beloved-walrus-b3f5dc-b15729
27
  Normal  SuccessfulAttachVolume  4m11s  attachdetach-controller  AttachVolume.Attach succeeded for volume "pvc-59b4a96b-efdf-4b38-834d-99dbcc1a7475"
28
  Normal  Pulling                 4m9s   kubelet                  Pulling image "ubuntu"
29
  Normal  Pulled                  3m59s  kubelet                  Successfully pulled image "ubuntu" in 9.528515094s
30
  Normal  Created                 3m59s  kubelet                  Created container app
31
  Normal  Started                 3m59s  kubelet                  Started container app

После создания пода:

• На странице Список кластеров нажмите на имя кластера Kubernetes, для которого создавался PersistentVolume.

  • На вкладке Выделенные тома вы увидите все созданные PersitentVolumes, их имена и размеры.

Рассмотрим пример, в рамках которого:

1. Запускается контейнер, в котором создается файл /var/log/test.txt, и
2. Выполняется команда echo "test pv" >> /var/log/test.txt, записывающая строку “test pv” в файл test.txt.

Таким образом, при каждом перезапуске пода файл будет пополняться дополнительной записью.

Требуемые действия:

1. Сохраните следующую спецификацию для создания пода в YAML-файл с названием task-pv-pod.yaml:

   1
   apiVersion: apps/v1
   2
   kind: Deployment
   3
   metadata:
   4
     name: task-pv-pod
   5
   spec:
   6
     replicas: 1
   7
     strategy:
   8
       type: Recreate
   9
     selector:
   10
       matchLabels:
   11
         app: test
   12
     template:
   13
       metadata:
   14
         labels:
   15
           app: test
   16
       spec:
   17
         containers:
   18
         - name: task-pv-container
   19
           command: ["/bin/sh","-c"]
   20
           args:
   21
             - touch /var/log/test.txt;
   22
               cat /var/log/test.txt;
   23
               echo "test pv" >> /var/log/test.txt;
   24
               sleep 36000;
   25
           image: alpine
   26
           volumeMounts:
   27
           - mountPath: "/var/log/"
   28
             name: test-pvc
   29
         volumes:
   30
         - name: test-pvc
   31
           persistentVolumeClaim:
   32
             claimName: test-pvc

2. Выполните команду:

   1
   kubectl apply -f task-pv-pod.yaml

   Результат выполнения команды:

   1
   deployment.apps/task-pv-pod created

3. Убедитесь, что под с примонтированным PersistentVolume успешно создан. Выполните команду:

   1
   kubectl get pods

   Результат выполнения команды:

   1
   NAME                            READY   STATUS    RESTARTS   AGE
   2
   task-pv-pod-65595866c6-m998s    1/1     Running   0          23s

4. Выведите в консоль содержимое файла test.txt. Выполните команду:

   1
   kubectl exec -it task-pv-pod-65595866c6-m998s -- cat /var/log/test.txt

   Результат выполнения команды:

   1
   test pv

5. Проверьте сохранность данных при удалении пода. Для этого пересоздайте под и проверьте результат:

   • Выполните команду:

     1
     kubectl delete pod task-pv-pod-65595866c6-m998s

     Результат выполнения команды:

     1
     pod "task-pv-pod-65595866c6-m998s" deleted

   • Далее повторите действия из предыдущего шага:

     1
     kubectl get pods
     2
     
     3
     NAME READY STATUS RESTARTS AGE
     4
     task-pv-pod-65595866c6-mgvxr 1/1 Running 0 73s
     5
     
     6
     kubectl exec -it task-pv-pod-65595866c6-mgvxr -- cat /var/log/test.txt
     7
     
     8
     test pv
     9
     test pv