Перепланирование маршрутизаторов между 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).
Определение размещения маршрутизаторов¶
Получите список маршрутизаторов и признак режима HA. Столбец
HAсо значениемFalseозначает, что маршрутизатор размещён на одном L3-агенте:$ openstack router list --long -c ID -c Name -c Status -c State -c HA -c Project
Определите L3-агенты, обслуживающие конкретный маршрутизатор. Для маршрутизатора без режима HA возвращается один агент, для маршрутизатора в режиме HA — несколько, из которых один находится в состоянии
active, остальные — в состоянииstandby:$ openstack network agent list --router <идентификатор-маршрутизатора> \ -c ID -c Host -c "HA State" -c Alive -c State
Определите маршрутизаторы, размещённые на конкретном узле. Сначала получите идентификатор 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 на управляющих узлах:
Параметр |
Значение по умолчанию |
Назначение |
|---|---|---|
|
|
создавать новые маршрутизаторы в режиме HA |
|
|
число агентов для маршрутизатора в режиме HA |
|
|
автоматически переносить маршрутизаторы с отказавшего агента |
Проверьте фактические значения:
$ 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-адреса будут недоступны в течение нескольких секунд. Выполняйте перенос в согласованное окно обслуживания.
Определите текущий агент маршрутизатора и выберите целевой агент на другом узле (см. Определение размещения маршрутизаторов). Убедитесь, что целевой агент находится в состоянии
Alive = TrueиState = UP.Удалите маршрутизатор с текущего агента:
$ openstack network agent remove router --l3 \ <идентификатор-текущего-агента> <идентификатор-маршрутизатора>
Добавьте маршрутизатор на целевой агент:
$ openstack network agent add router --l3 \ <идентификатор-целевого-агента> <идентификатор-маршрутизатора>
Убедитесь, что маршрутизатор обслуживается целевым агентом:
$ openstack network agent list --router <идентификатор-маршрутизатора> \ -c Host -c Alive -c State
Проверьте прохождение трафика: доступность плавающих IP-адресов виртуальных машин, подключённых к этому маршрутизатору.
Примечание
Если в регионе включён параметр allow_automatic_l3agent_failover, вместо переноса
вручную можно отключить L3-агент выводимого узла и дождаться переноса маршрутизаторов
силами Neutron:
$ openstack network agent set --disable <идентификатор-агента>
$ openstack network agent list --router <идентификатор-маршрутизатора>
После обслуживания включите агент обратно:
$ openstack network agent set --enable <идентификатор-агента>
Проверка маршрутизатора в режиме HA¶
Маршрутизатор в режиме HA переключается между агентами самостоятельно, переносить его не требуется. Тем не менее перед выводом узла из эксплуатации и после его возврата убедитесь в сохранении отказоустойчивости.
Перед выводом узла проверьте, что маршрутизатор обслуживается более чем одним агентом и ровно один из них находится в состоянии
active:$ openstack network agent list --router <идентификатор-маршрутизатора> \ -c Host -c "HA State" -c Alive
Предупреждение
Если маршрутизатор обслуживается только двумя агентами, после вывода одного узла маршрутизатор останется без резерва: отказ второго узла приведёт к потере маршрутизации. Планируйте обслуживание с учётом этого.
После вывода узла убедитесь, что один из оставшихся агентов перешёл в состояние
active, а агент выведенного узла имеет состояниеAlive = False.После возврата узла убедитесь, что его агент снова присутствует в списке агентов маршрутизатора в состоянии
standbyиAlive = True, то есть отказоустойчивость восстановлена.
Примечание
Новый L3-агент не добавляется к существующим маршрутизаторам в режиме HA
автоматически, если число агентов маршрутизатора уже достигло значения
max_l3_agents_per_router. При необходимости добавьте агент к маршрутизатору
вручную:
$ openstack network agent add router --l3 \
<идентификатор-агента> <идентификатор-маршрутизатора>