Стадия жизненного цикла модуля: Предварительная версия (preview)

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

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

ClusterIPAddress

Короткие имена: cipa

Область: Cluster
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

Запрос на IPv4-адрес для дополнительного сетевого интерфейса пода, подключенного к кластерной сети.

  • spec
    объект
    Желаемое состояние ресурса.
    • spec.networkRef
      объект

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

      Ссылка на сеть, используемую как источник конфигурации IPAM.
      • spec.networkRef.kind
        строка

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

        Тип (kind) указанной сети.

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

      • spec.networkRef.name
        строка

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

        Имя указанной сети.
    • spec.static
      объект
      Параметры для типа выделения Static.
      • spec.static.ip
        строка

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

        Запрашиваемый IPv4-адрес.

        Пример: 

        ip: 192.168.1.1
    • spec.type
      строка

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

      Запрашиваемый тип выделения адреса.

      • Auto: выделить свободный адрес из пула.
      • Static: выделить адрес, указанный в .spec.static.ip.

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

  • status
    объект
    Наблюдаемое состояние ресурса.
    • status.address
      строка
      Выделенный IPv4-адрес.
    • status.conditions
      массив объектов
      Conditions represent the latest available observations of the resource’s state.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
        Type of condition.
    • status.ipAddressPoolRef
      объект
      Reference to the pool used to allocate this address.
      • status.ipAddressPoolRef.kind
        строка
        Тип (kind) указанного пула.
      • status.ipAddressPoolRef.name
        строка
        Имя указанного пула.
    • status.network
      строка
      IPv4-сеть (CIDR), связанная с выделенным адресом.
    • status.observedGeneration
      целое число
      Последнее поколение, наблюдаемое контроллером.
    • status.phase
      строка
      Высокоуровневая фаза жизненного цикла.
    • status.routes
      массив объектов
      Статические маршруты, связанные с этим адресом.
      • status.routes.destination
        строка
        CIDR сети назначения.
      • status.routes.via
        строка
        IPv4-адрес следующего хопа (шлюза).
    • status.usedBy
      объект
      Set by the agent when this address is used by a SystemNetwork attachment.
      • status.usedBy.node
        строка
        Name of the node where this address is applied.
      • status.usedBy.systemNetwork
        строка
        Name of the SystemNetwork that uses this address.

ClusterIPAddressPool

Короткие имена: cipap

Область: Cluster
Версия: v1alpha1

Определяет пул IPv4-адресов в масштабе кластера, используемый для IPAM в кластерных сетях.
  • spec
    объект
    Желаемое состояние ресурса.
    • spec.leaseTTL
      строка
      Время жизни объектов IPAddressLease, созданных для адресов из этого пула.

      По умолчанию: 1h

      Примеры: 

      leaseTTL: 30s

      leaseTTL: 1m

      leaseTTL: 24h
    • spec.pools
      массив объектов

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

      Список пулов, обслуживаемых этим ресурсом.
      • spec.pools.network
        строка
        CIDR IPv4 сети, обслуживаемой этой записью пула.

        Пример: 

        network: 192.168.1.0/24
      • spec.pools.ranges
        массив строк
        Необязательный список доступных IP-диапазонов внутри network.

        Примеры: 

        ranges: 192.168.1.50

        ranges: 192.168.1.51

        ranges: 192.168.1.0/24

        ranges: 192.168.1.100-192.168.1.110
        • spec.pools.ranges.Элемент массива
          строка
          Выражение доступного IPv4-диапазона (“startIP-endIP”, “CIDR” или одиночный IPv4).

          Шаблон: ^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(?:-(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)|\/(?:3[0-2]|[12]?\d))?$

          Примеры: 

          '': 192.168.1.50

          '': 192.168.1.0/24

          '': 192.168.1.100-192.168.1.110
      • spec.pools.routes
        массив объектов
        Необязательный список статических маршрутов, связанных с адресами, выделенными из этой записи пула.
        • spec.pools.routes.destination
          строка
          CIDR сети назначения для маршрута.

          Примеры: 

          destination: 192.168.10.0/24

          destination: 8.8.8.8/32
        • spec.pools.routes.via
          строка
          IPv4-адрес следующего хопа (шлюза).

          Пример: 

          via: 192.168.1.1
  • status
    объект
    Наблюдаемое состояние ресурса.
    • status.conditions
      массив объектов
      Conditions represent the latest available observations of the resource’s state.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
        Condition type.
    • status.observedGeneration
      целое число
      Последнее значение .metadata.generation, наблюдаемое контроллером.
    • status.phase
      строка
      Высокоуровневая фаза жизненного цикла.

ClusterNetwork

Короткие имена: cnet

Область: Cluster
Версия: v1alpha1

Определяет ресурс ClusterNetwork для настройки общедоступных сетей в масштабе всего кластера.
  • spec
    объект
    Спецификация ресурса ClusterNetwork, определяющего параметры сети.
    • spec.ipam
      объект
      Конфигурация IPAM для сети.
      • spec.ipam.ipAddressPoolRef
        объект
        Ссылка на пул IP-адресов, используемый этой сетью.
        • spec.ipam.ipAddressPoolRef.kind
          строка

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

          Тип пула IP-адресов.

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

        • spec.ipam.ipAddressPoolRef.name
          строка

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

          Имя IP-адресов.
    • spec.mtu
      целое число
      MTU сети. Интерфейсы, создаваемые для подов сети, наследуют это значение, и оно передаётся в поды по DHCP. Не должно превышать MTU интерфейсов узлов, на которых построена сеть, иначе слишком большие кадры будут отбрасываться при выходе с узла.

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

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

      Примеры: 

      mtu: 1500

      mtu: 9000

      mtu: 1450
    • spec.parentNodeNetworkInterfaces
      объект
      Селектор для выбора сетевых интерфейсов узлов, к которым привязывается сеть.
      • spec.parentNodeNetworkInterfaces.labelSelector
        объект

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

        Селектор лейблов для фильтрации сетевых интерфейсов узлов.
        • spec.parentNodeNetworkInterfaces.labelSelector.matchLabels
          объект

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

          Набор лейблов, которые должны совпадать с лейблами сетевых интерфейсов узлов.
    • spec.primaryCNI
      объект
      Параметры PrimaryCNI. Описывают существующую основную pod-сеть, которой управляет CNI. Создаётся и поддерживается модулем SDN; пользователи не могут изменять эту секцию.
      • spec.primaryCNI.podCIDR
        массив строк

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

        Диапазон(ы) pod-сети, которые Cilium нарезает на узлы для эфемерных адресов подов. Синхронизируется модулем SDN из global.clusterConfiguration.podSubnetCIDR.
        • spec.primaryCNI.podCIDR.Элемент массива
          строка

          Пример: 

          '': 10.111.0.0/16
    • spec.type
      строка

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

      Тип сети. Поддерживаемые значения:

      • VLAN — на соответствующих сетевых интерфейсах узлов будут настроены тегированные интерфейсы (eth0.100, например) для обеспечения связности через VLAN, предоставленный инфраструктурой.
      • Access — соответствующие сетевые адаптеры на узлах будут использоваться непосредственно для обеспечения связности.

      Допустимые значения: Vlan, VLAN, Access, PrimaryCNI

    • spec.vlan
      объект
      Параметры VLAN для сети. Обязательно для типа VLAN.
      • spec.vlan.id
        целое число

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

        Идентификатор VLAN. Должен быть в диапазоне от 1 до 4094.

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

  • status
    объект
    Статус ресурса ClusterNetwork, содержащий информацию о текущем состоянии.
    • status.bridgeName
      строка
      Имя bridge-интерфейса на узле.
    • status.conditions
      массив объектов
      Список условий, описывающих текущее состояние ресурса.
      • status.conditions.lastTransitionTime
        строка
        Время последнего изменения статуса условия.
      • status.conditions.message
        строка
        Подробное сообщение о состоянии условия.
      • status.conditions.reason
        строка
        Причина последнего изменения статуса.
      • status.conditions.status
        строка
        Статус условия: “True”, “False” или “Unknown”.
      • status.conditions.type
        строка
        Тип условия, уникальный идентификатор состояния (например, “Ready”, “Failed”).
    • status.nodeAttachementsCount
      целое число
      Количество всех узлов с Node Network Interface Attachment для данного ClusterNetwork.
    • status.observedGeneration
      целое число
      Номер поколения ресурса, обработанного контроллером.

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

    • status.readyNodeAttachementsCount
      целое число
      Количество всех узлов с Node Network Interface Attachment для данного ClusterNetwork, готовых к взаимодействию с SDN сетью.

IPAddress

Короткие имена: ipa

Область: Namespaced
Версия: v1alpha1

Namespaced-ресурс, который представляет запрос на IPv4-адрес для дополнительного сетевого интерфейса пода, подключенного к сети проекта.
  • spec
    объект
    Желаемое состояние ресурса.
    • spec.networkRef
      объект

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

      Ссылка на сеть, используемую как источник конфигурации IPAM.
      • spec.networkRef.kind
        строка

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

        Тип (kind) указанной сети.

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

      • spec.networkRef.name
        строка

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

        Имя указанной сети.
    • spec.static
      объект
      Параметры для типа выделения Static.
      • spec.static.ignoreLeaseTTLOnAllocation
        булевый
        Разрешает назначение запрошенного статического адреса игнорируя IPAddressLease существующий для этого IP адреса.
      • spec.static.ip
        строка

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

        Запрашиваемый IPv4-адрес.

        Пример: 

        ip: 192.168.1.1
    • spec.type
      строка

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

      Запрашиваемый тип выделения адреса.

      • Auto: выделить свободный адрес из пула.
      • Static: выделить адрес, указанный в .spec.static.ip.

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

  • status
    объект
    Наблюдаемое состояние ресурса.
    • status.address
      строка
      Выделенный IPv4-адрес.
    • status.conditions
      массив объектов
      Conditions represent the latest available observations of the resource’s state.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
        Type of condition.
    • status.ipAddressPoolRef
      объект
      Reference to the pool used to allocate this address.
      • status.ipAddressPoolRef.kind
        строка
        Тип (kind) указанного пула.
      • status.ipAddressPoolRef.name
        строка
        Имя указанного пула.
    • status.network
      строка
      IPv4-сеть (CIDR), связанная с выделенным адресом.
    • status.observedGeneration
      целое число
      Последнее поколение, наблюдаемое контроллером.
    • status.phase
      строка
      Высокоуровневая фаза жизненного цикла.
    • status.routes
      массив объектов
      Статические маршруты, связанные с этим адресом.
      • status.routes.destination
        строка
        CIDR сети назначения.
      • status.routes.via
        строка
        IPv4-адрес следующего хопа (шлюза).
    • status.usedByPods
      массив строк
      List of Pods that currently use this IP address.
      • status.usedByPods.Элемент массива
        строка
        Pod reference in namespace/name format.

IPAddressLease

Короткие имена: ipal

Область: Cluster
Версия: v1alpha1

Запись резервирования в кластере, которая содержит выделенный IP-адрес и предотвращает его присвоение другому IPAddress или ClusterIPAddress.
  • spec
    объект
    Желаемое состояние ресурса.
    • spec.ip
      строка
      Зарезервированный IPv4-адрес.

      Пример: 

      ip: 192.168.1.10
    • spec.ipAddressRef
      объект

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

      Ссылка на IPAddress или ClusterIPAddress, которому принадлежит эта аренда.
      • spec.ipAddressRef.kind
        строка

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

        Тип ссылочного ресурса IP-адреса.

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

      • spec.ipAddressRef.name
        строка

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

        Имя ссылочного IPAddress или ClusterIPAddress.
      • spec.ipAddressRef.namespace
        строка
        Пространство имён ссылочного ресурса IPAddress.
    • spec.networkRef
      объект

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

      Ссылка на Network, ClusterNetwork или SystemNetwork, связанную с этой арендой.
      • spec.networkRef.kind
        строка

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

        Тип (kind) ссылочного ресурса сети.

        Допустимые значения: Network, ClusterNetwork, SystemNetwork

      • spec.networkRef.name
        строка

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

        Имя ссылочного ресурса сети.
      • spec.networkRef.namespace
        строка
        Пространство имён ссылочного Network.
    • spec.ttl
      строка
      Время жизни, применяемое после того, как аренда помечена как сиротская (orphaned).

      Примеры: 

      ttl: 30s

      ttl: 1h
  • status
    объект
    Наблюдаемое состояние IPAddressLease.
    • status.orphaningTimestamp
      строка
      Временная отметка, когда аренда была помечена как сиротская (orphaned).

      Пример: 

      orphaningTimestamp: '2026-02-20T10:00:00Z'

IPAddressPool

Короткие имена: ipap

Область: Namespaced
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

Определяет пул IPv4-адресов, используемый для IPAM в сетях проекта.

  • spec
    объект
    Желаемое состояние ресурса.
    • spec.leaseTTL
      строка
      Время жизни объектов IPAddressLease, созданных для адресов из этого пула.

      По умолчанию: 1h

      Примеры: 

      leaseTTL: 30s

      leaseTTL: 1m

      leaseTTL: 24h
    • spec.pools
      массив объектов

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

      Список пулов, обслуживаемых этим ресурсом.
      • spec.pools.network
        строка
        CIDR IPv4 сети, обслуживаемой этой записью пула.

        Пример: 

        network: 192.168.1.0/24
      • spec.pools.ranges
        массив строк
        Необязательный список доступных IP-диапазонов внутри network.

        Примеры: 

        ranges: 192.168.1.50

        ranges: 192.168.1.51

        ranges: 192.168.1.0/24

        ranges: 192.168.1.100-192.168.1.110
        • spec.pools.ranges.Элемент массива
          строка
          Выражение доступного IPv4-диапазона (“startIP-endIP”, “CIDR” или одиночный IPv4).

          Шаблон: ^(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(?:-(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)|\/(?:3[0-2]|[12]?\d))?$

          Примеры: 

          '': 192.168.1.50

          '': 192.168.1.0/24

          '': 192.168.1.100-192.168.1.110
      • spec.pools.routes
        массив объектов
        Необязательный список статических маршрутов, связанных с адресами, выделенными из этой записи пула.
        • spec.pools.routes.destination
          строка
          CIDR сети назначения для маршрута.

          Примеры: 

          destination: 192.168.10.0/24

          destination: 8.8.8.8/32
        • spec.pools.routes.via
          строка
          IPv4-адрес следующего хопа (шлюза).

          Пример: 

          via: 192.168.1.1
  • status
    объект
    Наблюдаемое состояние ресурса.
    • status.conditions
      массив объектов
      Conditions represent the latest available observations of the resource’s state.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
        Condition type.
    • status.observedGeneration
      целое число
      Последнее значение .metadata.generation, наблюдаемое контроллером.
    • status.phase
      строка
      Высокоуровневая фаза жизненного цикла.

Network

Короткие имена: net

Область: Namespaced
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

Определяет ресурс Network для настройки пользовательской сети в кластере. Используется для управления параметрами, такими как класс сети и желаемый идентификатор VLAN.

  • spec
    объект
    Спецификация ресурса Network, определяющая параметры сети.
    • spec.ipam
      объект
      Конфигурация IPAM для сети.
      • spec.ipam.ipAddressPoolRef
        объект
        Ссылка на пул IP-адресов, используемый этой сетью.
        • spec.ipam.ipAddressPoolRef.kind
          строка

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

          Тип пула IP-адресов.

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

        • spec.ipam.ipAddressPoolRef.name
          строка

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

          Имя IP-адресов.
    • spec.mtu
      целое число
      MTU сети. Интерфейсы, создаваемые для подов сети, наследуют это значение, и оно передаётся в поды по DHCP. Не должно превышать MTU интерфейсов узлов, на которых построена сеть, иначе слишком большие кадры будут отбрасываться при выходе с узла.

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

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

      Примеры: 

      mtu: 1500

      mtu: 9000

      mtu: 1450
    • spec.networkClass
      строка

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

      Класс сети, используемый для данного ресурса Network.

      Минимальная длина: 1

      Шаблон: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

    • spec.type
      строка

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

      Тип сети.

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

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

    • spec.vlan
      объект
      Специфичные для VLAN параметры сети.
      • spec.vlan.id
        целое число
        Идентификатор VLAN из доступного пула, описанного в соответствующем NetworkClass. Должен быть в диапазоне от 1 до 4094.

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

  • status
    объект
    Статус ресурса Network, содержащий информацию о текущем состоянии.
    • status.bridgeName
      строка
      Имя bridge-интерфейса на узле.
    • status.conditions
      массив объектов
      List of status conditions for the Network.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
    • status.nodeAttachementsCount
      целое число
      Количество всех узлов с Node Network Interface Attachment для данного Network.
    • status.observedGeneration
      целое число
      Номер поколения ресурса, обработанного контроллером.

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

    • status.readyNodeAttachementsCount
      целое число
      Количество всех узлов с Node Network Interface Attachment для данного Network, готовых к взаимодействию с SDN сетью.
    • status.vlanID
      целое число
      Выделенный идентификатор VLAN, назначенный ресурсу.

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

NetworkClass

Короткие имена: nc

Область: Cluster
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

Определяет ресурс NetworkClass для предварительной настройки пользовательских сетей. Данные настройки используются в ресурсе Network.

  • spec
    объект
    • spec.vlan
      объект

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

      Параметры, специфичные для сетей, основанных на тегированных VLAN.
      • spec.vlan.idPool
        массив строк

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

        Массив доступных диапазонов VLAN ID.
        • spec.vlan.idPool.Элемент массива
          строка

          Шаблон: ^\d+(-\d+)?$

      • spec.vlan.parentNodeNetworkInterfaces
        объект

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

        Селектор для выбора ресурсов NodeNetworkInterface, отражающих сетевые интерфейсы, через которые будет подключена пользовательская сеть.
        • spec.vlan.parentNodeNetworkInterfaces.labelSelector
          объект

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

          Селектор лейблов для фильтрации ресурсов NodeNetworkInterface.
          • spec.vlan.parentNodeNetworkInterfaces.labelSelector.matchLabels
            объект
            Набор лейблов, которые должны совпадать с лейблами ресурсов NodeNetworkInterface.

NodeNetworkInterface

Короткие имена: nni

Область: Cluster
Версия: v1alpha1

Этот ресурс описывает и определяет сетевой интерфейс, представленный на узле. Используется как для обнаружения существующих интерфейсов (NIC, vlan, bridge, bond), так и создания новых, таких как VLAN или Bond.
  • spec
    объект
    • spec.bond
      объект
      Специфичные параметры для аггрегированных интерфейсов.
      • spec.bond.bondName
        строка

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

        Имя bond-интерфейса.
      • spec.bond.memberNetworkInterfaces
        массив объектов

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

        Массив селекторов интерфейсов-участников аггрегации.
        • spec.bond.memberNetworkInterfaces.labelSelector
          объект
          Селектор лейблов для определения интерфейсов, поверх которых будет создан bond-интерфейс.
          • spec.bond.memberNetworkInterfaces.labelSelector.matchLabels
            объект

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

            Набор лейблов, которые должны совпадать с лейблами ресурсов NodeNetworkInterface.
    • spec.bridge
      объект
      Параметры, специфичные для bridge-интерфейсов.
      • spec.bridge.bridgeName
        строка

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

        Имя bridge-интерфейса.
      • spec.bridge.memberNetworkInterfaces
        массив объектов

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

        Массив лейбл-селекторов для выбора ресурсов NodeNetworkInterface, которые являются частью бриджа.
        • spec.bridge.memberNetworkInterfaces.labelSelector
          объект
          Селектор лейблов для определения интерфейсов, которые являются частью бриджа.
          • spec.bridge.memberNetworkInterfaces.labelSelector.matchLabels
            объект

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

            Набор лейблов, которые должны совпадать с лейблами ресурсов NodeNetworkInterface.
    • spec.heritage
      Параметр устарел
      строка
      Источник, из которого создан данный ресурс, служебное поле для контроллеров.

      Допустимые значения: SDNDiscovered, NetworkController, Manual

    • spec.nic
      объект
      Параметры, применимые к физическим интерфейсам, когда spec.type равен NIC.
      • spec.nic.bindingMode
        строка
        Желаемый режим привязки для сетевого адаптера.

        Допустимые значения: NetDev, VFIO-PCI, DPDK

      • spec.nic.pf
        объект
        Настройки, специфичные для Physical Function (PF).
        • spec.nic.pf.sriov
          объект
          Конфигурация SR-IOV для физической функции.
          • spec.nic.pf.sriov.enabled
            булевый
            Включает SR-IOV на физической функции.

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

          • spec.nic.pf.sriov.numVFs
            целое число

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

            Количество виртуальных функций (VF) для создания при включении SR-IOV.

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

      • spec.nic.pfNodeNetworkInterfaceName
        строка
        Имя ресурса NodeNetworkInterface для родительского PF.
      • spec.nic.vf
        объект
        Конфигурация, специфичная для Virtual Function (VF).
        • spec.nic.vf.linkState
          строка
          Устанавливает состояние канала для VF.

          Допустимые значения: Auto, Enable, Disable

        • spec.nic.vf.mac
          строка
          MAC-адрес, назначенный VF.

          Шаблон: ^([0-9a-f]{2}:){5}[0-9a-f]{2}$

        • spec.nic.vf.mtu
          целое число
          MTU, настроенный на VF.

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

        • spec.nic.vf.queryRSS
          булевый
          Включает или отключает запрос конфигурации RSS для VF.
        • spec.nic.vf.spoofCheck
          булевый
          Включает или отключает проверку подмены MAC-адреса для VF.
        • spec.nic.vf.trust
          булевый
          Включает или отключает режим доверия для VF.
        • spec.nic.vf.vlan
          целое число
          VLAN-тег, назначенный VF.

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

    • spec.nodeName
      строка

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

      Имя узла, где расположен интерфейс.
    • spec.type
      строка

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

      Тип сетевого интерфейса:

      • NIC — физический сетевой адаптер.
      • VLAN — тегированный VLAN поверх другого сетевого интерфейса.
      • Bond — агрегированный интерфейс.
      • Bridge — bridge-интерфейс.

      Допустимые значения: NIC, VLAN, Bond, Bridge

    • spec.vlan
      объект
      Параметры, специфичные для vlan-интерфейсов.
      • spec.vlan.id
        целое число

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

        VLAN ID.
      • spec.vlan.parentNetworkInterface
        объект

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

        Селектор родительского ресурса NodeNetworkInterface, поверх которого поднят VLAN-интерфейс.
        • spec.vlan.parentNetworkInterface.labelSelector
          объект

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

          Селектор лейблов для определения родительского ресурса NodeNetworkInterface, поверх которого поднят VLAN-интерфейс.
          • spec.vlan.parentNetworkInterface.labelSelector.matchLabels
            объект

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

            Набор лейблов, которые должны совпадать с лейблами ресурсов NodeNetworkInterface.
  • status
    объект
    • status.conditions
      массив объектов
      Список условий, описывающих текущее состояние ресурса.
      • status.conditions.lastProbeTime
        строка
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.observedGeneration
        целое число
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
    • status.deviceMAC
      строка
      Фактический MAC-адрес интерфейса.
    • status.groupedBy
      строка
      Имя главного интерфейса, к которому сгруппирован данный интерфейс.
    • status.groupedLinks
      массив объектов
      Список сетевых интерфейсов, сгруппированных с помощью аггрегации или бриджа.
      • status.groupedLinks.deviceMAC
        строка
      • status.groupedLinks.type
        строка
    • status.ifIndex
      целое число
      Индекс интерфейса.
    • status.ifName
      строка
      Имя интерфейса на узле.
    • status.managedBy
      строка
      Источник управления интерфейсом.

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

    • status.mtu
      целое число
      Текущий MTU, настроенный на интерфейсе.
    • status.nic
      объект
      Дополнительные метаданные для физических сетевых интерфейсов.
      • status.nic.pci
        объект
        Метаданные, связанные с PCI для сетевого адаптера.
        • status.nic.pci.binding
          объект
          Информация о текущем режиме привязки устройства.
          • status.nic.pci.binding.driver
            строка
            Драйвер ядра, в данный момент привязанный к PCI функции.
          • status.nic.pci.binding.infinibandVerbsFile
            строка
            The infiniband file, derived from /dev/infiniband/uverbs4, which in this example is uverbs4.
          • status.nic.pci.binding.iommuGroupID
            целое число
            Идентификатор группы IOMMU (число), полученный из /dev/vfio/32, где 32 — это пример.
          • status.nic.pci.binding.mode
            строка
            Текущий режим привязки.

            Допустимые значения: NetDev, Unknown, VFIO-PCI, DPDK

          • status.nic.pci.binding.vfioDeviceFile
            строка
            Файл устройства VFIO, полученный из /dev/vfio/devices/vfio0, где vfio0 — это пример.
        • status.nic.pci.busInfo
          строка
          Информация о PCI шине в формате domain:bus:device.function.
        • status.nic.pci.pf
          объект
          Метаданные, специфичные для Physical Function.
          • status.nic.pci.pf.sriov
            объект
            Конфигурация SR-IOV, наблюдаемая на физической функции.
            • status.nic.pci.pf.sriov.enabled
              булевый
              Включен ли SR-IOV.
            • status.nic.pci.pf.sriov.mac
              строка
              MAC-адрес PF.

              Шаблон: ^([0-9a-f]{2}:){5}[0-9a-f]{2}$

            • status.nic.pci.pf.sriov.mtu
              целое число
              MTU PF.

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

            • status.nic.pci.pf.sriov.numVFs
              целое число
              Количество созданных VF.

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

            • status.nic.pci.pf.sriov.supported
              булевый
              Поддерживается ли SR-IOV.
            • status.nic.pci.pf.sriov.totalVFs
              целое число
              Общее количество доступных VF.

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

            • status.nic.pci.pf.sriov.vlan
              целое число
              VLAN-тег PF.

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

        • status.nic.pci.type
          строка
          Тип PCI функции сетевого адаптера (PF или VF).

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

        • status.nic.pci.vf
          объект
          Метаданные, специфичные для Virtual Function.
          • status.nic.pci.vf.index
            целое число
            Конкретный номер, используемый для идентификации отдельного VF при его выделении.
          • status.nic.pci.vf.mac
            строка
            MAC-адрес VF.

            Шаблон: ^([0-9a-f]{2}:){5}[0-9a-f]{2}$

          • status.nic.pci.vf.mtu
            целое число
            MTU VF.

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

          • status.nic.pci.vf.pfNodeNetworkInterfaceName
            строка
            Имя ресурса NodeNetworkInterface для родительского PF.
          • status.nic.pci.vf.queryRSS
            булевый
            Текущее состояние запроса конфигурации RSS для VF.
          • status.nic.pci.vf.spoofCheck
            булевый
            Текущее состояние проверки подмены MAC-адреса для VF.
          • status.nic.pci.vf.trust
            булевый
            Текущее состояние режима доверия для VF.
          • status.nic.pci.vf.vlan
            целое число
            VLAN-тег VF.

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

      • status.nic.takenOverByPod
        строка
        Имя пода, который в данный момент использует устройство, если таковой имеется.
      • status.nic.vendor
        строка
        Определенный производитель сетевого адаптера на основе PCI vendor ID.

        Допустимые значения: Intel, Mellanox, Other

    • status.observedGeneration
      целое число
      Последнее поколение, обработанное контроллером.
    • status.operationalState
      строка
      Операционное состояние интерфейса.

      Допустимые значения: NotExist, Unknown, NotPresent, Down, LowerLayerDown, Testing, Dormant, Up

    • status.permanentMAC
      строка
      Оригинальный MAC-адрес интерфейса.

SystemNetwork

Короткие имена: snet

Область: Cluster
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

SystemNetwork задаёт дополнительную сервисную сеть на узлах кластера. Описывает, как создать логическую сеть поверх underlay (физический интерфейс или bond) с помощью VLAN, прямого доступа (Access) или SR-IOV виртуальной функции.

  • spec
    объект
    Желаемое состояние SystemNetwork.
    • spec.ipam
      объект
      Конфигурация IPAM для автоматического выделения адресов на узлах.
      • spec.ipam.clusterIPAddressPoolName
        строка

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

        Имя ClusterIPAddressPool, используемого для выделения адресов этой системной сети.
    • spec.sriovVirtualFunction
      объект
      Опциональные настройки SR-IOV виртуальной функции при type равном SRIOVVirtualFunction.
      • spec.sriovVirtualFunction.linkState
        строка

        Состояние канала VF.

        • Auto: следовать состоянию PF.
        • Enable: принудительно поднять канал.
        • Disable: принудительно опустить канал.

        Допустимые значения: Auto, Enable, Disable

      • spec.sriovVirtualFunction.mac
        строка
        MAC-адрес, назначаемый VF.
      • spec.sriovVirtualFunction.mtu
        целое число
        MTU для интерфейса VF; 0 — использовать значение по умолчанию.

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

      • spec.sriovVirtualFunction.queryRSS
        булевый
        Включить опрос состояния RSS (Receive Side Scaling).
      • spec.sriovVirtualFunction.spoofChecking
        булевый
        Включить или отключить проверку подмены MAC/VLAN для VF.
      • spec.sriovVirtualFunction.trust
        булевый
        Включить режим доверия для VF (например для привилегированного трафика).
      • spec.sriovVirtualFunction.vlan
        целое число
        Идентификатор VLAN для VF (0–4094); 0 означает без VLAN.

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

    • spec.type
      строка

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

      Тип подключения к сети.

      • VLAN: создать VLAN под-интерфейс на underlay; требуется .spec.vlan.
      • Access: использовать underlay-интерфейс как есть (без VLAN).
      • SRIOVVirtualFunction: подключение через SR-IOV виртуальную функцию; опционально .spec.sriovVirtualFunction для настройки.

      Допустимые значения: VLAN, Access, SRIOVVirtualFunction

    • spec.underlayNetworkName
      строка

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

      Имя underlay-сети (например NodeNetwork или bond), к которой подключается эта системная сеть.
    • spec.vlan
      объект
      Параметры VLAN; обязательно при type равном VLAN.
      • spec.vlan.id
        целое число

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

        Идентификатор VLAN (1–4094).

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

  • status
    объект
    Наблюдаемое состояние ресурса.
    • status.conditions
      массив объектов
      Условия отражают последние наблюдения за состоянием ресурса.
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.observedGeneration
        целое число
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
        Тип условия.
    • status.nodeAttachementsCount
      целое число
      Общее число привязок к узлам (по одной на подходящий узел) для данной SystemNetwork.
    • status.observedGeneration
      целое число
      Последнее поколение .metadata.generation, наблюдавшееся контроллером.
    • status.readyNodeAttachementsCount
      целое число
      Число привязок к узлам, находящихся в состоянии Ready (настроены и работают).

UnderlayNetwork

Короткие имена: unet

Область: Cluster
Версия: v1alpha1

Доступно в редакциях EE, FE, CSE.

UnderlayNetwork определяет физические сетевые интерфейсы (PF и VF), доступные для прямого подключения к подам через Dynamic Resource Allocation (DRA). Этот ресурс обеспечивает проброс аппаратных устройств для высокопроизводительных рабочих нагрузок, таких как приложения DPDK. Выбранные интерфейсы публикуются как DRA устройства, которые могут быть запрошены подами с использованием шаблонов ResourceClaim.

  • spec
    объект
    • spec.autoBonding
      булевый
      Включает автоматическую группировку интерфейсов, когда несколько PF на одном узле соответствуют селектору. Неизменяемо после установки. В режиме Shared: При включении контроллер группирует одну VF от каждого совпавшего PF в одно DRA устройство. Каждое такое устройство содержит несколько VF (по одной от каждого совпавшего PF), которые предоставляются поду как отдельные сетевые интерфейсы. Количество сгруппированных устройств равно наименьшему количеству VF среди всех совпавших PF. Если группировку собрать невозможно (например, у какого-то PF нет VF), выводится предупреждение и публикация устройств пропускается до тех пор, пока группировка не станет возможной. При отключении каждая VF публикуется как отдельное DRA устройство. В режиме Dedicated: При включении все совпавшие PF на узле группируются в одно DRA устройство, предоставляя поду все PF как отдельные интерфейсы. При отключении каждый PF публикуется как отдельное DRA устройство. Примечание: Это не создает bonding-интерфейсы на уровне ядра внутри пода. Интерфейсы просто пробрасываются как отдельные интерфейсы, позволяя приложениям (например, DPDK) обрабатывать bonding/агрегацию на уровне приложения.

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

    • spec.memberNodeNetworkInterfaces
      массив объектов

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

      Селекторы для ресурсов NodeNetworkInterface, представляющих Physical Functions (PF) сетевых карт, которые будут использоваться для выделения устройств. Должны выбираться только PF интерфейсы (не VF). Контроллер автоматически настроит и будет использовать VF при работе в режиме Shared.
      • spec.memberNodeNetworkInterfaces.labelSelector
        объект
        Селектор лейблов для определения интерфейсов, поверх которых будут настроены виртуальные и физические функции SR IOV.
        • spec.memberNodeNetworkInterfaces.labelSelector.matchLabels
          объект

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

          Набор лейблов, которые должны совпадать с лейблами ресурсов NodeNetworkInterface.
    • spec.mode
      строка
      Режим выделения устройств, определяющий, как физические интерфейсы предоставляются подам. Shared (по умолчанию): Создает Virtual Functions (VF) из выбранных Physical Functions (PF) с использованием SR-IOV, позволяя нескольким подам совместно использовать одно и то же оборудование. Каждый под получает одну или несколько VF. При включенном autoBonding одна VF от каждого совпавшего PF группируется в одно DRA устройство, предоставляя поду несколько интерфейсов (по одному от каждого PF). Dedicated: Предоставляет каждый совпавший PF как эксклюзивное устройство без SR-IOV. При включенном autoBonding все совпавшие PF на узле группируются в одно DRA устройство, предоставляя поду все PF как отдельные интерфейсы. При отключенном autoBonding каждый PF публикуется как отдельное DRA устройство. Подходит для рабочих нагрузок, требующих максимальной производительности, или когда SR-IOV недоступен.

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

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

    • spec.shared
      объект
      Параметры конфигурации для режима Shared. Обязательно, когда mode установлен в “Shared”. В режиме Shared используется SR-IOV для создания Virtual Functions из Physical Functions, позволяя нескольким подам совместно использовать одно и то же сетевое оборудование.
      • spec.shared.sriov
        объект
        Конфигурация SR-IOV для создания Virtual Functions из выбранных Physical Functions. При включении контроллер настраивает SR-IOV на соответствующих PF интерфейсах и создает указанное количество VF на каждый PF. Эти VF затем публикуются как DRA устройства, которые могут быть выделены подам.
        • spec.shared.sriov.enabled
          булевый

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

          Включить SR-IOV на выбранных Physical Functions. При значении true VF будут созданы согласно настройке numVFs.
        • spec.shared.sriov.numVFs
          целое число
          Количество Virtual Functions для создания на каждый Physical Function. Должно быть больше 0, когда enabled равно true. Фактическое количество создаваемых VF может быть ограничено максимальным поддерживаемым оборудованием количеством VF.

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

  • status
    объект
    Текущий статус ресурса UnderlayNetwork, включая состояние конфигурации SR-IOV и доступность устройств.
    • status.conditions
      массив объектов
      Список условий, описывающих текущее состояние ресурса UnderlayNetwork. Включает как минимум условие SRIOVConfigured (указывающее статус конфигурации SR-IOV) и условие InterfacesAvailable (указывающее, готовы ли устройства для выделения).
      • status.conditions.lastTransitionTime
        строка
      • status.conditions.message
        строка
      • status.conditions.observedGeneration
        целое число
      • status.conditions.reason
        строка
      • status.conditions.status
        строка
      • status.conditions.type
        строка
    • status.observedGeneration
      целое число

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

    • status.sriov
      объект
      • status.sriov.enabledNICs
        целое число

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

      • status.sriov.supportedNICs
        целое число

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