Как подключить ВМ к сети
Сетевой интерфейс ВМ в vStack Center — это порт в сети ВЦОД (виртуального центра обработки данных) с собственным слотом, MAC-адресом, адресами IPv4 и IPv6 и лимитом скорости. Слотов, как и у дисков, пять. Порт создаётся вместе с ВМ или добавляется отдельно.
Адреса выделяет vStack Center из пула сети. По умолчанию он берёт свободный IPv4 сам;
конкретный адрес можно назвать явно. Для IPv6 подход тот же, но адреса
перечисляются списком — до восьми на порт, и каждый проверяется по четырём
условиям: формат, принадлежность IPv6-подсети, отсутствие в резерве и
незанятость. Если список не задан, а у сети настроена IPv6-подсеть, vStack Center
выделяет один адрес сам; когда свободных адресов в подсети не осталось, приходит
отказ -3579 «IPv6 IP-pool is depleted».
Каждое семейство адресов отключается отдельно. Если у сети нет подсети нужного семейства, оно считается отключённым независимо от запроса. Такой порт получит адрес только в том семействе, которое у сети настроено.
IP guard — защита от подмены адреса: узел пропускает трафик только с выданного адреса. По умолчанию он включён. Снять его разрешено лишь на изолированных сетях и только субъекту с соответствующими правами.
Добавление и удаление интерфейса требуют остановленной ВМ — сетевые устройства собираются в конфигурации гипервизора при запуске. Лимит скорости, наоборот, меняется на ходу.
Интерфейсы лежат на карточке ВМ в секции «Networks»: таблица со столбцами «ID», «Name», «Slot», «Port», «MAC», «IP», «IP guard», «MBps limit» и кнопка «Add network».
Как добавить интерфейс
Доступ: Cluster master — любая ВМ, обычный пользователь — ВМ своих ВЦОД.
-
Остановите ВМ. У запущенной машины операция отклоняется отказом
-3526«vm id==N must be stopped in order to add nic». -
На карточке ВМ в секции «Networks» нажмите «Add network».
-
Выберите сеть, назначенную ВЦОД машины. Сеть из другого ВЦОД отклоняется отказом
-3562. -
Заполните остальные поля. Без явного слота vStack Center займёт первый свободный:
Поле Значение Сеть сеть ВЦОД машины, обязательна Слот 1–5; если не задан — автовыбор свободного IPv4-адрес конкретный адрес; если не задан — выделение из пула сети MAC-адрес конкретный адрес; если не задан — генерация IPv6-адреса до 8 адресов на порт; если не заданы — выделение одного адреса из IPv6-подсети сети Пропуск семейства адресов отключить IPv4 или IPv6 для этого порта; по умолчанию включены оба «IP guard» включён по умолчанию; снять можно только на изолированных сетях «MBps limit» лимит скорости порта -
Дождитесь, пока интерфейс появится в таблице секции «Networks». Там же видны выданные адреса, MAC и номер порта — номер понадобится, чтобы отличать порты друг от друга при правке лимита и удалении.
Двухсемейный порт
Порт получает IPv6 сам, если у сети настроена IPv6-подсеть. Чтобы задать адреса вместо автовыбора, перечислите их списком.
Чтобы выдать только IPv6, отключите для порта семейство IPv4 — тогда адрес из
IPv4-пула не выделяется и проверки IPv4 не выполняются. Задать при этом
конкретный IPv4-адрес нельзя: такая комбинация отклоняется отказом -3577.
Адреса порта видны в столбце «IP» секции «Networks»: у порта без IPv4 столбец пуст, IPv6-адреса перечисляются все.
Если интерфейс не добавился
| Отказ | Почему | Обход |
|---|---|---|
-3526 vm must be stopped in order to add nic | ВМ запущена | Остановите ВМ |
-3530, -3544 нет свободных слотов | Все пять слотов заняты | Освободите слот |
-3545 Slot N occupied already | Выбранный слот занят | Оставьте слот пустым |
-3542 слот вне диапазона 1..5 | Значение слота недопустимо | Укажите слот из диапазона |
-3562 Network isn't assigned to vdc | Сеть не принадлежит ВЦОД машины | Возьмите сеть этого ВЦОД |
-3563 Disabling ip_guard available on Isolated networks only | IP guard снят на сети другого типа | Оставьте IP guard включённым |
-403 Access denied | Не хватает прав на снятие защиты | Запросите права или оставьте защиту |
-3565 Bad address param | Некорректный IPv4-адрес | Проверьте формат |
-3549 IP-pool of network has been depleted | Свободные адреса в пуле сети кончились | Освободите адреса или расширьте пул сети |
-3550 addr limit reached | Пара ВЦОД↔сеть выбрала свой лимит адресов; свободные адреса в пуле при этом могут ещё оставаться | Поднимите «Addrs limit» этой пары на табе «IP Data» карточки ВЦОД либо освободите порты этого ВЦОД в этой сети |
-3571 IPv6 addresses limit exceeded | Больше 8 адресов IPv6 на порт | Сократите список |
-3572 Bad IPv6 address format | Некорректный IPv6-адрес | Проверьте формат |
-3573 IPv6 address is absent at IP-pool | Адрес вне IPv6-подсети сети | Возьмите адрес из подсети сети |
-3574 IPv6 address is already allocated | Адрес занят | Выберите другой |
-3575 Duplicate IPv6 address in request | Повтор в списке | Уберите дубликат |
-3576 IPv6 address is reserved | Адрес в резерве сети | Выберите адрес вне резерва |
-3577 Network port address conflicts with skip or network IP family | Задан адрес семейства, отключённого для порта | Уберите адрес или включите семейство |
-3579 IPv6 IP-pool is depleted | Свободных адресов в IPv6-подсети сети не осталось | Освободите адреса, расширьте подсеть или отключите IPv6 для порта |
-3508 nic has bad ratelimit_mbits value | Некорректный лимит скорости | Проверьте значение |
Как удалить интерфейс
Удаление тоже требует остановленной ВМ. Остановите машину и удалите нужный порт в секции «Networks» её карточки.
Отказы: -3724 — ВМ запущена, -3723 — версия конфигурации ВМ не поддерживает
удаление интерфейса, -3720 — такого порта у ВМ нет.
Как ограничить скорость порта
Лимит задаётся полем «MBps limit» у нужного порта; нулевое значение снимает
ограничение. Нужна роль в ВЦОД с role_id ≤ 3.
Останавливать ВМ не нужно. У выключенной машины меняется только конфигурация и
лимит применяется сразу; у запущенной значение уходит на узел. Возможен частичный
успех — сообщение «Ratelimit has been set (DB), but agent didn't apply it»:
значение записано, но гипервизор его не принял. Такой лимит применится при
следующем запуске ВМ. Прочие отказы: -7224 — такого порта у ВМ нет, -7223 —
версия конфигурации ВМ равна 3, -7228 — ВМ заблокирована другой операцией.
См. также
- Как создать, удалить и перенести виртуальную машину — как задать сетевые порты сразу при создании машины и почему перенос ВМ в другой ВЦОД упирается в сети
- Как управлять дисками и вычислительными ресурсами ВМ — остальные слоты и лимиты ВМ
Методы API
Операции этой страницы в API: vms-add-nic, vm-remove-nic, vm-ratelimit-nic
— см. Справочник API.