Стадия жизненного цикла модуля: Deprecated

У модуля есть требования для установки

Deckhouse Kubernetes Platform устанавливает CRD, но не удаляет их при отключении модуля. Если вам больше не нужны созданные CRD, удалите их.

VolumeSnapshotClass

Short names: vsclass, vsclasses

Scope: Cluster

VolumeSnapshotClass определяет параметры для создания снимков томов, используемые нижележащей системой хранения.

Для использования укажите имя VolumeSnapshotClass в объекте VolumeSnapshot.

  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • deletionPolicy
    строка

    Управляет поведением при удалении VolumeSnapshotContent и его физического снимка при удалении связанного VolumeSnapshot.

    Поддерживаемые значения:

    • Retain — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения сохраняются.
    • Delete — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения удаляются.

    Допустимые значения: Delete, Retain

  • driver
    строка
    Имя драйвера хранения, который обрабатывает этот VolumeSnapshotClass.
  • kind
    строка

    Тип REST-ресурса, который представляет объект.

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

    Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • metadata
    объект
  • parameters
    объект

    Карта ключ-значение с параметрами, специфичными для драйвера хранения, используемыми при создании снимков.

    Kubernetes не интерпретирует эти параметры.

VolumeSnapshotClass определяет параметры для создания снимков томов, используемые нижележащей системой хранения.

Для использования укажите имя VolumeSnapshotClass в объекте VolumeSnapshot.

  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • deletionPolicy
    строка

    Управляет поведением при удалении VolumeSnapshotContent и его физического снимка при удалении связанного VolumeSnapshot. Поддерживаемые значения:

    • Retain — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения сохраняются.
    • Delete — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения удаляются.

    Допустимые значения: Delete, Retain

  • driver
    строка
    Имя драйвера хранения, который обрабатывает этот VolumeSnapshotClass.
  • kind
    строка

    Тип REST-ресурса, который представляет объект.

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

    Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • parameters
    объект

    Карта ключ-значение с параметрами, специфичными для драйвера хранения, используемыми при создании снимков.

    Kubernetes не интерпретирует эти параметры.

VolumeSnapshotContent

Short names: vsc, vscs

Scope: Cluster

VolumeSnapshotContent представляет фактический объект снимка «на диске» в нижележащей системе хранения.
  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • kind
    строка

    Тип REST-ресурса, который представляет объект.

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

    Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • metadata
    объект
  • spec
    объект
    Свойства VolumeSnapshotContent, созданного нижележащей системой хранения.
    • spec.deletionPolicy
      строка

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

      Управляет поведением при удалении VolumeSnapshotContent и его физического снимка при удалении связанного VolumeSnapshot.

      Поддерживаемые значения:

      • Retain — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения сохраняются.
      • Delete — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения удаляются.

      Для динамически созданных снимков автоматически заполняется CSI snapshotter sidecar значением поля DeletionPolicy, определенным в соответствующем VolumeSnapshotClass. Для существующих снимков необходимо указать при создании объекта VolumeSnapshotContent.

      Допустимые значения: Delete, Retain

    • spec.driver
      строка

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

      Имя CSI-драйвера, используемого для создания физического снимка в нижележащей системе хранения.

      Должно совпадать с именем, возвращаемым вызовом CSI GetPluginName() для этого драйвера.

    • spec.source
      объект

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

      Указывает, является ли снимок (или должен быть) динамически созданным или уже существует и требует только представления в виде объекта Kubernetes.

      Неизменяемо после создания.

      • spec.source.snapshotHandle
        строка

        CSI snapshot_id существующего снимка в нижележащей системе хранения, для которого было (или должно быть) создано представление в виде объекта Kubernetes.

        Неизменяемо после создания.

      • spec.source.volumeHandle
        строка

        CSI volume_id тома, из которого должен быть динамически создан снимок.

        Неизменяемо после создания.

    • spec.sourceVolumeMode
      строка

      Режим тома, снимок которого создается. Может быть Filesystem или Block.

      Если не указано, режим исходного тома неизвестен.

      Неизменяемо после создания.

    • spec.volumeSnapshotClassName
      строка

      Имя VolumeSnapshotClass, из которого был (или будет) создан этот снимок.

      После создания снимка VolumeSnapshotClass может быть удален или пересоздан с другими значениями и не должен использоваться.

    • spec.volumeSnapshotRef
      объект

      Объект VolumeSnapshot (далее — референт), к которому привязан этот VolumeSnapshotContent.

      Поле VolumeSnapshot.Spec.VolumeSnapshotContentName должно ссылаться на имя этого VolumeSnapshotContent для валидности двунаправленной привязки.

      Для существующего объекта VolumeSnapshotContent необходимо указать имя и неймспейс объекта VolumeSnapshot для привязки. Неизменяемо после создания.

  • status
    объект
    Текущая информация о снимке.
    • status.creationTime
      целочисленный

      Временная метка создания точечного снимка нижележащей системой хранения.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением creation_time, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением creation_time, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

      Если не указано, то время создания неизвестно.

      Формат — время в наносекундах Unix, закодированное как int64. В Unix команда date +%s%N возвращает текущее время в наносекундах с 1970-01-01 00:00:00 UTC.

    • status.error
      объект

      Последняя наблюдаемая ошибка при создании снимка, если есть.

      После успешного повтора поле очищается.

      • status.error.message
        строка

        Детали возникшей ошибки при создании снимка, если указаны.

        Примечание: сообщение может быть залогировано и не должно содержать конфиденциальную информацию.

      • status.error.time
        строка
        Временная метка, когда была обнаружена ошибка.
    • status.readyToUse
      булевый

      Указывает, готов ли снимок для восстановления тома.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением ready_to_use, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением ready_to_use, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это, иначе устанавливается в True.

      Если не указано, готовность снимка неизвестна.

    • status.restoreSize
      целочисленный

      Полный размер снимка в байтах.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением size_bytes, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением size_bytes, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это. При восстановлении тома из этого снимка размер тома не должен быть меньше restoreSize, если он указан, иначе восстановление завершится ошибкой.

      Если не указано, размер неизвестен.

      Допустимые значения: 0 <= X

    • status.snapshotHandle
      строка

      CSI snapshot_id снимка в нижележащей системе хранения.

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

    • status.volumeGroupSnapshotHandle
      строка
      CSI group_snapshot_id группового снимка в нижележащей системе хранения.
VolumeSnapshotContent представляет фактический объект снимка «на диске» в нижележащей системе хранения.
  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • kind
    строка

    Тип REST-ресурса, который представляет объект.

    Серверы могут определять это значение из конечной точки, на которую клиент отправляет запросы. Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • spec
    объект
    Свойства VolumeSnapshotContent, созданного нижележащей системой хранения.
    • spec.deletionPolicy
      строка

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

      Управляет поведением при удалении VolumeSnapshotContent и его физического снимка при удалении связанного VolumeSnapshot.

      Поддерживаемые значения:

      • Retain — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения сохраняются.
      • Delete — VolumeSnapshotContent и его физический снимок в нижележащей системе хранения удаляются.

      Для динамически созданных снимков автоматически заполняется CSI snapshotter sidecar значением поля DeletionPolicy, определенным в соответствующем VolumeSnapshotClass.

      Для существующих снимков необходимо указать при создании объекта VolumeSnapshotContent.

      Допустимые значения: Delete, Retain

    • spec.driver
      строка

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

      Имя CSI-драйвера, используемого для создания физического снимка в нижележащей системе хранения.

      Должно совпадать с именем, возвращаемым вызовом CSI GetPluginName() для этого драйвера.

    • spec.source
      объект

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

      Указывает, является ли снимок (или должен быть) динамически созданным или уже существует и требует только представления в виде объекта Kubernetes.

      Неизменяемо после создания.

      • spec.source.snapshotHandle
        строка

        CSI snapshot_id существующего снимка в нижележащей системе хранения, для которого было (или должно быть) создано представление в виде объекта Kubernetes.

        Неизменяемо после создания.

      • spec.source.volumeHandle
        строка

        CSI volume_id тома, из которого должен быть динамически создан снимок.

        Неизменяемо после создания.

    • spec.volumeSnapshotClassName
      строка

      Имя VolumeSnapshotClass, из которого был (или будет) создан этот снимок.

      После создания снимка VolumeSnapshotClass может быть удален или пересоздан с другими значениями и не должен использоваться.

    • spec.volumeSnapshotRef
      объект

      Объект VolumeSnapshot (далее — референт), к которому привязан этот VolumeSnapshotContent.

      Поле VolumeSnapshot.Spec.VolumeSnapshotContentName должно ссылаться на имя этого VolumeSnapshotContent для валидности двунаправленной привязки.

      Для существующего объекта VolumeSnapshotContent необходимо указать имя и неймспейс объекта VolumeSnapshot для привязки.

      Неизменяемо после создания.

  • status
    объект
    Текущая информация о снимке.
    • status.creationTime
      целочисленный

      Временная метка создания точечного снимка нижележащей системой хранения.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением creation_time, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением creation_time, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

      Если не указано, время создания неизвестно. Формат — время в наносекундах Unix, закодированное как int64. В Unix команда date +%s%N возвращает текущее время в наносекундах с 1970-01-01 00:00:00 UTC.

    • status.error
      объект

      Последняя наблюдаемая ошибка при создании снимка, если есть.

      После успешного повтора поле очищается.

      • status.error.message
        строка

        Детали возникшей ошибки при создании снимка, если указаны.

        Примечание: сообщение может быть залогировано и не должно содержать конфиденциальную информацию.

      • status.error.time
        строка
        Временная метка, когда была обнаружена ошибка.
    • status.readyToUse
      булевый

      Указывает, готов ли снимок для восстановления тома.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением ready_to_use, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением ready_to_use, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это, иначе устанавливается в True.

      Если не указано, готовность снимка неизвестна.

    • status.restoreSize
      целочисленный

      Полный размер снимка в байтах.

      При динамическом создании снимка заполняется CSI snapshotter sidecar значением size_bytes, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением size_bytes, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

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

      Если не указано, размер неизвестен.

      Допустимые значения: 0 <= X

    • status.snapshotHandle
      строка

      CSI snapshot_id снимка в нижележащей системе хранения.

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

VolumeSnapshot

Short names: vs

Scope: Namespaced

VolumeSnapshot — это запрос пользователя на создание точечного снимка постоянного тома или на привязку к существующему снимку.
  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • kind
    строка

    Тип REST-ресурса, который представляет объект.

    Серверы могут определять это значение из конечной точки, на которую клиент отправляет запросы. Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • metadata
    объект
  • spec
    объект

    Свойства снимка, запрошенного пользователем.

    Подробнее: https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots

    • spec.mode
      строка
      mode selects how this VolumeSnapshot obtains its content and is immutable once set. Capture (default): dynamic CSI snapshot from spec.source. Import: the data artifact is produced by a DataImport in the same namespace (reverse-lookup by DataImport.spec.snapshotRef); spec.source is omitted (required only when mode != Import) and the upstream snapshot-controller does not reconcile such a VolumeSnapshot - the state-snapshotter common controller binds it (sets status). Deckhouse extension: parity with spec.mode on every other state-snapshotter snapshot kind.

      По умолчанию: Capture

      Допустимые значения: Capture, Import

    • spec.source
      объект

      Указывает источник создания снимка.

      Может быть пустым для намерения восстановления (backup controller проставляет volumeSnapshotContentName после restore). Иначе должен быть указан ровно один из persistentVolumeClaimName, volumeSnapshotContentName или import.

      Неизменяемо после создания (кроме одноразовой установки volumeSnapshotContentName из пустого).

      • spec.source.persistentVolumeClaimName
        строка

        Имя объекта PersistentVolumeClaim, представляющего том, из которого должен быть создан снимок.

        PVC должен находиться в том же неймспейсе, что и объект VolumeSnapshot.

        Указывается, если снимок не существует и его необходимо создать.

        Неизменяемо после создания.

      • spec.source.volumeSnapshotContentName
        строка

        Имя существующего объекта VolumeSnapshotContent, представляющего существующий снимок тома.

        Указывается, если снимок уже существует и требуется только его представление в Kubernetes.

        Для намерения восстановления backup controller может один раз установить это поле из пустого после успешного restore.

    • spec.volumeSnapshotClassName
      строка

      Имя VolumeSnapshotClass, запрошенного VolumeSnapshot.

      Может быть пустым для использования класса снимков по умолчанию. В кластере может быть несколько классов снимков по умолчанию: один для каждого CSI-драйвера. Если класс снимков не указан, проверяется VolumeSnapshotSource для определения связанного CSI-драйвера, и используется класс снимков по умолчанию для этого CSI-драйвера.

      Если для одного CSI-драйвера существует несколько VolumeSnapshotClass, помеченных как используемые по умолчанию, CreateSnapshot завершается ошибкой и создает событие.

      Не допускается пустая строка.

  • status
    объект

    Текущая информация о снимке.

    Перед использованием необходимо проверить успешность привязки между объектами VolumeSnapshot и VolumeSnapshotContent, убедившись, что оба объекта указывают друг на друга.

    • status.boundSnapshotContentName
      строка

      Имя кластерного объекта SnapshotContent (state-snapshotter.deckhouse.io) state-snapshotter, который обеспечивает этот VolumeSnapshot как логический узел в дереве снимка.

      Записывается общим контроллером state-snapshotter в дополнение к boundVolumeSnapshotContentName. Расширение Deckhouse.

    • status.boundVolumeSnapshotContentName
      строка

      Имя объекта VolumeSnapshotContent, к которому привязан этот объект VolumeSnapshot.

      Если не указано, объект VolumeSnapshot еще не привязан к объекту VolumeSnapshotContent.

      Примечание: для предотвращения проблем с безопасностью перед использованием необходимо проверить успешность привязки между объектами VolumeSnapshot и VolumeSnapshotContent, убедившись, что оба объекта указывают друг на друга.

    • status.captureState
      объект
      captureState collects the state-snapshotter capture signals mirrored onto this VolumeSnapshot when it is a domain snapshot node: commonController holds the core-written capture-leg latches, and domainSpecificController holds the domain-written planning refs and lifecycle. Written by the state-snapshotter controllers. Deckhouse extension.
      • status.captureState.commonController
        объект
        commonController holds the core-written capture-leg success latches. Single writer: state-snapshotter core.
        • status.captureState.commonController.dataCaptured
          булевый
          dataCaptured is the data-leg success latch, declared only where a data line exists.
        • status.captureState.commonController.manifestCaptured
          булевый
          manifestCaptured is the manifest-leg success latch (declared on every capture node).
        • status.captureState.commonController.subtreeManifestsPersisted
          булевый
          subtreeManifestsPersisted is a core-written mirror of the bound SnapshotContent’s recursive “this node and all descendants archived their manifests” latch. Monotonic (false -> true).
        • status.captureState.commonController.subtreePlanned
          булевый
          subtreePlanned is a core-computed monotonic recursive latch: true once this node reached capture barrier 1 (domainSpecificController.phase >= Planned) and every direct child’s own subtreePlanned is true (the whole subtree finished planning). Domains only read it. Monotonic (false -> true).
      • status.captureState.domainSpecificController
        объект
        domainSpecificController holds the domain-written planning refs and lifecycle. Single writer: domain (SDK).
        • status.captureState.domainSpecificController.excludedRefs
          массив объектов
          excludedRefs are the domain’s direct exclusion vetoes at this node (the source objects it dropped via the exclude label while enumerating its children).
          • status.captureState.domainSpecificController.excludedRefs.apiVersion
            строка
          • status.captureState.domainSpecificController.excludedRefs.kind
            строка
          • status.captureState.domainSpecificController.excludedRefs.name
            строка
        • status.captureState.domainSpecificController.manifestCaptureRequestName
          строка
          manifestCaptureRequestName is the temporary MCR owned by the domain node while own-scope capture runs.
        • status.captureState.domainSpecificController.message
          строка
          message is a human-readable detail for phase=Failed.
        • status.captureState.domainSpecificController.phase
          строка
          phase is the domain lifecycle barrier (Planning|Planned|Finished|Failed).

          Допустимые значения: Planning, Planned, Finished, Failed

        • status.captureState.domainSpecificController.reason
          строка
          reason is a short, machine-readable reason for phase=Failed (free-form domain string).
        • status.captureState.domainSpecificController.volumeCaptureRequestName
          строка
          volumeCaptureRequestName is the temporary VCR owned by a data-leaf domain node while the data leg runs.
    • status.childrenSnapshotRefs
      массив объектов
      childrenSnapshotRefs are the direct child snapshot edges when this VolumeSnapshot participates in a snapshot tree. A VolumeSnapshot is a data leaf, so this is normally empty; kept for uniformity across snapshot kinds. Deckhouse extension.
      • status.childrenSnapshotRefs.apiVersion
        строка
      • status.childrenSnapshotRefs.kind
        строка
      • status.childrenSnapshotRefs.name
        строка
    • status.conditions
      массив объектов
      conditions report the state-snapshotter protocol readiness (conditions[Ready] is the single user-facing condition derived by the core), distinct from the CSI readyToUse binding signal. Written by the state-snapshotter core. Deckhouse extension.
      • status.conditions.lastTransitionTime
        строка
        lastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the API field changed is acceptable.
      • status.conditions.message
        строка
        message is a human readable message indicating details about the transition. This may be an empty string.

        Максимальная длина: 32768

      • status.conditions.observedGeneration
        целочисленный
        observedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date with respect to the current state of the instance.

        Допустимые значения: 0 <= X

      • status.conditions.reason
        строка
        reason contains a programmatic identifier indicating the reason for the condition’s last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed API. The value should be a CamelCase string. This field may not be empty.

        Длина: 1..1024

        Шаблон: ^[A-Za-z]([A-Za-z0-9_,:]*[A-Za-z0-9_])?$

      • status.conditions.status
        строка
        status of the condition, one of True, False, Unknown.

        Допустимые значения: True, False, Unknown

      • status.conditions.type
        строка
        type of condition in CamelCase or in foo.example.com/CamelCase.

        Максимальная длина: 316

        Шаблон: ^([a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*/)?(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])$

    • status.creationTime
      строка

      Временная метка создания точечного снимка нижележащей системой хранения.

      При динамическом создании снимка заполняется контроллером снимков значением creation_time, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением creation_time, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

      Если не указано, время создания снимка неизвестно.

    • status.data
      объект
      Самодостаточная привязка данных (sourceRef + artifactRef + метаданные тома), зеркалируемая из привязанного SnapshotContent.status.data state-snapshotter, чтобы d8 определял дескриптор захваченного тома из этого namespaced VolumeSnapshot. Записывается общим контроллером state-snapshotter. Расширение Deckhouse.
      • status.data.artifactRef
        объект

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

        Durable-артефакт данных (VolumeSnapshotContent).
        • status.data.artifactRef.apiVersion
          строка

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

        • status.data.artifactRef.kind
          строка

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

        • status.data.artifactRef.name
          строка

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

        • status.data.artifactRef.uid
          строка
      • status.data.fsType
        строка
        Тип файловой системы источника (только для томов Filesystem).
      • status.data.size
        строка
        Реальный выделенный размер захваченного тома (например, “10Gi”).
      • status.data.sourceRef
        объект

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

        Захваченный источник PersistentVolumeClaim (uid — идентичность тома).
        • status.data.sourceRef.apiVersion
          строка

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

        • status.data.sourceRef.kind
          строка

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

        • status.data.sourceRef.name
          строка

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

        • status.data.sourceRef.namespace
          строка
        • status.data.sourceRef.uid
          строка
      • status.data.storageClassName
        строка
        StorageClass исходного захваченного тома.
      • status.data.volumeMode
        строка
        Режим тома источника (Block или Filesystem).

        Допустимые значения: Block, Filesystem

    • status.error
      объект

      Последняя наблюдаемая ошибка при создании снимка, если есть.

      Полезно контроллерам верхнего уровня (например, контроллеру приложения) для решения о продолжении ожидания создания снимка по типу ошибки. Контроллер снимков продолжает повторные попытки при возникновении ошибки во время создания снимка.

      После успешного создания поле очищается.

      • status.error.message
        строка

        Детали возникшей ошибки при создании снимка, если указаны.

        Примечание: сообщение может быть залогировано и не должно содержать конфиденциальную информацию.

      • status.error.time
        строка
        Временная метка, когда была обнаружена ошибка.
    • status.readyToUse
      булевый

      Указывает, готов ли снимок для восстановления тома.

      При динамическом создании снимка заполняется контроллером снимков значением ready_to_use, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением ready_to_use, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это, иначе устанавливается в True.

      Если не указано, готовность снимка неизвестна.

    • status.restoreSize
      строка

      Минимальный размер тома, необходимый для создания тома из этого снимка.

      При динамическом создании снимка заполняется контроллером снимков значением size_bytes, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением size_bytes, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

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

      Если не указано, размер неизвестен.

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

    • status.sourceRef
      объект
      sourceRef is the full reference to the captured live source object (the source PVC), written by the state-snapshotter domain controller (PublishSnapshotSource). Self-contained for import-mode recreation. Deckhouse extension.
      • status.sourceRef.apiVersion
        строка

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

      • status.sourceRef.kind
        строка

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

      • status.sourceRef.name
        строка

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

      • status.sourceRef.namespace
        строка
        Namespace of the source object (namespaced sources only).
      • status.sourceRef.uid
        строка
        UID of the captured live source object (best-effort; used by d8-cli for import-mode recreation).
    • status.volumeGroupSnapshotName
      строка
      Имя VolumeGroupSnapshot, частью которого является этот VolumeSnapshot.
VolumeSnapshot — это запрос пользователя на создание точечного снимка постоянного тома или на привязку к существующему снимку.
  • apiVersion
    строка

    Версия API представления объекта.

    Серверы преобразуют распознанные схемы в последнее внутреннее значение и могут отклонять нераспознанные значения.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

  • kind
    строка

    Тип REST-ресурса, который представляет объект.

    Серверы могут определять это значение из конечной точки, на которую клиент отправляет запросы. Нельзя обновить после создания. Значение должно быть в формате CamelCase.

    Подробнее: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

  • spec
    объект

    Свойства снимка, запрошенного пользователем.

    Подробнее: https://kubernetes.io/docs/concepts/storage/volume-snapshots#volumesnapshots

    • spec.source
      объект

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

      Указывает источник создания снимка.

      Может быть пустым для намерения восстановления (backup controller проставляет volumeSnapshotContentName после restore). Иначе должен быть указан ровно один из persistentVolumeClaimName, volumeSnapshotContentName или import.

      Неизменяемо после создания (кроме одноразовой установки volumeSnapshotContentName из пустого).

      • spec.source.persistentVolumeClaimName
        строка

        Имя объекта PersistentVolumeClaim, представляющего том, из которого должен быть создан снимок.

        PVC должен находиться в том же неймспейсе, что и объект VolumeSnapshot.

        Указывается, если снимок не существует и его необходимо создать.

        Неизменяемо после создания.

      • spec.source.volumeSnapshotContentName
        строка

        Имя существующего объекта VolumeSnapshotContent, представляющего существующий снимок тома.

        Указывается, если снимок уже существует и требуется только его представление в Kubernetes.

        Для намерения восстановления backup controller может один раз установить это поле из пустого после успешного restore.

    • spec.volumeSnapshotClassName
      строка

      Имя VolumeSnapshotClass, запрошенного VolumeSnapshot.

      Может быть пустым для использования класса снимков по умолчанию.

      В кластере может быть несколько классов снимков по умолчанию: один для каждого CSI-драйвера. Если класс снимков не указан, проверяется VolumeSnapshotSource для определения связанного CSI-драйвера, и используется класс снимков по умолчанию для этого CSI-драйвера.

      Если для одного CSI-драйвера существует несколько VolumeSnapshotClass, помеченных как используемые по умолчанию, CreateSnapshot завершается ошибкой и создает событие.

      Не допускается пустая строка.

  • status
    объект

    Текущая информация о снимке.

    Перед использованием необходимо проверить успешность привязки между объектами VolumeSnapshot и VolumeSnapshotContent, убедившись, что оба объекта указывают друг на друга.

    • status.boundVolumeSnapshotContentName
      строка

      Имя объекта VolumeSnapshotContent, к которому привязан этот объект VolumeSnapshot.

      Если не указано, объект VolumeSnapshot еще не привязан к объекту VolumeSnapshotContent.

      Примечание: для предотвращения проблем с безопасностью перед использованием необходимо проверить успешность привязки между объектами VolumeSnapshot и VolumeSnapshotContent, убедившись, что оба объекта указывают друг на друга.

    • status.creationTime
      строка

      Временная метка создания точечного снимка нижележащей системой хранения.

      При динамическом создании снимка заполняется контроллером снимков значением creation_time, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением creation_time, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

      Если не указано, время создания снимка неизвестно.

    • status.error
      объект

      Последняя наблюдаемая ошибка при создании снимка, если есть.

      Полезно контроллерам верхнего уровня (например, контроллеру приложения) для решения о продолжении ожидания создания снимка по типу ошибки. Контроллер снимков продолжает повторные попытки при возникновении ошибки во время создания снимка.

      После успешного создания поле очищается.

      • status.error.message
        строка

        Детали возникшей ошибки при создании снимка, если указаны.

        Примечание: сообщение может быть залогировано и не должно содержать конфиденциальную информацию.

      • status.error.time
        строка
        Временная метка, когда была обнаружена ошибка.
    • status.readyToUse
      булевый

      Указывает, готов ли снимок для восстановления тома.

      При динамическом создании снимка заполняется контроллером снимков значением ready_to_use, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением ready_to_use, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это, иначе устанавливается в True.

      Если не указано, готовность снимка неизвестна.

    • status.restoreSize
      строка

      Минимальный размер тома, необходимый для создания тома из этого снимка.

      При динамическом создании снимка заполняется контроллером снимков значением size_bytes, возвращаемым из вызова gRPC CreateSnapshot CSI.

      Для существующего снимка заполняется значением size_bytes, возвращаемым из вызова gRPC ListSnapshots CSI, если драйвер поддерживает это.

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

      Если не указано, размер неизвестен.

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

    • status.volumeGroupSnapshotName
      строка
      Имя VolumeGroupSnapshot, частью которого является этот VolumeSnapshot.