Для улучшения работы сайта мы используем файлы cookies. Оставаясь на сайте, вы соглашаетесь с политикой обработки персональных данных.

Отключение IPv6 на узлах

В статье описаны два варианта отключения IPv6 на узлах Nova. Выберите один вариант по таблице ниже.

1. Выбор варианта

Варианты нельзя совмещать. Если узел загружен с параметром ядра ipv6.disable=1, включить IPv6 на интерфейсе lo через sysctl нельзя. Чтобы перейти от полного отключения IPv6 к варианту с сохранением адреса ::1, сначала удалите параметр из GRUB, обновите конфигурацию GRUB и перезагрузите узел. Только после этого применяйте sysctl.

Таблица 1. Сравнение вариантов отключения IPv6
Вариант Поведение Когда применять Ограничение

Отключение через GRUB

Стек IPv6 полностью отключается на уровне ядра, включая IPv6 на loopback-интерфейсе

Только на новых узлах универсальной установки (UPI) до установки Nova SE v1.2.0 и новее

Приложение, которому нужен IPv6, включая адрес ::1 в контейнере, может не работать

Отключение через sysctl с сохранением IPv6 на lo

IPv6 отключается на внешних интерфейсах узла, на loopback-интерфейсе сохраняется адрес ::1

Для уже развёрнутых кластеров и более ранних версий Nova

Приложения не получают маршрутизируемый IPv6. Сохраняется только локальная совместимость с localhost и ::1

2. Полное отключение IPv6 через GRUB

Этот вариант предназначен только для новых UPI-узлов до установки Nova 1.2.0 и новее.

Выполните действия на каждом узле.

2.1. Добавление параметра ядра

Добавьте параметр ipv6.disable=1 для всех загрузочных записей.

2.1.1. Astra Linux и Debian

  1. Откройте файл /etc/default/grub.

  2. Добавьте ipv6.disable=1 в значение переменной GRUB_CMDLINE_LINUX.

    Если в переменной уже указаны другие параметры ядра, сохраните их и добавьте ipv6.disable=1 через пробел.

    GRUB_CMDLINE_LINUX="ipv6.disable=1"
  3. Обновите конфигурацию GRUB:

    sudo update-grub

2.1.2. Операционные системы семейства RHEL

  1. Добавьте параметр ipv6.disable=1 во все загрузочные записи:

    sudo grubby --update-kernel=ALL --args="ipv6.disable=1"

2.2. Перезагрузка и проверка

  1. Перезагрузите узел:

    sudo reboot
  2. После перезагрузки проверьте, что параметр присутствует в командной строке ядра:

    cat /proc/cmdline
    Пример вывода
    kvm.enable_virt_at_load=0 BOOT_IMAGE=(hd0,gpt2)/vmlinuz-6.12.21-1.red80.x86_64 root=UUID=884de990-4542-4c97-91e0-5b27f5e58805 ro resume=UUID=0169ad66-5fd4-4867-92b9-7dec9271be3c net.ifnames=0 rhgb quiet ipv6.disable=1

После настройки всех узлов переходите к установке Nova SE v1.2.0 и новее.

3. Отключение IPv6 через sysctl

Этот вариант используется для уже развёрнутых кластеров и более ранних версий Nova. IPv6 отключается на внешних интерфейсах узла. На loopback-интерфейсе lo сохраняются адрес и маршрут ::1.

3.1. Сохранение IPv6 на loopback-интерфейсе

Kubernetes формирует для Pod файл /etc/hosts. В нём обычно есть записи:

127.0.0.1 localhost
::1 localhost ip6-localhost ip6-loopback

Если установить net.ipv6.conf.lo.disable_ipv6=1, IPv6-адреса и маршруты на loopback-интерфейсе удаляются. Процесс, который слушает на ::1, не привязывает сокет.

ip -6 route get ::1
Пример вывода
RTNETLINK answers: Network is unreachable
curl -k --noproxy '*' --connect-timeout 3 https://[::1]:6443/readyz
Пример вывода
curl: (7) Failed to connect to ::1 port 6443 after 0 ms: Couldn't connect to server

При создании или пересоздании пользовательских нагрузок проверка допуска через API-сервер по адресу ::1 не выполняется. В Nova новые Pod не создаются. В событиях ресурсов появляются ошибки:

pods "harbor-registry-b4d9dc6-" is forbidden: Get "https://[::1]:6443/api/v1/namespaces/harbor/limitranges": dial tcp [::1]:6443: connect: cannot assign requested address
pods "flask-test-app-64f8899cdb-" is forbidden: Get "https://[::1]:6443/api/v1/namespaces/flask/limitranges": dial tcp [::1]:6443: connect: cannot assign requested address

3.2. Последовательная настройка узлов

Выполняйте настройку по одному узлу.

Перед применением sysctl убедитесь, что узел не загружен с параметром ipv6.disable=1. Если параметр присутствует, сначала удалите его из конфигурации GRUB, обновите конфигурацию GRUB и перезагрузите узел.

  1. Создайте файл /etc/sysctl.d/99-nova-disable-ipv6.conf:

    sudo tee /etc/sysctl.d/99-nova-disable-ipv6.conf <<'EOF'
    net.ipv6.conf.all.disable_ipv6 = 1
    net.ipv6.conf.default.disable_ipv6 = 1
    net.ipv6.conf.lo.disable_ipv6 = 0
    EOF
  2. Примените конфигурацию:

    sudo sysctl --system
  3. Проверьте значения параметров sysctl:

    sysctl net.ipv6.conf.all.disable_ipv6
    sysctl net.ipv6.conf.default.disable_ipv6
    sysctl net.ipv6.conf.lo.disable_ipv6
    Пример вывода
    net.ipv6.conf.all.disable_ipv6 = 1
    net.ipv6.conf.default.disable_ipv6 = 1
    net.ipv6.conf.lo.disable_ipv6 = 0
  4. Проверьте адрес loopback-интерфейса:

    ip -6 addr show dev lo
    Пример вывода
    1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
        inet6 ::1/128 scope host
           valid_lft forever preferred_lft forever

    В выводе присутствует адрес ::1/128.

  5. Проверьте маршрут к ::1:

    ip -6 route get ::1
    Пример вывода
    local ::1 from :: dev lo table local proto kernel src ::1 metric 0 pref medium

    Маршрут проходит через интерфейс lo.

  6. Проверьте адреса IPv6 на всех интерфейсах:

    ip -o -6 addr show
    Пример вывода
    1: lo    inet6 ::1/128 scope host \       valid_lft forever preferred_lft forever

    На внешних и управляющих интерфейсах адресов IPv6 нет.

  7. Перезапустите kubelet на текущем узле:

    sudo systemctl restart kubelet
    sudo systemctl status kubelet
  8. Для кластера в промышленной эксплуатации дождитесь восстановления узла.

    Узел переходит в состояние Ready. Системные Pod возвращаются в штатное состояние.

    kubectl get node <node-name>
    kubectl get pods -A -o wide

    Где <node-name> — имя узла.

  9. После проверки повторите процедуру на остальных узлах кластера.