Custom resource VirtualDisk

VirtualDisk

Scope: Namespaced
Version: v1alpha2

Ресурс VirtualDisk описывает желаемую конфигурацию диска виртуальной машины. VirtualDisk может быть смонтирован в виртуальной машине статически, указав его в списке дисков .spec.blockDeviceRefs, или смонтирован «на лету» с помощью ресурса VirtualMachineBlockDeviceAttachments.

После создания VirtualDisk можно изменить только размер диска .spec.persistentVolumeClaim.size, все остальные поля неизменяемы.

• apiVersion

  строка

  APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

• kind

  строка

  Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

• metadata

  объект
• spec

  объект

  Обязательный параметр

  • spec.dataSource

    объект
    • spec.dataSource.containerImage

      объект

      Для использования образа, хранящегося во внешнем реестре контейнеров, необходимо убедиться, что используется реестр, работающий по протоколу TLS. При необходимости предоставьте поле caBundle для передачи цепочки сертификатов.

      • spec.dataSource.containerImage.caBundle

        строка

        Цепочка сертификатов в формате Base64 для проверки подключения к container registry.

        Пример:

        caBundle: YWFhCg==
        

      • spec.dataSource.containerImage.image

        строка

        Обязательный параметр

        Путь к образу в container registry.

        Шаблон: ^(?P<name>(?:(?P<domain>(?:(?:localhost|[\w-]+(?:\.[\w-]+)+)(?::\d+)?)|[\w]+:\d+)/)?(?P<image>[a-z0-9_.-]+(?:/[a-z0-9_.-]+)*))(?::(?P<tag>[\w][\w.-]{0,127}))?(?:@(?P<digest>[A-Za-z][A-Za-z0-9]*(?:[+.-_][A-Za-z][A-Za-z0-9]*)*:[0-9a-fA-F]{32,}))?$

        Пример:

        image: registry.example.com/images/slackware:15
        

      • spec.dataSource.containerImage.imagePullSecret

        объект
        • spec.dataSource.containerImage.imagePullSecret.name

          строка

          Имя Secret’а, содержащего учетные данные для подключения к container registry.

    • spec.dataSource.http

      объект

      Создать диск из файла, опубликованного по URL. Поддерживаемые схемы:

      • HTTP;
      • HTTPS.

      Для схемы HTTPS есть возможность пропустить проверку TLS.

      • spec.dataSource.http.caBundle

        строка

        Цепочка сертификатов в формате Base64 для проверки TLS-сертификата сервера, на котором размещается образ.

        Пример:

        caBundle: YWFhCg==
        

      • spec.dataSource.http.checksum

        объект

        Контрольная сумма файла для проверки правильности загрузки или отсутствия изменений. Файл должен соответствовать всем указанным контрольным суммам.

        • spec.dataSource.http.checksum.md5

          строка

          Шаблон: ^[0-9a-fA-F]{32}$

          Длина: 32..32

          Пример:

          md5: f3b59bed9f91e32fac1210184fcff6f5
          

        • spec.dataSource.http.checksum.sha256

          строка

          Шаблон: ^[0-9a-fA-F]{64}$

          Длина: 64..64

          Пример:

          sha256: 78be890d71dde316c412da2ce8332ba47b9ce7a29d573801d2777e01aa20b9b5
          

      • spec.dataSource.http.url

        строка

        Обязательный параметр

        URL с образом. Поддерживаются следующие типы образов:

        • qcow2;
        • vmdk;
        • vdi;
        • iso;
        • raw.

        Для всех представленных типов образов поддерживается сжатие образов в следующих форматах:

        • gz;
        • xz.

        Шаблон: ^http[s]?:\/\/(?:[a-zA-Z]|[0-9]|[$-_@.&+]|[!*\(\),]|(?:%[0-9a-fA-F][0-9a-fA-F]))+$

        Пример:

        url: https://mirror.example.com/images/slackware-15.qcow.gz
        

    • spec.dataSource.objectRef

      объект

      Для создания образа использовать существующий VirtualImage, ClusterVirtualImage или VirtualDiskSnapshot.

      • spec.dataSource.objectRef.kind

        строка

        Обязательный параметр

        Ссылка на существующий VirtualImage, ClusterVirtualImage или VirtualDiskSnapshot.

        Допустимые значения: ClusterVirtualImage, VirtualImage, VirtualDiskSnapshot

      • spec.dataSource.objectRef.name

        строка

        Обязательный параметр

        Имя существующего VirtualImage, ClusterVirtualImage или VirtualDiskSnapshot.

    • spec.dataSource.type

      строка

      Тип источника, из которого будет создан диск:

      • HTTP — создать диск из файла, опубликованного на HTTP/HTTPS-сервере.
      • ContainerImage — создать диск из образа в container registry.
      • ObjectRef — создать диск из существующего ресурса.
      • Upload — загрузить образ диска вручную.

      Допустимые значения: HTTP, ContainerImage, ObjectRef, Upload

  • spec.persistentVolumeClaim

    объект

    Настройки для создания PVC для хранения диска.

    • spec.persistentVolumeClaim.size

      строка или число

      Желаемый размер PVC для хранения диска. Если диск создается из образа, то размер должен быть не меньше, чем исходный образ в распакованном состоянии.

      Данный параметр можно опустить, если задан блок .spec.dataSource, в этом случае контроллер определит размер диска автоматически, на основе размера распакованного образа из источника указанного в .spec.dataSource.

      Шаблон: ^(\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))(([KMGTPE]i)|[numkMGTPE]|([eE](\+|-)?(([0-9]+(\.[0-9]*)?)|(\.[0-9]+))))?$

    • spec.persistentVolumeClaim.storageClassName

      строка

      Имя StorageClass, требуемого для PersistentVolumeClaim. Дополнительная информация — https://kubernetes.io/docs/concepts/storage/persistent-volumes#class-1.

      При создании дисков пользователь может указать требуемый StorageClass для создания диска, либо не указывать явно и в этом случае будет использован StorageClass доступный по умолчанию.

      Особенности диска и поведение виртуальной машины зависят от выбранного StorageClass.

      Параметр VolumeBindingMode в StorageClass влияет на процесс создания дисков:

      • Immediate - Диск будет создан и доступен для использования сразу после создания.
      • WaitForFirstConsumer - Диск создается только при его использовании в виртуальной машине. При этом диск будет создан на узле, где будет запущена виртуальная машина.

      StorageClass может поддерживать различные настройки хранения:

      • Создание блочного устройства (Block) или файловой системы (FileSystem).
      • Множественный доступ (ReadWriteMany) или единичный доступ (ReadWriteOnce). ReadWriteMany-диски поддерживают множественный доступ, что позволяет выполнять живую миграцию виртуальных машин. В отличие от них, ReadWriteOnce-диски, ограниченные доступом только с одного узла, не могут обеспечить такую возможность.

      Для известных типов хранилищ платформа самостоятельно определит наиболее эффективные настройки при создании дисков (в порядке убывания приоритетов):

      1. Block + ReadWriteMany
      2. FileSystem + ReadWriteMany
      3. Block + ReadWriteOnce
      4. FileSystem + ReadWriteOnce