PersistentVolumeClaim

apiVersion: v1

import "k8s.io/api/core/v1"

PersistentVolumeClaim

PersistentVolumeClaim — это запрос пользователя и претензия на постоянный том

• apiVersion: v1

• kind: PersistentVolumeClaim

• metadata (ObjectMeta)

  Стандартные метаданные объекта. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec (PersistentVolumeClaimSpec)

  spec определяет желаемые характеристики тома, запрошенного автором под. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

• status (PersistentVolumeClaimStatus)

  status представляет текущую информацию/состояние запроса на постоянный том. Только для чтения. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims

PersistentVolumeClaimSpec

PersistentVolumeClaimSpec описывает общие атрибуты устройств хранения и позволяет указывать Источник для атрибутов, специфичных для поставщика.

• accessModes ([]string)

  accessModes содержит желаемые режимы доступа, которые должен иметь том. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

• selector (LabelSelector)

  selector — запрос меток по томам для рассмотрения при связывании.

• resources (ResourceRequirements)

  resources представляет собой минимальные ресурсы, которые должен иметь том. Если включена функция RecoverVolumeExpansionFailure, пользователям разрешается указывать потребности в ресурсах, которые меньше предыдущего значения, но должны быть больше, чем емкость, записанная в поле состояния запроса. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

  ResourceRequirements описывает потребности в вычислительных ресурсах.

  • resources.limits (map[string]Quantity)

    Limits описывает максимальное количество вычислительных ресурсов, разрешенных. Дополнительная информация: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

  • resources.requests (map[string]Quantity)

    Requests описывает минимальное количество требуемых вычислительных ресурсов. Если Requests не указан для контейнера, он по умолчанию равен Limits, если это явно указано, в противном случае — определенное реализацией значение. Дополнительная информация: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/

• volumeName (string)

  volumeName — ссылка на привязку к PersistentVolume, поддерживающему этот запрос.

• storageClassName (string)

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

• volumeMode (string)

  volumeMode определяет тип тома, требуемого запросом. Значение Filesystem подразумевается, если оно не включено в спецификацию запроса.

Уровень бета-версии

• dataSource (TypedLocalObjectReference)

  поле dataSource может использоваться для указания: * существующего объекта VolumeSnapshot (snapshot.storage.k8s.io/VolumeSnapshot) * существующего PVC (PersistentVolumeClaim) Если провайдер или внешний контроллер могут поддерживать указанный источник данных, он создаст новый том на основе содержимого указанного источника данных. Если шлюз AnyVolumeDataSource включен, это поле всегда будет содержать то же самое содержимое, что и поле DataSourceRef.

• dataSourceRef (TypedLocalObjectReference)

  dataSourceRef указывает объект, из которого необходимо заполнить том данными, если требуется непустой том. Это может быть любой локальный объект из непустой группы API (объект, не из ядра) или объект PersistentVolumeClaim. Когда это поле указано, привязка тома будет успешной только в том случае, если тип указанного объекта соответствует какому-либо установленному популятору томов или динамическому провайдеру. Это поле заменяет функциональность поля DataSource, и, следовательно, если оба поля непустые, они должны иметь одинаковое значение. Для обеспечения обратной совместимости оба поля (DataSource и DataSourceRef) будут автоматически установлены в одно и то же значение, если одно из них пустое, а другое — нет. Существуют два важных отличия между DataSource и DataSourceRef: * Хотя DataSource допускает только два определенных типа объектов, DataSourceRef допускает любые объекты, не являющиеся из ядра, а также объекты PersistentVolumeClaim.

  • Хотя DataSource игнорирует запрещенные значения (удаляя их), DataSourceRef сохраняет все значения и генерирует ошибку, если указано запрещенное значение. (Бета-версия) Для использования этого поля необходимо включить шлюз AnyVolumeDataSource.

PersistentVolumeClaimStatus

PersistentVolumeClaimStatus — текущее состояние запроса на постоянный том.

• accessModes ([]string)

  accessModes содержит фактические режимы доступа к тому, поддерживающему PVC. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes-1

• allocatedResources (map[string]Quantity)

  allocatedResources — это хранилищный ресурс внутри AllocatedResources отслеживает емкость, выделенную для PVC. Она может быть больше фактической емкости, когда запрашивается операция расширения тома. Для квоты хранения используется большее значение из allocatedResources и PVC.spec.resources. Если allocatedResources не задано, только PVC.spec.resources используется для расчета квоты. Если запрос емкости расширения тома снижается, allocatedResources снижается только в том случае, если нет операций расширения в процессе и если фактическая емкость тома равна или меньше запрошенной емкости. Это поле alpha и требует включения функции RecoverVolumeExpansionFailure.

• capacity (map[string]Quantity)

  capacity представляет собой фактические ресурсы базового тома.

• conditions ([]PersistentVolumeClaimCondition)

  Стратегия патчинга: слияние по ключу type

  conditions — текущее состояние запроса на постоянный том. Если базовый постоянный том меняет размер, состояние будет установлено в 'ResizeStarted'.

  PersistentVolumeClaimCondition содержит подробности о состоянии pvc

  • conditions.status (string), необходимо

  • conditions.type (string), необходимо

  • conditions.lastProbeTime (Time)

    lastProbeTime — время, когда мы проверили состояние.

    Time — обёртка вокруг time.Time, поддерживающая правильную сериализацию в YAML и JSON. Обёртки предоставляются для многих методов-заводов пакета time.

  • conditions.lastTransitionTime (Time)

    lastTransitionTime — время, когда состояние перешло из одного статуса в другой.

    Time — обёртка вокруг time.Time, поддерживающая правильную сериализацию в YAML и JSON. Обёртки предоставляются для многих методов-заводов пакета time.

  • conditions.message (string)

    message — удобочитаемое сообщение, указывающее подробности о последнем переходе.

  • conditions.reason (string)

    reason — уникальная, должна быть короткой, машиночитаемой строкой, которая объясняет причину последнего перехода состояния. Если она сообщает "ResizeStarted", это означает, что базовый постоянный том изменяет размер.

• phase (string)

  phase представляет собой текущую фазу PersistentVolumeClaim.

• resizeStatus (string)

  resizeStatus хранит состояние операции изменения размера. ResizeStatus по умолчанию не задан, но когда расширение завершено, resizeStatus устанавливается в пустую строку контроллером изменения размера или kubelet. Это поле alpha и требует включения функции RecoverVolumeExpansionFailure.

PersistentVolumeClaimList

PersistentVolumeClaimList — это список элементов PersistentVolumeClaim.

• apiVersion: v1

• kind: PersistentVolumeClaimList

• metadata (ListMeta)

  Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

• items ([]PersistentVolumeClaim), необходимо

  items — это список запросов на постоянные тома. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistentvolumeclaims