Перепланирование маршрутизаторов между L3-агентами

Виртуальный маршрутизатор Neutron обслуживается L3-агентом на одном из узлов региона. Маршрутизатор без включённого режима HA размещается ровно на одном L3-агенте, поэтому при выводе этого узла из эксплуатации маршрутизация через него прекращается до переноса маршрутизатора на другой агент. Маршрутизатор в режиме HA размещается на нескольких агентах и переключается между ними самостоятельно.

Раздел описывает, как определить размещение маршрутизаторов, перенести маршрутизатор на другой L3-агент и проверить состояние маршрутизаторов в режиме HA. Процедура применяется при плановом обслуживании узла, замене узла (см. Замена управляющего узла региона) и при отказе L3-агента.

Важно

Раздел применим к региону с механизмом openvswitch (ML2/OVS), в котором маршрутизацию обслуживают L3-агенты. В регионе с механизмом OVN L3-агенты не используются, и описанные команды неприменимы.

Проверить механизм можно на управляющем узле:

$ sudo grep -E "^mechanism_drivers" /opt/kolla/neutron-server/ml2_conf.ini

mechanism_drivers = openvswitch,l2population

Все команды openstack выполняются из окружения с доступом к API региона (см. Использование OpenStack CLI).

Определение размещения маршрутизаторов

  1. Получите список маршрутизаторов и признак режима HA. Столбец HA со значением False означает, что маршрутизатор размещён на одном L3-агенте:

    $ openstack router list --long -c ID -c Name -c Status -c State -c HA -c Project
    
  2. Определите L3-агенты, обслуживающие конкретный маршрутизатор. Для маршрутизатора без режима HA возвращается один агент, для маршрутизатора в режиме HA — несколько, из которых один находится в состоянии active, остальные — в состоянии standby:

    $ openstack network agent list --router <идентификатор-маршрутизатора> \
        -c ID -c Host -c "HA State" -c Alive -c State
    
  3. Определите маршрутизаторы, размещённые на конкретном узле. Сначала получите идентификатор L3-агента этого узла, затем список его маршрутизаторов:

    $ openstack network agent list --host <имя-узла> --agent-type l3
    $ openstack network agent list --agent-type l3
    

    Список маршрутизаторов конкретного агента:

    $ openstack router list --agent <идентификатор-агента>
    

Примечание

Состояние Alive = False у агента означает, что агент не отправляет heartbeat. Маршрутизаторы такого агента остаются привязанными к нему в базе данных, но не обслуживаются.

Проверка параметров отказоустойчивости

Поведение при отказе агента определяется параметрами в файле /opt/kolla/neutron-server/neutron.conf на управляющих узлах:

Параметр

Значение по умолчанию

Назначение

l3_ha

false

создавать новые маршрутизаторы в режиме HA

max_l3_agents_per_router

3

число агентов для маршрутизатора в режиме HA

allow_automatic_l3agent_failover

false

автоматически переносить маршрутизаторы с отказавшего агента

Проверьте фактические значения:

$ sudo grep -E "^l3_ha|^max_l3_agents_per_router|^allow_automatic_l3agent_failover" \
    /opt/kolla/neutron-server/neutron.conf

Если параметр в файле отсутствует, действует значение по умолчанию.

Важно

При allow_automatic_l3agent_failover = false маршрутизаторы без режима HA не переносятся автоматически — перенос выполняется вручную (см. Перенос маршрутизатора без режима HA). Не рассчитывайте на автоматический перенос, не убедившись в значении параметра.

Перенос маршрутизатора без режима HA

Предупреждение

Перенос маршрутизатора не выполняется бесшовно: пространство имён маршрутизатора создаётся на новом агенте заново, поэтому трафик через маршрутизатор и связанные с ним плавающие IP-адреса будут недоступны в течение нескольких секунд. Выполняйте перенос в согласованное окно обслуживания.

  1. Определите текущий агент маршрутизатора и выберите целевой агент на другом узле (см. Определение размещения маршрутизаторов). Убедитесь, что целевой агент находится в состоянии Alive = True и State = UP.

  2. Удалите маршрутизатор с текущего агента:

    $ openstack network agent remove router --l3 \
        <идентификатор-текущего-агента> <идентификатор-маршрутизатора>
    
  3. Добавьте маршрутизатор на целевой агент:

    $ openstack network agent add router --l3 \
        <идентификатор-целевого-агента> <идентификатор-маршрутизатора>
    
  4. Убедитесь, что маршрутизатор обслуживается целевым агентом:

    $ openstack network agent list --router <идентификатор-маршрутизатора> \
        -c Host -c Alive -c State
    
  5. Проверьте прохождение трафика: доступность плавающих IP-адресов виртуальных машин, подключённых к этому маршрутизатору.

Примечание

Если в регионе включён параметр allow_automatic_l3agent_failover, вместо переноса вручную можно отключить L3-агент выводимого узла и дождаться переноса маршрутизаторов силами Neutron:

$ openstack network agent set --disable <идентификатор-агента>
$ openstack network agent list --router <идентификатор-маршрутизатора>

После обслуживания включите агент обратно:

$ openstack network agent set --enable <идентификатор-агента>

Проверка маршрутизатора в режиме HA

Маршрутизатор в режиме HA переключается между агентами самостоятельно, переносить его не требуется. Тем не менее перед выводом узла из эксплуатации и после его возврата убедитесь в сохранении отказоустойчивости.

  1. Перед выводом узла проверьте, что маршрутизатор обслуживается более чем одним агентом и ровно один из них находится в состоянии active:

    $ openstack network agent list --router <идентификатор-маршрутизатора> \
        -c Host -c "HA State" -c Alive
    

    Предупреждение

    Если маршрутизатор обслуживается только двумя агентами, после вывода одного узла маршрутизатор останется без резерва: отказ второго узла приведёт к потере маршрутизации. Планируйте обслуживание с учётом этого.

  2. После вывода узла убедитесь, что один из оставшихся агентов перешёл в состояние active, а агент выведенного узла имеет состояние Alive = False.

  3. После возврата узла убедитесь, что его агент снова присутствует в списке агентов маршрутизатора в состоянии standby и Alive = True, то есть отказоустойчивость восстановлена.

Примечание

Новый L3-агент не добавляется к существующим маршрутизаторам в режиме HA автоматически, если число агентов маршрутизатора уже достигло значения max_l3_agents_per_router. При необходимости добавьте агент к маршрутизатору вручную:

$ openstack network agent add router --l3 \
    <идентификатор-агента> <идентификатор-маршрутизатора>