ClusterVirtualImage

Scope: Cluster
Version: v1alpha2

Описывает образ диска виртуальной машины, который может использоваться в качестве источника данных для новых VirtualDisks или установочный образ (iso), который быть смонтирован в VirtualMachines напрямую. Этот тип ресурса доступен для всех пространств имен в кластере.

Этот ресурс не может быть изменен после его создания.

Под капотом этого ресурса создается образ контейнера, который хранится в специальном container registry (DVCR).

  • 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.containerImage.imagePullSecret.namespace
            строка

            Пространство имен, в котором находится imagePullSecret.

      • 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 или VirtualDisk.

        • spec.dataSource.objectRef.kind
          строка

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

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

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

        • spec.dataSource.objectRef.name
          строка

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

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

        • spec.dataSource.objectRef.namespace
          строка

          Имя namespace’а, гда ресположен VirtualImage или VirtualDisk.

      • spec.dataSource.type
        строка

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

        Доступные типы источников для создания образа:

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

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