Настройки | metallb

Доступно с ограничениями в редакциях: Core, SE, SE+, Certified Core/CSE Lite (1.73)

Доступно без ограничений в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)

Входит с ограничениями в расширения: Продвинутые сетевые возможности

Стадия жизненного цикла модуля: General Availability

В модуле реализовано 7 алертов.

Модуль не включен по умолчанию в каком-либо наборе модулей.

Как явно включить или отключить модуль...

Явно включить или выключить модуль можно одним из следующих способов:

С помощью веб-интерфейса Deckhouse. В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль metallb, включите (или выключите) переключатель «Модуль включен». Сохраните изменения.

Пример:
С помощью Deckhouse CLI (d8).

Используйте команду d8 system module enable для включения модуля, или d8 system module disable для выключения модуля (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

Пример включения модуля metallb:
```
d8 system module enable metallb
```
С помощью ModuleConfig metallb.

Установите spec.enabled в true или false в ModuleConfig metallb (создайте его, при необходимости).

Пример манифеста для включения модуля metallb:
```
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: metallb
spec:
  enabled: true
```

Как настроить модуль...

Настроить модуль можно одним из следующих способов:

С помощью веб-интерфейса Deckhouse.

В разделе «Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль metallb, включите переключатель «Дополнительные настройки». Заполните необходимые поля формы на вкладке «Конфигурация», или укажите настройки модуля в формате YAML на вкладке «YAML», не включая секцию settings. Сохраните изменения.

Пример:

Вы также можете отредактировать объект ModuleConfig metallb на вкладке «YAML» в окне настроек модуля («Система» → «Управление системой» → «Deckhouse» → «Модули», откройте модуль metallb), указав версию схемы в параметре spec.version и необходимые параметры модуля в секции spec.settings.
С помощью Deckhouse CLI (d8) (требуется Deckhouse CLI (d8), настроенный на работу с кластером).

Отредактируйте существующий ModuleConfig metallb (подробнее о настройке Deckhouse читайте в документации), выполнив следующую команду:
```
d8 k edit mc metallb
```
Внесите необходимые изменения в секцию spec.settings. При необходимости укажите версию схемы в параметре spec.version. Сохраните изменения.

Вы также можете создать файл манифеста ModuleConfig metallb, используя пример ниже. Заполните секцию spec.settings необходимыми параметрами модуля. При необходимости укажите версию схемы в параметре spec.version.

Примените манифест с помощью следующей команды (укажите имя файла манифеста):
```
d8 k apply -f <FILENAME>
```
Пример файла манифеста ModuleConfig metallb:
```
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: metallb
spec:
  version: 3
  enabled: true
  settings: # Параметры модуля из раздела "Параметры" ниже.
```

Конверсии

Модуль настраивается с помощью ресурса ModuleConfig, схема которого содержит номер версии. При применении в кластере старой версии схемы ModuleConfig выполняются автоматические преобразования. Чтобы обновить версию схемы ModuleConfig вручную, необходимо последовательно для каждой версии выполнить следующие действия :

Обновление из версии 1 в 2:
Удалите все элементы addressPool с протоколом layer2.
Обновление из версии 2 в 3:
Настройки пулов и BGP вынесены в отдельные Custom Resources. Пожалуйста, удалите следующие поля из ModuleConfig metallb:
- .settings.addressPools
- .settings.bgpPeers
- .settings.bgpCommunities

Параметры

Версия схемы: 3

Пример:

nodeSelector:
  node-role.deckhouse.io/control-plane: ''

settings
объект
- settings.addressPools
  Параметр устарел
  массив объектов
  Список диапазонов IP, которые будут выдаваться сервисам.
  
  Формат — массив, как у оригинального MetalLB.
  
  По умолчанию: []
  - settings.addressPools.addresses
    массив строк
    Обязательный параметр
    Список диапазонов, где диапазон — это либо подсеть с маской, либо диапазон значений с “-“ в качестве разделителя.
  - settings.addressPools.auto-assign
    булевый
    Флаг auto-assign используется для предотвращения автоматического выделения IP из пула.
    
    По умолчанию: true
  - settings.addressPools.avoid-buggy-ips
    булевый
    Запрещает использование адресов из пула, заканчивающихся на .0 и .255.
    
    По умолчанию: false
  - settings.addressPools.bgp-advertisements
    массив объектов
    Определяет BGP advertisements.
    - settings.addressPools.bgp-advertisements.aggregation-length
      целочисленный
      Опция aggregation-length позволяет «свернуть» префикс в более крупный.
      
      Работает для адресов IPv4.
      
      По умолчанию: 32
      Допустимые значения: 1 <= X
    - settings.addressPools.bgp-advertisements.communities
      массив строк
      BGP communities, связанные с анонсом. Каждый элемент — это ключ из параметра bgpCommunities.
      
      Пример:
      communities: - no-advertise
    - settings.addressPools.bgp-advertisements.localpref
      целочисленный
      Атрибут BGP LOCAL_PREF используется алгоритмом BGP best path.
      
      Путь с более высоким localpref предпочтительнее пути с более низким localpref.
  - settings.addressPools.name
    строка
    Обязательный параметр
    Имя пула. Должно соответствовать RFC 1123: разделенные точками части в нижнем регистре, состоящие из букв и ‘-‘. Каждое имя должно начинаться и заканчиваться буквой алфавита.
    
    Шаблон: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$
  - settings.addressPools.protocol
    строка
    Обязательный параметр
    Технология публикации сервисов, которую должен реализовать speaker.
    
    Допустимые значения: bgp, layer2
- settings.bgpCommunities
  Параметр устарел
  объект
  Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)
  Список BGP communities.
  
  Пример:
  bgpCommunities: no-advertise: 65535:65282
- settings.bgpPeers
  Параметр устарел
  массив объектов
  Доступно в редакциях: Ultimate/EE, Certified Pro/CSE Pro (1.73)
  Список внешних BGP-роутеров, которые будут работать с этим модулем.
  
  Формат — массив, как у оригинального MetalLB.
  
  По умолчанию: []
  - settings.bgpPeers.hold-time
    строка или число
    Таймаут, после которого партнерский BGP-пир считается утерянным. Это значение делится на 3 и получается интервал для keep-alive.
    
    Рекомендуемое значение — 3s (keep-alive раз в секунду), протокол BGP не поддерживает меньшие значения. По умолчанию — 90s (keep-alive раз в 30 секунд).
    
    Шаблон: ^(0|(([0-9]+)y)?(([0-9]+)w)?(([0-9]+)d)?(([0-9]+)h)?(([0-9]+)m)?(([0-9]+)s)?(([0-9]+)ms)?)$
  - settings.bgpPeers.my-asn
    целочисленный
    Обязательный параметр
    Номер автономной системы для кластера.
    
    Допустимые значения: 0 <= X <= 4294967295
  - settings.bgpPeers.node-selector
    объект
    Дополнительный псевдоселектор, который реализуется приложением speaker’а. Говорит о том, с каких узлов стоит устанавливать связь с внешними BGP-роутерами. Не путать с speaker.nodeSelector и nodeSelector.
    
    Опциональный параметр.
    
    Формат — matchLabels или matchExpressions.
    - settings.bgpPeers.node-selector.matchExpressions
      массив объектов
      - settings.bgpPeers.node-selector.matchExpressions.key
        строка
      - settings.bgpPeers.node-selector.matchExpressions.operator
        строка
      - settings.bgpPeers.node-selector.matchExpressions.values
        массив строк
    - settings.bgpPeers.node-selector.matchLabels
      объект
  - settings.bgpPeers.password
    строка
    Пароль аутентификации для BGP-маршрутизаторов, использующих TCP MD5-аутентифицированные сессии.
  - settings.bgpPeers.peer-address
    строка
    Обязательный параметр
    IP внешнего BGP-роутера.
    
    Шаблон: ^([0-9]{1,3}\.){3}[0-9]{1,3}$
  - settings.bgpPeers.peer-asn
    целочисленный
    Обязательный параметр
    Номер автономной системы на внешнем BGP-роутере.
    
    Допустимые значения: 0 <= X <= 4294967295
  - settings.bgpPeers.peer-port
    целочисленный
    Порт, к которому устанавливать сессию.
    
    По умолчанию: 179
    Допустимые значения: 0 <= X <= 16384
  - settings.bgpPeers.router-id
    строка
    ID BGP-роутера для анонса.
  - settings.bgpPeers.source-address
    строка
    IP-адрес для исходящих соединений.
    
    Шаблон: ^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$
- settings.loadBalancerClass
  строка
  Необязательное поле, описывающее класс LoadBalancer. Поле LoadBalancerClass следует использовать в режиме L2 LoadBalancer для указания MetalLoadBalancerClass, задающего параметры балансировщика для Service.
- settings.nodeSelector
  объект
  Селектор узлов, на которых будет работать главный контроллер. Структура, аналогичная параметру spec.nodeSelector пода Kubernetes.
  
  Если значение не указано или указано false, будет использоваться автоматика.
- settings.speaker
  Параметр устарел
  объект
  Настройки для компонента speaker, который реализует протокол публикации IP-адресов LoadBalancer’а для внешней инфраструктуры.
  - settings.speaker.nodeSelector
    Параметр устарел
    объект
    Селектор узлов, на которых будет работать DaemonSet speaker. Структура, аналогичная параметру spec.nodeSelector пода Kubernetes.
    
    Если значение не указано или указано false, будет использоваться автоматика.
  - settings.speaker.tolerations
    массив объектов
    Структура для DaemonSet speaker’а, аналогичная параметру spec.tolerations пода Kubernetes.
    
    Если значение не указано или указано false, будет использоваться автоматика.
    - settings.speaker.tolerations.effect
      строка
    - settings.speaker.tolerations.key
      строка
    - settings.speaker.tolerations.operator
      строка
    - settings.speaker.tolerations.tolerationSeconds
      целочисленный
    - settings.speaker.tolerations.value
      строка
- settings.tolerations
  массив объектов
  Структура, аналогичная параметру spec.tolerations пода Kubernetes для главного контроллера.
  
  Если значение не указано или указано false, будет использоваться автоматика.
  - settings.tolerations.effect
    строка
  - settings.tolerations.key
    строка
  - settings.tolerations.operator
    строка
  - settings.tolerations.tolerationSeconds
    целочисленный
  - settings.tolerations.value
    строка

Модуль metallb: настройки

Конверсии

Параметры

Произошла ошибка

Расскажите, что не понравилось.

Модуль metallb: настройки

Конверсии

Параметры

Произошла ошибка

Расскажите, что не понравилось.

Запросить пробный доступ

Запрос получен

Ошибка

Связаться со специалистом Deckhouse

Заявка отправлена

Возникла ошибка отправки формы

Запросить обучение

Запрос получен

Ошибка

Запросить демо

Запрос получен

Ошибка

Получите отчет о соответствии рекомендациям PCI SSC

Спасибо

Ошибка

Запросить подробности партнёрской программы

Запрос получен

Ошибка