Статическая подготовка тома

Важная информация

При работе мастера с версией Kubernetes 1.14 и группами узлов с версией Kubernetes 1.13 существуют проблемы совместимости, которые влияют на работу CSI. Для корректной работы необходимо обновить группы узлов до версии Kubernetes 1.14.

Создайте под со статически подготовленным томом:

  1. Создайте объект PersistentVolume.
  2. Создайте объект PersistentVolumeClaim.
  3. Создайте под.

Перед началом

Узнайте уникальный идентификатор диска, который будет использован для создания объекта PersistentVolume или создайте новый диск:

  1. Если у вас еще нет диска, создайте его.

  2. Посмотрите уникальный идентификатор диска:

    $ yc compute disk list
    +----------------------+------+--------------+---------------+--------+----------------------+-------------+
    |          ID          | NAME |     SIZE     |     ZONE      | STATUS |     INSTANCE IDS     | DESCRIPTION |
    +----------------------+------+--------------+---------------+--------+----------------------+-------------+
    | ef3ouo4sgl86740ridn6 | k8s  |   4294967296 | ru-central1-c | READY  |                      |             |
    | ef3qh55ckuu7md2kqhbt |      | 103079215104 | ru-central1-c | READY  | ef3sin41eksav1kn4gct |             |
    | epd9vda1h0knttpcuhfu |      |  10737418240 | ru-central1-b | READY  | epdegdecs9o14r13gbad |             |
    +----------------------+------+--------------+---------------+--------+----------------------+-------------+
    

Создайте объект PersistentVolume

  1. Сохраните спецификацию для создания объекта PersistentVolume в YAML-файл с названием test-pv.yaml.

    Подробнее о спецификации читайте в документации Kubernetes.

    При указании параметра capacity: storage убедитесь, что задан точный объем диска. CSI не обеспечивает проверку объема диска для статически подготовленных томов.

    Для создания объекта PersistentVolume на основе существующего облачного диска в параметре volumeHandle укажите уникальный идентификатор необходимого диска.

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: test-pv
    spec:
      capacity:
        storage: 4Gi 
      accessModes:
        - ReadWriteOnce 
      csi:
        driver: io.ycloud.mks.disk-csi-driver 
        fsType: ext4
        volumeHandle: ef3ouo4sgl86740ridn6
    
  2. Выполните команду:

    $ kubectl create -f test-pv.yaml
    persistentvolume/test-pv created
    
  3. Посмотрите информацию о созданном объекте PersistentVolume:

    $ kubectl describe persistentvolume test-pv
    Name:            test-pv
    Labels:          <none>
    Annotations:     <none>
    Finalizers:      [kubernetes.io/pv-protection]
    StorageClass:    yc-network-hdd
    Status:          Available
    ...
    

Создайте объект PersistentVolumeClaim

  1. Сохраните спецификацию для создания объекта PersistentVolumeClaim YAML-файл с названием test-claim.yaml.

    Подробнее о спецификации читайте в документации Kubernetes.

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: test-claim
    spec:
      accessModes:
        - ReadWriteOnce
      resources:
        requests:
          storage: 4Gi
      volumeName: test-pv
    
    1. Выполните команду:

      $ kubectl create -f test-claim.yaml
      persistentvolumeclaim/test-claim created
      
    2. Посмотрите информацию о созданном PersistentVolumeClaim:

      $ kubectl describe persistentvolumeclaim test-claim
      Name:          test-claim
      Namespace:     default
      StorageClass:  yc-network-hdd
      Status:        Bound
      Volume:        test-pv
      ...
      

Создайте под со статически подготовленным томом

  1. Сохраните следующий пример в YAML-файл с названием test-pod.yaml.

    apiVersion: v1
    kind: Pod
    metadata:
      name: test-pod
    spec:
      containers:
      - name: app
        image: ubuntu
        command: ["/bin/sh"]
        args: ["-c", "while true; do echo $(date -u) >> /data/out.txt; sleep 5; done"]
        volumeMounts:
        - name: persistent-storage
          mountPath: /data
      volumes:
      - name: persistent-storage
        persistentVolumeClaim:
          claimName:  test-claim
    

    Подробнее о спецификации читайте в документации Kubernetes.

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

    $ kubectl create -f test-pod.yaml
    pod/test-pod created
    
  3. Посмотрите информацию о созданном поде:

    $ kubectl describe pod test-pod
    Name:         test-pod
    Namespace:    default
    Priority:     0
    Node:         cl1gqrct5oier258n08t-ypap/10.0.0.9
    Start Time:   Tue, 23 Jul 2019 18:34:57 +0300
    Labels:       <none>
    Annotations:  <none>
    Status:       Pending
    ...
    Events:
      Type    Reason     Age   From               Message
      ----    ------     ----  ----               -------
      Normal  Scheduled  3s    default-scheduler  Successfully assigned default/test-pod to cl1gqrct5oier258n08t-ypap
    

После этого рядом с используемым диском в консоли управления в Compute Cloud в разделе Диски появится надпись Подключен.