CSINode

apiVersion: storage.k8s.io/v1

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

CSINode

CSINode хранит информацию обо всех установленных на узле драйверах CSI. Драйверам CSI не нужно создавать объект CSINode напрямую. Достаточно использовать сайдкар-контейнер node-driver-registrar, и kubelet автоматически заполнит объект CSINode для драйвера CSI в рамках регистрации плагина kubelet. Имя CSINode совпадает с именем узла. Если объект отсутствует, это означает, что на узле нет доступных драйверов CSI или версия Kubelet недостаточно новая для создания этого объекта. CSINode имеет OwnerReference, который указывает на соответствующий объект узла.

• apiVersion: storage.k8s.io/v1

• kind: CSINode

• metadata (ObjectMeta)

  Стандартные метаданные объекта. metadata.name должен совпадать с именем узла Kubernetes.

• spec (CSINodeSpec), необходимо

  spec — это спецификация CSINode

CSINodeSpec

CSINodeSpec хранит информацию о спецификации всех установленных на узле драйверов CSI

• drivers ([]CSINodeDriver), необходимо

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

  drivers — список информации обо всех драйверах CSI, существующих на узле. Если все драйверы в списке удалены, список может стать пустым.

  CSINodeDriver хранит информацию о спецификации одного установленного на узле драйвера CSI

  • drivers.name (строка), необходимо

    name представляет имя драйвера CSI, на который ссылается этот объект. ОНО ДОЛЖНО совпадать с именем, возвращаемым вызовом CSI GetPluginName() для этого драйвера.

  • drivers.nodeID (строка), необходимо

    nodeID узла с точки зрения драйвера. Это поле позволяет Kubernetes взаимодействовать с системами хранения, которые не используют одинаковую номенклатуру для узлов. Например, Kubernetes может ссылаться на узел как на "node1", а система хранения — как на "nodeA". Когда Kubernetes отправляет команду системе хранения для подключения тома к определенному узлу, он может использовать это поле для ссылки на имя узла с использованием идентификатора, понятного системе хранения, например, "nodeA" вместо "node1". Это поле необходимо.

  • drivers.allocatable (VolumeNodeResources)

    allocatable представляет собой ресурсы тома узла, доступные для планирования. Это поле — бета-версия.

    VolumeNodeResources — это набор ограничений ресурсов для планирования томов.

    • drivers.allocatable.count (int32)

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

  • drivers.topologyKeys ([]string)

    topologyKeys — список ключей, поддерживаемых драйвером. Когда драйвер инициализируется в кластере, он предоставляет набор ключей топологии, которые он понимает (например, "company.com/zone", "company.com/region"). Когда драйвер инициализируется на узле, он предоставляет те же ключи топологии вместе со значениями. Kubelet будет отображать эти ключи топологии в качестве меток в собственном объекте узла. При планировании ресурсов с учетом топологии Kubernetes может использовать этот список для определения меток, которые следует получить из объекта узла и передать обратно драйверу. Возможно, разные узлы используют разные ключи топологии. Список может быть пустым, если драйвер не поддерживает топологию.

CSINodeList

CSINodeList — коллекция объектов CSINode.

• apiVersion: storage.k8s.io/v1

• kind: CSINodeList

• metadata (ListMeta)

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

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

  items — это список CSINode