CSINode

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

apiVersion: storage.k8s.io/v1

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

CSINode

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознаваемые схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ObjectMeta	Стандартные метаданные объекта. metadata.name должно совпадать с именем узла Kubernetes.
`spec` * CSINodeSpec	spec — спецификация CSINode

CSINodeSpec

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

Поле	Описание
`drivers` * CSINodeDriver array стратегия patch: слияние по ключу `name`	drivers — это список сведений обо всех драйверах CSI, установленных на узле. Если все драйверы из списка удалены, список может стать пустым.

CSINodeList

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

Поле	Описание
`apiVersion` string	APIVersion определяет версионированную схему этого представления объекта. Серверы должны преобразовывать распознаваемые схемы в последнее внутреннее представление и могут отклонять нераспознанные значения. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`items` * CSINode array	items — список объектов CSINode
`kind` string	Kind — строковое значение, представляющее ресурс REST, который описывает этот объект. Серверы могут определить его по конечной точке, на которую клиент отправляет запросы. Не может быть обновлено. В CamelCase. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata` ListMeta	Стандартные метаданные списка. Дополнительная информация: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

CSINodeDriver

CSINodeDriver содержит сведения о спецификации одного драйвера CSI, установленного на узле

Поле	Описание
`allocatable` VolumeNodeResources	allocatable представляет ресурсы томов узла, доступные для планирования. Это поле находится на стадии бета-тестирования.
`name` * string	name представляет имя драйвера CSI, к которому относится этот объект. Оно ДОЛЖНО совпадать с именем, возвращаемым вызовом CSI GetPluginName() для этого драйвера.
`nodeID` * string	nodeID узла с точки зрения драйвера. Это поле позволяет Kubernetes взаимодействовать с системами хранения, использующими для узлов другие обозначения. Например, Kubernetes может называть узел "node1", а система хранения — "nodeA". Когда Kubernetes отправляет системе хранения команду подключить том к определенному узлу, это поле позволяет указать имя узла с помощью идентификатора, понятного системе хранения, например "nodeA" вместо "node1". Это поле обязательно.
`topologyKeys` string array	topologyKeys — это список ключей, поддерживаемых драйвером. При инициализации драйвера в кластере он предоставляет набор понятных ему ключей топологии (например, "company.com/zone", "company.com/region"). При инициализации драйвера на узле он предоставляет те же ключи топологии вместе со значениями. Kubelet публикует эти ключи топологии как метки в собственном объекте узла. При выполнении Kubernetes топологически-зависимого выделения ресурсов этот список позволяет определить, какие метки следует получить из объекта узла и передать драйверу. На разных узлах могут использоваться разные ключи топологии. Это поле может быть пустым, если драйвер не поддерживает топологию.

VolumeNodeResources

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

Поле Описание

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

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

© 2026 The Kubernetes Authors | Documentation Distributed under CC BY 4.0
Copyright © 2026 The Linux Foundation ®. All rights reserved.
https://kubernetes.io/docs/reference/kubernetes-api/storage/csi-node-v1/