PersistentVolume

PersistentVolume (PV) — это ресурс хранения, предоставляемый администратором.

apiVersion: v1

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

PersistentVolume

PersistentVolume (PV) — это ресурс хранения, предоставляемый администратором. Он аналогичен узлу. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes

apiVersion: v1
kind: PersistentVolume
metadata (ObjectMeta)

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

spec определяет спецификацию постоянного тома, принадлежащего кластеру. Предоставлен администратором. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#persistent-volumes
status (PersistentVolumeStatus)

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

PersistentVolumeSpec

PersistentVolumeSpec — это спецификация постоянного тома.

accessModes ([]string)

Атомарно: будет заменено при слиянии

accessModes содержит все способы монтирования тома. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#access-modes
capacity (map[string]Quantity)

capacity описывает ресурсы и емкость постоянного тома. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity
claimRef (ObjectReference)

claimRef является частью двунаправленной привязки между PersistentVolume и PersistentVolumeClaim. Ожидается, что он не равен null при привязке. claim.VolumeName — это авторитетная привязка между PV и PVC. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#binding
mountOptions ([]string)

Атомарно: будет заменено при слиянии

mountOptions — список опций монтирования, например, ["ro", "soft"]. Не валидируется — монтирование просто завершится с ошибкой, если опция неверна. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options
nodeAffinity (VolumeNodeAffinity)

nodeAffinity определяет ограничения, которые ограничивают, с каких узлов можно получить доступ к этому тому. Это поле влияет на планирование pod, которые используют этот том.

VolumeNodeAffinity определяет ограничения, которые ограничивают, с каких узлов можно получить доступ к этому тому.
- nodeAffinity.required (NodeSelector)
  
  required определяет жесткие ограничения узла, которые должны быть выполнены.
  
  Селектор узла представляет собой объединение результатов одного или нескольких запросов меток на наборе узлов; то есть, он представляет собой ИЛИ селекторов, представленных терминами селектора узла.
  - nodeAffinity.required.nodeSelectorTerms ([]NodeSelectorTerm), required
    
    Атомарно: будет заменено при слиянии
    
    Обязательно. Список терминов селектора узла. Термы попарно ИЛИ.
    
    Нулевой или пустой термин селектора узла не соответствует никаким объектам. Требования к ним — И. Тип TopologySelectorTerm реализует подмножество NodeSelectorTerm.
    - nodeAffinity.required.nodeSelectorTerms.matchExpressions ([]NodeSelectorRequirement)
      
      Атомарно: будет заменено при слиянии
      
      Список требований селектора узла по меткам узла.
    - nodeAffinity.required.nodeSelectorTerms.matchFields ([]NodeSelectorRequirement)
      
      Атомарно: будет заменено при слиянии
      
      Список требований селектора узла по полям узла.
persistentVolumeReclaimPolicy (string)

persistentVolumeReclaimPolicy определяет, что происходит с постоянным томом при высвобождении его претензией. Допустимые значения: Retain (по умолчанию для вручную созданных PersistentVolumes), Delete (по умолчанию для динамически предоставленных PersistentVolumes) и Recycle (устарело). Recycle должен поддерживаться плагином тома, лежащим в основе этого PersistentVolume. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#reclaiming
storageClassName (string)

storageClassName — имя StorageClass, к которому принадлежит этот постоянный том. Пустое значение означает, что этот том не принадлежит ни одному StorageClass.
volumeAttributesClassName (string)

Имя VolumeAttributesClass, к которому принадлежит этот постоянный том. Пустое значение запрещено. Если это поле не установлено, это указывает, что этот том не принадлежит ни одному VolumeAttributesClass. Это поле изменяемо и может быть изменено драйвером CSI после успешного обновления тома до нового класса. Для не привязанного PersistentVolume volumeAttributesClassName будет сопоставлен с не привязанными PersistentVolumeClaims во время процесса привязки. Это поле — бета-функция и требует включения функции VolumeAttributesClass (отключена по умолчанию).
volumeMode (string)

volumeMode определяет, предназначен ли том для использования с отформатированной файловой системой или для сохранения в сыром блочном состоянии. Значение Filesystem подразумевается, если оно не указано в spec.

Local

hostPath (HostPathVolumeSource)

hostPath представляет собой каталог на хосте. Предоставлен разработчиком или тестировщиком. Это полезно только для разработки и тестирования на одном узле! Хранение на хосте никоим образом не поддерживается и НЕ БУДЕТ работать в многоузловом кластере. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

Представляет собой путь на хосте, отображенный в pod. Тома с путями на хосте не поддерживают управление правами доступа или перемаркировку SELinux.
- hostPath.path (string), required
  
  путь к каталогу на хосте. Если путь является символьной ссылкой, она будет перенаправлена на настоящий путь. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
- hostPath.type (string)
  
  тип для HostPath Volume По умолчанию "" Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
local (LocalVolumeSource)

local представляет непосредственно подключенное хранилище с привязкой к узлу

Local представляет непосредственно подключенное хранилище с привязкой к узлу (функция Beta)
- local.path (string), required
  
  путь к полному пути к тому на узле. Это может быть либо каталог, либо блочное устройство (диск, раздел, ...).
- local.fsType (string)
  
  fsType — тип файловой системы для монтирования. Применяется только в том случае, если путь является блочным устройством. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Например, "ext4", "xfs", "ntfs". Значение по умолчанию — автоматический выбор файловой системы, если она не указана.

Persistent volumes

awsElasticBlockStore (AWSElasticBlockStoreVolumeSource)

awsElasticBlockStore представляет собой ресурс диска AWS, который подключается к хост-машине kubelet, а затем экспонируется для pod. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

*Представляет собой ресурс постоянного диска в AWS.

Диск AWS EBS должен существовать перед подключением к контейнеру. Диск также должен находиться в той же зоне AWS, что и kubelet. Диск AWS EBS может быть смонтирован только в режиме чтения/записи один раз. Объемы AWS EBS поддерживают управление правами владения и перемаркирование SELinux.*
- awsElasticBlockStore.volumeID (string), required
  
  volumeID — уникальный идентификатор ресурса постоянного диска в AWS (объём Amazon EBS). Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
- awsElasticBlockStore.fsType (string)
  
  fsType — тип файловой системы тома, который вы хотите смонтировать. Совет: убедитесь, что тип файловой системы поддерживается операционной системой хоста. Примеры: "ext4", "xfs", "ntfs". Если не указано, неявно предполагается "ext4". Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
- awsElasticBlockStore.partition (int32)
  
  partition — раздел в томе, который вы хотите смонтировать. Если опущено, по умолчанию выполняется монтирование по имени тома. Примеры: для тома /dev/sda1 укажите раздел как "1". Аналогично, раздел тома для /dev/sda — "0" (или вы можете оставить свойство пустым).
- awsElasticBlockStore.readOnly (boolean)
  
  Значение readOnly, равное true, принудительно установит значение readOnly в VolumeMounts. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
azureDisk (AzureDiskVolumeSource)

azureDisk представляет собой монтирование диска Azure Data на хост и привязку к pod.

azureDisk представляет собой монтирование диска Azure Data на хост и привязку к pod.
- azureDisk.diskName (string), required
  
  diskName — имя диска данных в хранилище blob
- azureDisk.diskURI (string), required
  
  diskURI — URI диска данных в хранилище blob
- azureDisk.cachingMode (string)
  
  cachingMode — режим кэширования хоста: None, Read Only, Read Write.
- azureDisk.fsType (string)
  
  fsType — тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Например, "ext4", "xfs", "ntfs". Если не указано, неявно предполагается "ext4".
- azureDisk.kind (string)
  
  Возможные значения kind: Shared: несколько дисков blob на один хранилище учетной записи Dedicated: один диск blob на одну хранилище учетной записи Managed: управляемый диск данных Azure (только в управляемом наборе доступности). По умолчанию используется shared
- azureDisk.readOnly (boolean)
  
  readOnly По умолчанию false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts.
azureFile (AzureFilePersistentVolumeSource)

azureFile представляет собой монтирование Azure File Service на хост и привязку к pod.

azureFile представляет собой монтирование Azure File Service на хост и привязку к pod.
- azureFile.secretName (string), required
  
  secretName — имя секрета, содержащего имя и ключ учетной записи Azure Storage
- azureFile.shareName (string), required
  
  shareName — имя общего доступа Azure
- azureFile.readOnly (boolean)
  
  readOnly по умолчанию false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts.
- azureFile.secretNamespace (string)
  
  secretNamespace — имя пространства имен секрета, содержащего имя и ключ учетной записи Azure Storage. По умолчанию совпадает с пространством имен pod
cephfs (CephFSPersistentVolumeSource)

cephFS представляет собой монтирование Ceph FS на хост, которое разделяет жизненный цикл pod

Представляет собой монтирование Ceph Filesystem, которое длится весь жизненный цикл pod. Объемы Cephfs не поддерживают управление правами владения или перемаркирование SELinux.
- cephfs.monitors ([]string), required
  
  Атомарно: будет заменено во время слияния
  
  monitors — Требуется: коллекция Ceph мониторов. Дополнительная информация: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- cephfs.path (string)
  
  path — Необязательно: используется в качестве смонтированного корня, а не всего дерева Ceph, по умолчанию /
- cephfs.readOnly (boolean)
  
  readOnly — Необязательно: по умолчанию false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts. Дополнительная информация: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- cephfs.secretFile (string)
  
  secretFile — Необязательно: SecretFile — путь к файлу ключей для пользователя, по умолчанию /etc/ceph/user.secret. Дополнительная информация: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
- cephfs.secretRef (SecretReference)
  
  secretRef — Необязательно: SecretRef — ссылка на секрет аутентификации для пользователя, по умолчанию пусто. Дополнительная информация: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
  
  SecretReference представляет собой ссылку на секрет. Она содержит достаточную информацию для получения секрета в любом пространстве имен
  - cephfs.secretRef.name (string)
    
    name — уникален в рамках пространства имен для ссылки на ресурс секрета.
  - cephfs.secretRef.namespace (string)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- cephfs.user (string)
  
  user — Необязательно: имя пользователя rados, по умолчанию admin. Дополнительная информация: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
cinder (CinderPersistentVolumeSource)

cinder представляет собой объем cinder, подключенный и смонтированный на хост-машину kubelet. Дополнительная информация: https://examples.k8s.io/mysql-cinder-pd/README.md

Представляет собой ресурс объема cinder в Openstack. Объем Cinder должен существовать перед подключением к контейнеру. Объем также должен находиться в той же области, что и kubelet. Объемы Cinder поддерживают управление правами владения и перемаркирование SELinux.
- cinder.volumeID (string), required
  
  volumeID используется для идентификации объема в cinder. Дополнительная информация: https://examples.k8s.io/mysql-cinder-pd/README.md
- cinder.fsType (string)
  
  fsType — Тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Примеры: "ext4", "xfs", "ntfs". Если не указано, неявно предполагается "ext4". Дополнительная информация: https://examples.k8s.io/mysql-cinder-pd/README.md
- cinder.readOnly (boolean)
  
  readOnly — Необязательно: по умолчанию false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts. Дополнительная информация: https://examples.k8s.io/mysql-cinder-pd/README.md
- cinder.secretRef (SecretReference)
  
  secretRef — Необязательно: указывает на объект секрета, содержащий параметры для подключения к OpenStack.
  
  SecretReference представляет собой ссылку на секрет. Она содержит достаточную информацию для получения секрета в любом пространстве имен
  - cinder.secretRef.name (string)
    
    name — уникален в рамках пространства имен для ссылки на ресурс секрета.
  - cinder.secretRef.namespace (string)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.

csi (CSIPersistentVolumeSource)

csi представляет хранилище, которое обрабатывается внешним драйвером CSI (функция Beta).

Представляет хранилище, управляемое внешним драйвером тома CSI (функция Beta)
- csi.driver (строка), обязательно
  
  driver — это имя драйвера, используемого для этого тома. Обязательно.
- csi.volumeHandle (строка), обязательно
  
  volumeHandle — уникальное имя тома, возвращаемое плагином CSI для тома при вызове CreateVolume для ссылки на том во всех последующих вызовах. Обязательно.
- csi.controllerExpandSecretRef (SecretReference)
  
  controllerExpandSecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи драйверу CSI для выполнения вызова CSI ControllerExpandVolume. Это необязательное поле, и оно может быть пустым, если секрет не требуется. Если объект секрета содержит более одного секрета, все секреты передаются.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - csi.controllerExpandSecretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - csi.controllerExpandSecretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- csi.controllerPublishSecretRef (SecretReference)
  
  controllerPublishSecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи драйверу CSI для выполнения вызовов CSI ControllerPublishVolume и ControllerUnpublishVolume. Это необязательное поле, и оно может быть пустым, если секрет не требуется. Если объект секрета содержит более одного секрета, все секреты передаются.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - csi.controllerPublishSecretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - csi.controllerPublishSecretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- csi.fsType (строка)
  
  fsType для монтирования. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Например, "ext4", "xfs", "ntfs".
- csi.nodeExpandSecretRef (SecretReference)
  
  nodeExpandSecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи драйверу CSI для выполнения вызова CSI NodeExpandVolume. Это необязательное поле, может быть опущено, если секрет не требуется. Если объект секрета содержит более одного секрета, все секреты передаются.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - csi.nodeExpandSecretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - csi.nodeExpandSecretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- csi.nodePublishSecretRef (SecretReference)
  
  nodePublishSecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи драйверу CSI для выполнения вызовов CSI NodePublishVolume и NodeUnpublishVolume. Это необязательное поле, и оно может быть пустым, если секрет не требуется. Если объект секрета содержит более одного секрета, все секреты передаются.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - csi.nodePublishSecretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - csi.nodePublishSecretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- csi.nodeStageSecretRef (SecretReference)
  
  nodeStageSecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи драйверу CSI для выполнения вызовов CSI NodeStageVolume и NodeUnstageVolume. Это необязательное поле, и оно может быть пустым, если секрет не требуется. Если объект секрета содержит более одного секрета, все секреты передаются.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - csi.nodeStageSecretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - csi.nodeStageSecretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
- csi.readOnly (булево значение)
  
  значение readOnly для передачи в ControllerPublishVolumeRequest. По умолчанию — false (чтение/запись).
- csi.volumeAttributes (карта[строка]строка)
  
  volumeAttributes тома для публикации.
fc (FCVolumeSource)

fc представляет ресурс Fibre Channel, подключенный к хост-машине kubelet, а затем экспонированный для под.

Представляет том Fibre Channel. Тома Fibre Channel могут быть смонтированы только в режиме чтения/записи один раз. Тома Fibre Channel поддерживают управление правами владения и перемаркировку SELinux.
- fc.fsType (строка)
  
  fsType — тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Примеры: "ext4", "xfs", "ntfs". Неявное значение — "ext4", если не указано.
- fc.lun (int32)
  
  lun — Необязательно: номер LUN целевого устройства FC
- fc.readOnly (булево значение)
  
  readOnly — Необязательно: По умолчанию — false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts.
- fc.targetWWNs ([]строка)
  
  Атомарный: будет заменён во время слияния
  
  targetWWNs — Необязательно: глобальные имена целевого устройства FC (WWN)
- fc.wwids ([]строка)
  
  Атомарный: будет заменён во время слияния
  
  wwids — Необязательно: идентификаторы глобального уровня тома FC (wwids). Должен быть установлен либо wwids, либо комбинация targetWWNs и lun, но не оба одновременно.
flexVolume (FlexPersistentVolumeSource)

flexVolume представляет общий ресурс тома, который провизионируется/подключается с помощью плагина на основе exec.

FlexPersistentVolumeSource представляет общий ресурс постоянного тома, который провизионируется/подключается с помощью плагина на основе exec.
- flexVolume.driver (строка), обязательно
  
  driver — имя драйвера, используемого для этого тома.
- flexVolume.fsType (строка)
  
  fsType — тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемым операционной системой хоста. Например, "ext4", "xfs", "ntfs". Файловая система по умолчанию зависит от сценария FlexVolume.
- flexVolume.options (карта[строка]строка)
  
  options — Необязательно: это поле содержит дополнительные параметры команд, если таковые имеются.
- flexVolume.readOnly (булево значение)
  
  readOnly — Необязательно: по умолчанию — false (чтение/запись). ReadOnly здесь принудительно установит значение ReadOnly в VolumeMounts.
- flexVolume.secretRef (SecretReference)
  
  secretRef — Необязательно: SecretRef — ссылка на объект секрета, содержащий конфиденциальную информацию для передачи скриптам плагина. Может быть пустым, если объект секрета не указан. Если объект секрета содержит более одного секрета, все секреты передаются скриптам плагина.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета в любом пространстве имен
  - flexVolume.secretRef.name (строка)
    
    name — уникальный в пространстве имен идентификатор для ссылки на ресурс секрета.
  - flexVolume.secretRef.namespace (строка)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
flocker (FlockerVolumeSource)

flocker представляет том Flocker, подключенный к хост-машине kubelet и экспонированный для под для его использования. Это зависит от того, запущен ли контрольный сервис Flocker.

Представляет том Flocker, смонтированный агентом Flocker. Должен быть установлен только один из datasetName и datasetUUID. Тома Flocker не поддерживают управление правами владения или перемаркировку SELinux.
- flocker.datasetName (строка)
  
  datasetName — Имя набора данных, хранящегося как metadata -> name в наборе данных для Flocker следует рассматривать как устаревшее.
- flocker.datasetUUID (строка)
  
  datasetUUID — UUID набора данных. Это уникальный идентификатор набора данных Flocker
gcePersistentDisk (GCEPersistentDiskVolumeSource)

gcePersistentDisk представляет ресурс диска GCE, подключенный к хост-машине kubelet, а затем экспонированный для под. Провизионируется администратором. Подробнее: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

*Представляет ресурс постоянного диска в Google Compute Engine.

Диск GCE должен существовать перед монтированием в контейнер. Диск также должен находиться в том же проекте и зоне GCE, что и kubelet. Диск GCE может быть смонтирован только в режиме чтения/записи один раз или в режиме только для чтения многократно. Диски GCE поддерживают управление правами владения и перемаркировку SELinux.*
- gcePersistentDisk.pdName (строка), обязательно
  
  pdName — уникальное имя ресурса диска GCE. Используется для идентификации диска в GCE. Подробнее: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- gcePersistentDisk.fsType (строка)
  
  fsType — тип файловой системы тома, который нужно смонтировать. Совет: убедитесь, что тип файловой системы поддерживается операционной системой хоста. Примеры: "ext4", "xfs", "ntfs". Неявное значение — "ext4", если не указано. Подробнее: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- gcePersistentDisk.partition (int32)
  
  partition — раздел в томе, который нужно смонтировать. Если опущено, то монтирование происходит по имени тома. Примеры: для тома /dev/sda1, укажите раздел как "1". Аналогично, раздел тома для /dev/sda — "0" (или вы можете оставить свойство пустым). Подробнее: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
- gcePersistentDisk.readOnly (булево значение)
  
  readOnly здесь принудительно установит значение ReadOnly в VolumeMounts. По умолчанию — false. Подробнее: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

glusterfs (GlusterfsPersistentVolumeSource)

glusterfs представляет собой том Glusterfs, подключенный к узлу и предоставленный под. Обеспечивается администратором. Дополнительная информация: https://examples.k8s.io/volumes/glusterfs/README.md

Представляет собой точку монтирования Glusterfs, существующую на протяжении всего срока службы под. Тома Glusterfs не поддерживают управление правами владения или перемаркировку SELinux.
- glusterfs.endpoints (string), required
  
  endpoints — это имя конечной точки, которое описывает топологию Glusterfs. Дополнительная информация: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
- glusterfs.path (string), required
  
  path — это путь к тому Glusterfs. Дополнительная информация: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
- glusterfs.endpointsNamespace (string)
  
  endpointsNamespace — это пространство имен, содержащее конечную точку Glusterfs. Если это поле пустое, пространство имен EndpointNamespace по умолчанию совпадает с пространством имен привязанного PVC. Дополнительная информация: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
- glusterfs.readOnly (boolean)
  
  readOnly здесь заставит том Glusterfs быть смонтированным со строгими правами чтения. По умолчанию false. Дополнительная информация: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
iscsi (ISCSIPersistentVolumeSource)

iscsi представляет собой ресурс диска ISCSI, подключенный к узлу kubelet и предоставленный под. Обеспечивается администратором.

ISCSIPersistentVolumeSource представляет собой диск ISCSI. Тома ISCSI могут быть смонтированы только в режиме чтения/записи один раз. Тома ISCSI поддерживают управление правами владения и перемаркировку SELinux.
- iscsi.iqn (string), required
  
  iqn — это квалифицированное имя целевого iSCSI.
- iscsi.lun (int32), required
  
  lun — это номер LUN целевого iSCSI.
- iscsi.targetPortal (string), required
  
  targetPortal — это целевой портал iSCSI. Портал — это либо IP-адрес, либо ip_addr:port, если порт отличается от стандартного (обычно TCP-порты 860 и 3260).
- iscsi.chapAuthDiscovery (boolean)
  
  chapAuthDiscovery определяет, поддерживается ли аутентификация CHAP при обнаружении iSCSI.
- iscsi.chapAuthSession (boolean)
  
  chapAuthSession определяет, поддерживается ли аутентификация CHAP при создании сессии iSCSI.
- iscsi.fsType (string)
  
  fsType — тип файловой системы тома, который вы хотите смонтировать. Совет: Убедитесь, что тип файловой системы поддерживается операционной системой узла. Примеры: "ext4", "xfs", "ntfs". По умолчанию подразумевается "ext4", если не указано иное. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#iscsi
- iscsi.initiatorName (string)
  
  initiatorName — это пользовательское имя инициатора iSCSI. Если initiatorName указан вместе с iscsiInterface, для подключения будет создан новый интерфейс iSCSI <target portal>:<имя тома>.
- iscsi.iscsiInterface (string)
  
  iscsiInterface — это имя интерфейса, использующего транспорт iSCSI. По умолчанию 'default' (tcp).
- iscsi.portals ([]string)
  
  Атомарно: будет заменено во время слияния
  
  portals — это список целевых порталов iSCSI. Портал — это либо IP-адрес, либо ip_addr:port, если порт отличается от стандартного (обычно TCP-порты 860 и 3260).
- iscsi.readOnly (boolean)
  
  readOnly здесь заставит устанавливать ReadOnly в VolumeMounts. По умолчанию false.
- iscsi.secretRef (SecretReference)
  
  secretRef — это секрет CHAP для аутентификации целевого iSCSI и инициатора.
  
  SecretReference представляет ссылку на секрет. Она содержит достаточную информацию для извлечения секрета из любого пространства имён
  - iscsi.secretRef.name (string)
    
    name — уникальное имя внутри пространства имён для ссылки на ресурс секрета.
  - iscsi.secretRef.namespace (string)
    
    namespace определяет пространство, в котором имя секрета должно быть уникальным.
nfs (NFSVolumeSource)

nfs представляет собой монтирование NFS на узле. Обеспечивается администратором. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#nfs

Представляет собой монтирование NFS, существующее на протяжении всего срока службы под. Тома NFS не поддерживают управление правами владения или перемаркировку SELinux.
- nfs.path (string), required
  
  путь, экспортированный сервером NFS. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#nfs
- nfs.server (string), required
  
  server — имя хоста или IP-адрес сервера NFS. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#nfs
- nfs.readOnly (boolean)
  
  readOnly здесь заставит экспорт NFS быть смонтированным со строгими правами чтения. По умолчанию false. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#nfs
photonPersistentDisk (PhotonPersistentDiskVolumeSource)

photonPersistentDisk представляет собой постоянный диск PhotonController, подключенный и смонтированный на узле kubelet.

Представляет собой ресурс постоянного диска Photon Controller.
- photonPersistentDisk.pdID (string), required
  
  pdID — это идентификатор, который определяет постоянный диск Photon Controller.
- photonPersistentDisk.fsType (string)
  
  fsType — тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемой операционной системой узла. Пример: "ext4", "xfs", "ntfs". По умолчанию подразумевается "ext4", если не указано иное.
portworxVolume (PortworxVolumeSource)

portworxVolume представляет собой том Portworx, подключенный и смонтированный на узле kubelet.

PortworxVolumeSource представляет собой ресурс тома Portworx.
- portworxVolume.volumeID (string), required
  
  volumeID однозначно идентифицирует том Portworx.
- portworxVolume.fsType (string)
  
  fSType представляет собой тип файловой системы для монтирования. Должен быть типом файловой системы, поддерживаемой операционной системой узла. Примеры: "ext4", "xfs". По умолчанию подразумевается "ext4", если не указано иное.
- portworxVolume.readOnly (boolean)
  
  readOnly по умолчанию false (чтение/запись). ReadOnly здесь заставит устанавливать ReadOnly в VolumeMounts.
quobyte (QuobyteVolumeSource)

quobyte представляет собой монтирование Quobyte на узле, срок существования которого совпадает со сроком существования под.

Представляет собой монтирование Quobyte, существующее на протяжении всего срока службы под. Тома Quobyte не поддерживают управление правами владения или перемаркировку SELinux.
- quobyte.registry (string), required
  
  registry представляет собой один или несколько сервисов реестра Quobyte, указанных в виде пары имя_хоста:порт (несколько записей разделены запятыми), которые действуют как центральный реестр для томов.
- quobyte.volume (string), required
  
  volume — это строка, ссылающаяся на уже созданный том Quobyte по имени.
- quobyte.group (string)
  
  группа для сопоставления доступа к томам По умолчанию группа не используется
- quobyte.readOnly (boolean)
  
  readOnly здесь заставит том Quobyte быть смонтированным со строгими правами чтения. По умолчанию false.
- quobyte.tenant (string)
  
  арендатор, владеющий данным томом Quobyte в бэкенде Используется с динамически развёртываемыми томами Quobyte, значение устанавливается плагином
- quobyte.user (string)
  
  пользователь для сопоставления доступа к томам По умолчанию используется пользователь сервиса

rbd (RBDPersistentVolumeSource)

rbd представляет собой подключение устройства Rados Block Device к хосту, совмещающее жизненный цикл под. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md

Представляет собой подключение устройства Rados Block Device, которое существует на протяжении всего жизненного цикла под. Тома RBD поддерживают управление правами владения и перемаркировку SELinux.
- rbd.image (строка), обязательно
  
  image — имя изображения rados. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- rbd.monitors ([]строка), обязательно
  
  Атомарно: будет заменено при слиянии
  
  monitors — коллекция мониторов Ceph. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- rbd.fsType (строка)
  
  fsType — тип файловой системы тома, который вы хотите подключить. Совет: Убедитесь, что тип файловой системы поддерживается операционной системой хоста. Примеры: "ext4", "xfs", "ntfs". По умолчанию неявно предполагается "ext4". Дополнительная информация: https://kubernetes.io/docs/concepts/storage/volumes#rbd
- rbd.keyring (строка)
  
  keyring — путь к файлу ключей для RBDUser. По умолчанию — /etc/ceph/keyring. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- rbd.pool (строка)
  
  pool — имя пула rados. По умолчанию — rbd. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- rbd.readOnly (булево)
  
  readOnly здесь будет принудительно устанавливать значение ReadOnly в VolumeMounts. По умолчанию — false. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
- rbd.secretRef (SecretReference)
  
  secretRef — имя секрета аутентификации для RBDUser. Если указано, переопределяет keyring. По умолчанию — null. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
  
  SecretReference представляет собой ссылку на секрет. Она содержит достаточную информацию для извлечения секрета из любого пространства имен
  - rbd.secretRef.name (строка)
    
    name — уникальное значение в рамках пространства имен для ссылки на ресурс секрета.
  - rbd.secretRef.namespace (строка)
    
    namespace определяет пространство имен, в рамках которого имя секрета должно быть уникальным.
- rbd.user (строка)
  
  user — имя пользователя rados. По умолчанию — admin. Дополнительная информация: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
scaleIO (ScaleIOPersistentVolumeSource)

scaleIO представляет собой подключенный и смонтированный на узлах Kubernetes постоянный том ScaleIO.

ScaleIOPersistentVolumeSource представляет собой постоянный том ScaleIO
- scaleIO.gateway (строка), обязательно
  
  gateway — адрес хоста шлюза API ScaleIO.
- scaleIO.secretRef (SecretReference), обязательно
  
  secretRef ссылается на секрет для пользователя ScaleIO и другой конфиденциальной информации. Если это не указано, операция входа в систему завершится ошибкой.
  
  SecretReference представляет собой ссылку на секрет. Она содержит достаточную информацию для извлечения секрета из любого пространства имен
  - scaleIO.secretRef.name (строка)
    
    name — уникальное значение в рамках пространства имен для ссылки на ресурс секрета.
  - scaleIO.secretRef.namespace (строка)
    
    namespace определяет пространство имен, в рамках которого имя секрета должно быть уникальным.
- scaleIO.system (строка), обязательно
  
  system — имя системы хранения, настроенной в ScaleIO.
- scaleIO.fsType (строка)
  
  fsType — тип файловой системы для подключения. Должен быть типом файловой системы, поддерживаемой операционной системой хоста. Например, "ext4", "xfs", "ntfs". По умолчанию — "xfs".
- scaleIO.protectionDomain (строка)
  
  protectionDomain — имя домена защиты ScaleIO для настроенного хранилища.
- scaleIO.readOnly (булево)
  
  readOnly по умолчанию — false (чтение/запись). ReadOnly здесь будет принудительно устанавливать значение ReadOnly в VolumeMounts.
- scaleIO.sslEnabled (булево)
  
  sslEnabled — флаг для включения/выключения SSL-общения со шлюзом, по умолчанию false.
- scaleIO.storageMode (строка)
  
  storageMode указывает, должно ли хранилище для тома быть ThickProvisioned или ThinProvisioned. По умолчанию — ThinProvisioned.
- scaleIO.storagePool (строка)
  
  storagePool — пул хранилища ScaleIO, связанный с доменом защиты.
- scaleIO.volumeName (строка)
  
  volumeName — имя тома, уже созданного в системе ScaleIO, связанного с этим источником тома.
storageos (StorageOSPersistentVolumeSource)

storageOS представляет собой том StorageOS, подключенный к узлу kubelet и смонтированный в под. Дополнительная информация: https://examples.k8s.io/volumes/storageos/README.md

Представляет собой ресурс постоянного тома StorageOS.
- storageos.fsType (строка)
  
  fsType — тип файловой системы для подключения. Должен быть типом файловой системы, поддерживаемой операционной системой хоста. Например, "ext4", "xfs", "ntfs". По умолчанию неявно предполагается "ext4".
- storageos.readOnly (булево)
  
  readOnly по умолчанию — false (чтение/запись). ReadOnly здесь будет принудительно устанавливать значение ReadOnly в VolumeMounts.
- storageos.secretRef (ObjectReference)
  
  secretRef указывает секрет для получения учетных данных API StorageOS. Если не указано, будут использоваться значения по умолчанию.
- storageos.volumeName (строка)
  
  volumeName — удобочитаемое имя тома StorageOS. Имена томов уникальны только в пределах пространства имен.
- storageos.volumeNamespace (строка)
  
  volumeNamespace определяет область действия тома в StorageOS. Если пространство имен не указано, будет использоваться пространство имен под. Это позволяет отобразить схему именования Kubernetes в StorageOS для лучшей интеграции. Установите VolumeName в любое имя, чтобы переопределить поведение по умолчанию. Установите в "default", если вы не используете пространства имен в StorageOS. Пространства имен, которые не существуют в StorageOS, будут созданы.
vsphereVolume (VsphereVirtualDiskVolumeSource)

vsphereVolume представляет собой том vSphere, подключенный и смонтированный на узле kubelet.

Представляет собой ресурс тома vSphere.
- vsphereVolume.volumePath (строка), обязательно
  
  volumePath — путь, идентифицирующий виртуальный диск vmdk vSphere.
- vsphereVolume.fsType (строка)
  
  fsType — тип файловой системы для подключения. Должен быть типом файловой системы, поддерживаемой операционной системой хоста. Например, "ext4", "xfs", "ntfs". По умолчанию неявно предполагается "ext4".
- vsphereVolume.storagePolicyID (строка)
  
  storagePolicyID — идентификатор профиля управления хранилищем на основе политик (SPBM), связанный с StoragePolicyName.
- vsphereVolume.storagePolicyName (строка)
  
  storagePolicyName — имя профиля управления хранилищем на основе политик (SPBM).

PersistentVolumeStatus

PersistentVolumeStatus — текущее состояние постоянного тома.

lastPhaseTransitionTime (Время)

lastPhaseTransitionTime — время перехода фазы из одного состояния в другое, и автоматически сбрасывается на текущее время каждый раз, когда фаза тома переходит в новое состояние.

Time — обёртка вокруг time.Time, которая поддерживает правильную сериализацию в YAML и JSON. Предоставляются обёртки для многих фабричных методов, которые предлагает пакет time.
message (строка)

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

phase указывает, доступен ли том, привязан ли он к требованию или освобожден требованием. Дополнительная информация: https://kubernetes.io/docs/concepts/storage/persistent-volumes#phase
reason (строка)

reason — краткая строка в формате CamelCase, описывающая любую ошибку, предназначенная для машинного анализа и аккуратного отображения в командной строке.

PersistentVolumeList

PersistentVolumeList — список элементов PersistentVolume.

apiVersion: v1
kind: PersistentVolumeList
metadata (ListMeta)

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

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

© 2024 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2024 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1/