Пул IP-адресов
Диапазон адресов для VIP KubeAPI и Ingress при создании кластера.
Что такое пул IP-адресов
Пул IP-адресов — это диапазон или список IP-адресов, которые могут быть выбраны для назначения в качестве VIP для KubeAPI и VIP для Ingress при создании кластера. Пул упрощает выбор адресов: вместо ручного ввода вы выбираете свободный адрес из выпадающего списка.
Платформа отслеживает, какие адреса уже назначены кластерам, и показывает в списке только свободные адреса.
Зачем нужны
При создании кластера при отсутствии внешних балансировщиков для KubeAPI и Ingress требуются два адреса:
| Адрес | Назначение |
|---|---|
| VIP для KubeAPI | По нему подключаются kubectl, дашборды, CI/CD, кластер управления. Должен быть в той же подсети, что и Control Plane узлы |
| VIP для Ingress | Точка входа для HTTP/HTTPS трафика к приложениям в кластере |
Без пула адреса вводятся вручную. С пулом — выбираются из списка свободных, что снижает риск ошибок и конфликтов.
Для каких провайдеров используются
Пул IP-адресов поддерживается для:
- Shturval v2
- oVirt (zVirt, HostVM, РЕД Виртуализация, ROSA Virtualization)
- VMware vSphere
Для OpenStack, Basis Dynamix, Yandex Cloud, vCloud Director пулы не используются — там применяются внешние балансировщики и адреса задаются на стороне облака.
Как сконфигурировать
Шаг 1: Создать пул
- Перейдите в Провайдеры → Пулы IP-адресов → Добавить пул.
- Укажите имя пула (обязательно).
- Добавьте диапазон адресов (например,
192.168.1.100–192.168.1.120или CIDR). - При необходимости добавьте отдельные IP-адреса или исключите адреса, которые не должны быть доступны в пуле.
- Сохраните конфигурацию.
Шаг 2: Привязать пул к экземпляру провайдера инфраструктуры
- Перейдите в Провайдеры → Конфигурация провайдеров.
- Создайте или отредактируйте экземпляр провайдера (Shturval v2, oVirt(и подобные) или VMware vSphere).
- В настройках экземпляра провайдера выберите пул IP-адресов из выпадающего списка.
- Сохраните экземпляр провайдера.
Один пул можно привязать к нескольким экземплярам провайдеров.
Шаг 3: Проверить доступность
На странице пула отображается статус каждого адреса (свободен / занят). При редактировании можно добавлять диапазоны, менять их или исключать адреса.
Обратите внимание! Статус добавленных адресов появляется постепенно по мере проверки их доступности и обновляется каждые 5 секунд.
В какой момент применяются
Пул применяется на этапе создания кластера, на шаге «Основные данные»:
- Вы выбираете шаблон провайдера (с привязанным пулом).
- Для полей «Адрес API-сервера кластера» и «VIP-адрес для Ingress» появляются выпадающие списки со свободными адресами из пула.
- Вы выбираете два адреса из списка (или вводите вручную, если пула нет или свободных адресов недостаточно).
- При запуске создания кластера платформа назначает выбранные адреса KubeAPI и Ingress.
Совет: Если к шаблону привязан пул, рядом отображается подсказка с количеством свободных адресов.
Важные ограничения
Обратите внимание! Механизм резервирования отсутствует. Пул показывает статус на момент запроса. Возможна ситуация:
- Адрес был свободен при настройке кластера;
- К моменту инициализации создания кластера он уже занят (другой кластер или ручное назначение);
- Развёртывание кластера завершится с ошибкой.
Рекомендации:
- Выделяйте разные подсети для разных экземпляров провайдера инфраструктуры;
- Создавайте пулы с непересекающимися подсетями для разных команд или окружений;
- При одном свободном адресе в пуле его можно выбрать только для Kube API-сервера или только для Ingress — для кластера потребуется минимум два свободных адреса.
Редактирование и удаление
- Редактирование пула — добавление диапазонов, исключение адресов — не влияет на уже назначенные кластерам адреса.
- Удаление пула — не влияет на кластеры, которым уже назначены адреса из этого пула.
- Удаление адреса из пула — если адрес уже назначен кластеру, его удаление из пула не меняет конфигурацию кластера.
Требования к адресам в пуле
- VIP для KubeAPI и VIP для Ingress должны принадлежать той же подсети, что и Control Plane узлы;
- VIP не должны совпадать с IP-адресами узлов кластера.
Подробнее о VIP — в разделе Особенности FQDN или VIP для KubeAPI и Ingress.
Если при создании кластера ошибка связана с пересечением подсетей или сети в целом, см. Проверка пересечения подсетей при создании кластера.