Перейти к основному содержимому

Как управлять состоянием и портами Edge

Когда использовать​

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

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

Предусловия​

  • роль Cluster master — для любого маршрутизатора кластера; администратор ВЦОД (виртуального центра обработки данных) — для маршрутизаторов, которые создал сам;
  • удаление подчиняется тому же правилу, что запуск, порты и полоса: на чужой маршрутизатор своего ВЦОД администратор ВЦОД получает -403;
  • для добавления порта — свободный слот (портов не больше четырёх) и остановленная ВМ маршрутизатора;
  • версия vStack Center — 3.0.4.

Маршрутизаторы живут в контексте ВЦОД: в боковом дереве раскройте Virtual Data Centers, выберите ВЦОД и перейдите в его раздел Edges. Строка списка ведёт на страницу маршрутизатора, где собраны состояние, порты и правила. Операции лежат в меню Actions: в строке списка оно собирает их все, а на странице маршрутизатора рядом с UUID — применение правил и удаление. Запуск, остановка и перезапуск на странице маршрутизатора вынесены в кнопки-иконки. Ход асинхронной операции показывает панель журнала — кнопка LOG в нижней панели.

Шаги​

Запуск, остановка и перезапуск​

Три операции переводят маршрутизатор между состояниями и не меняют конфигурацию.

  1. Откройте страницу маршрутизатора. Рядом с UUID стоят три кнопки-иконки — запуск, остановка и перезапуск; подсказка при наведении называет операцию (Start edge, Stop edge, Restart edge). Те же операции лежат в меню Actions строки списка Edges.

  2. Нажмите нужную кнопку и дождитесь смены состояния. Успех панель подтверждает сообщением вида «Edge {id} was successfully started», а поле State рядом с UUID показывает новое состояние. До этого момента состояние маршрутизатора не считается изменённым.

    Страница маршрутизатора: рядом с UUID поле State и кнопки запуска, остановки и перезапуска, ниже секции General properties и Networks

Добавление порта​

Новый порт подключает маршрутизатор к ещё одной сети. Машина при этом должна быть остановлена — на работающем маршрутизаторе операция отклоняется.

  1. Остановите маршрутизатор — кнопкой остановки рядом с UUID либо пунктом Stop edge в меню Actions списка Edges. Дождитесь, пока поле State покажет остановленную машину.

  2. Откройте секцию Networks на странице маршрутизатора и нажмите Add network. Кнопка есть, только пока остались свободные слоты.

  3. Заполните поля строки порта:

    Поле формыОбязательноеЧто задаёт
    NameдаСеть, к которой подключается порт. Под полем показывается CIDR выбранной сети
    SlotдаНомер слота. Список предлагает только свободные значения 1–4
    MBps limitнетОграничение полосы порта в Мбит/с. Пустое поле — без ограничения
    IPнетIPv4-адрес порта. Пустое поле — адрес выделяется из пула сети
    IP guardнетПереключатель IP guard. По умолчанию включён

    Поля для IPv6 в форме нет: если у сети есть IPv6-подсеть, адрес выделяется из неё автоматически. Вручную задать до восьми IPv6-адресов на порт можно только через API — методы собраны в конце страницы.

  4. Нажмите Save network. Панель подтверждает добавление сообщением вида «For edge {id} was successfully added nic», после чего порт появляется в таблице секции Networks.

  5. Запустите маршрутизатор кнопкой запуска рядом с UUID.

Ограничение полосы на порту​

Полоса ограничивается на уже существующем порту, останавливать маршрутизатор для этого не нужно.

  1. В секции Networks найдите строку порта и щёлкните значение в колонке MBps limit — оно правится прямо в таблице.

  2. Введите лимит в Мбит/с и подтвердите правку значком галочки рядом с полем; значок крестика отменяет её. Панель подтверждает новый лимит сообщением «Edge ratelimit was set to {value}».

  3. Чтобы снять ограничение, очистите поле и подтвердите правку: панель ответит «Edge ratelimit was removed».

Удаление порта​

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

  1. Найдите правила, привязанные к этому порту, — в таблицах секций Firewall rules и NAT rules порт показывает колонка Network. Удалите такие правила и примените набор, иначе на маршрутизаторе останутся правила для несуществующего интерфейса.

  2. В секции Networks нажмите значок удаления в строке порта.

  3. Подтвердите удаление в диалоге «Are you sure want to remove …?» кнопкой Remove edge nic. Успех панель подтверждает сообщением вида «Nic of edge {id} was successfully removed».

Удаление маршрутизатора​

Удаление выводит маршрутизатор из эксплуатации целиком: vStack Center удаляет Edge и все его правила (NAT и firewall), а затем сносит ВМ маршрутизатора. Правила удаляются вместе с маршрутизатором, отдельно чистить наборы не нужно.

Операция необратима — сохранённые наборы правил после удаления не восстановить. Если правила понадобятся для нового маршрутизатора, выпишите их из таблиц секций Firewall rules и NAT rules до удаления.

  1. На странице маршрутизатора или в строке списка Edges выберите Actions → Delete Edge.

  2. Подтвердите удаление в диалоге «Are you sure want to remove edge …?» кнопкой Remove.

  3. Дождитесь сообщения «Edge was successfully deleted» — оно приходит после удаления ВМ. Запись маршрутизатора исчезает из списка Edges.

Проверка результата​

Состав портов и состояние проверяются на странице маршрутизатора.

  • Секция Networks — таблица портов с колонками ID, Name, Slot, Port, MAC, IP, IP guard, MBps limit. Проверяйте три признака: удалённого порта в таблице больше нет, у нового порта заполнены сеть и слот, значение в MBps limit совпадает с заданным лимитом.
  • Секция General properties — пары Changed, Ports, Rules applied, State modified, VDC. Поле VM видит только роль Cluster master, у остальных ролей его нет: это ожидаемо и не признак ошибки.
  • Список Edges — колонки UUID, Changed, VDC ID, VDC name, Ports. После удаления маршрутизатора его строки в списке нет вовсе.

Раздел Edges карточки ВЦОД: строка маршрутизатора с колонками UUID, Changed, VDC ID, VDC name и Ports

Если не получилось​

Отказ панель показывает уведомлением с текстом и кодом — например Edge VM must be stopped (error code: -17533).

ОтказПочемуКак обойти
-17533 Edge VM must be stoppedПорт добавляется на работающей машинеОстановите маршрутизатор кнопкой остановки рядом с UUID, дождитесь остановки в поле State и повторите добавление сети
-17535 Slot is occupied or out of rangeСлот занят другим портом либо его номер больше 4Берите слот из списка поля Slot — там только свободные значения 1–4. Занятый слот освобождается только удалением порта
-403 Access deniedМаршрутизатор создал другой пользователь, а прав уровня кластера у роли нетДействуйте владельцем маршрутизатора или ролью Cluster master. Администратор ВЦОД управляет только теми маршрутизаторами, которые создал сам: портами, полосой, состоянием и удалением. Без прав пункты операций в меню Actions не появляются
-17506, -16706, -16606 Edge id doesn't existМаршрутизатор не найден: запись уже удалена либо открыта устаревшая страницаВернитесь в список Edges, обновите его и откройте маршрутизатор заново
-17606 Edge id doesn't exist or has no port_id assignedНе найден либо маршрутизатор, либо портОбновите страницу маршрутизатора и повторите операцию над строкой порта из текущей таблицы секции Networks
-16006 Edge id doesn't existМаршрутизатор уже удалёнОбновите список Edges: строки удалённого маршрутизатора там нет
-25030 The edge feature has not been enabledФункциональность Edge выключена признаком возможности feature.edge в параметрах кластераПопросите включить признак на уровне кластера. Пока он выключен, маршрутизаторы недоступны даже для чтения
-16009 vms-remove relay failedЗапрос не дошёл до агента кластераПроверьте доступность агентов кластера и повторите операцию
-16700, -16600, -17600, -17500, -16008Ошибка базы данных либо неудачная передача агентуПовторите операцию; при повторе отказа проверьте состояние базы и агентов кластера

Если операция висит в незавершённом состоянии, смотрите асинхронная операция долго висит.

См. также​

Методы API​

Операции этой страницы в API: edge-start, edge-stop, edge-restart, edge-add-nic, edge-remove-nic, edge-ratelimit, edge-remove, edge-get, edge-list — см. Справочник API.