Как создать сеть и управлять ею

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

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

Инструкция не про выдачу адресов конкретной машине и не про исключение адресов из пула — это отдельная тема, см. Пул адресов и адресация ВМ.

Предусловия

• роль Cluster master — для сетей любого типа, включая Routed и Q-in-Q;
• роль vDC admin или выше — для Isolated и GENEVE; Routed и Q-in-Q этой роли недоступны;
• заранее выбранная подсеть: IPv4 с префиксом от /16 до /29;
• для Q-in-Q — оба тега VLAN: внешний и внутренний;
• версия vStack Center — 3.0.4.

Создать сеть

Сеть создаётся сразу целиком: тип, подсеть, шлюз, MTU и теги VLAN задаются в одной форме и после создания не меняются. Менять потом можно только имя.

1. Откройте Provider Data Center → All Networks.

2. Нажмите Add над таблицей — откроется форма создания сети.

   

3. Заполните форму:

   Поле	Что указать
   Type	тип сети: Isolated (выбран по умолчанию), Routed или Q-in-Q
   Name	имя сети
   CIDR	IPv4-подсеть с префиксом от /16 до /29
   Gateway	шлюз по умолчанию — адрес внутри подсети из CIDR. Поле необязательное: если оставить его пустым, адрес подставится сам
   MTU	по умолчанию 1500. Границы кластера показывает подсказка у поля; ниже 1000 и выше 9180 значение не принимается
   VLAN ID	поле появляется для типов Routed и Q-in-Q. Для Q-in-Q это внешний тег (S-VLAN)
   C-VLAN	поле появляется только для Q-in-Q — внутренний тег

4. Нажмите Create a Network. Пока обязательные поля не заполнены или значение в поле не проходит проверку, кнопка остаётся неактивной.

5. Дождитесь, пока сеть появится в таблице All Networks. Создание асинхронное: диспетчер кластера принимает запрос и передаёт его агенту сети, поэтому запись появляется не мгновенно. Пока сеть не подтверждена, назначать её ВЦОД и подключать к ней машины рано.

6. Назначьте сеть виртуальному ЦОД (ВЦОД): откройте ВЦОД → Networks, таб Primary, найдите строку сети и включите переключатель в колонке Assign. Без назначения машины ВЦОД сеть не увидят.

Форма создания собирает сеть с IPv4-подсетью. Сеть с IPv6-подсетью или dual-stack, где машина получает адреса обоих семейств, создаётся программно — методы перечислены в конце страницы.

Если сеть не создалась

Код	Причина	Что делать
-606 «Bad type value»	тип сети не распознан	выберите тип в списке Type
-403 «Access denied»	у роли нет права создавать сеть такого типа	Routed и Q-in-Q создаёт только Cluster master — попросите его
-647 «Empty cidr param value»	поле CIDR осталось пустым	укажите подсеть
-644 «Bad cidr param value»	значение в CIDR не читается как подсеть	проверьте формат: адрес сети и префикс через косую черту
-646 «You've asked too wide network»	префикс в CIDR короче /16	сузьте подсеть; в сообщении указано число бит
-643 «You've asked too narrow network»	префикс в CIDR длиннее /29 — адресов для машин не остаётся	расширьте подсеть
-680 «default_gw param is NULL»	шлюз передан пустым значением	укажите адрес в Gateway или не заполняйте поле вовсе
-681 «default_gw param has bad value»	значение в Gateway не читается как IPv4-адрес	исправьте адрес шлюза
-682 «default_gw value is out of cidr block»	адрес в Gateway вне подсети из CIDR	выберите адрес внутри подсети
-628 «mtu param value is out of acceptable range (1000-9180)»	значение MTU вне допустимого диапазона	задайте значение от 1000 до 9180
-629 «mtu param value exceeds maximal»	MTU выше максимума кластера	уменьшите значение до максимума из подсказки у поля
-609 «Bad mixup of network type and params»	у сети типа Routed поле VLAN ID осталось пустым	заполните VLAN ID
-602 «Bad param value for vlan_id»	номер в VLAN ID вне диапазона, принятого в кластере	согласуйте номер VLAN с администратором сети
-610 «Bad param qinq_id», -611 «qinq_id param value is out of acceptable range»	значение в C-VLAN не читается или вне диапазона	исправьте внутренний тег
-612 «qinq_id param is required for Q-in-Q network type»	для типа Q-in-Q внутренний тег не задан	заполните C-VLAN
-613 «qinq_id is not allowed for this network type»	внутренний тег задан для типа, который его не принимает	смените тип на Q-in-Q либо уберите внутренний тег
-636 «Bad backend param value»	сетевой backend задан отрицательным числом — так бывает только при программном обращении	оставьте значение по умолчанию
-659 «Failed to obtain cluster status while creating network»	состояние кластера недоступно в момент запроса	проверьте состояние кластера и повторите
-617 «Network creation failed»	параметры приняты, но создание не выполнилось	повторите; если повтор не помог, проверьте журналы кластера
-12 «Failed to create network»	форма принята, но агент сети не применил конфигурацию на узлах	проверьте состояние узлов и журналы кластера, затем создайте сеть заново

Проверить, что сеть появилась

1. Откройте Provider Data Center → All Networks. Новая сеть стоит в таблице со своими ID, Type, Name, VLAN ID, MTU, CIDR, Used IP Addresses и Free IP Addresses. Длинный список сузит поле Search in table, а весь список выгружает кнопка CSV.

   

2. Откройте карточку сети и разверните блок General properties. Сверьте CIDR, Gateway, MTU и VLAN ID с тем, что задавали: эти поля показаны только для чтения. Строка Latest changes: показывает, когда сеть меняли последний раз.

3. Проверьте назначение: в разделе ВЦОД → Networks, таб Primary, сеть отмечена переключателем Assign. Список сетей ВЦОД показывает только назначенные ему сети и с учётом прав пользователя.

Изменять и удалять сеть вправе её создатель, а Cluster master — любую сеть независимо от того, кто её создал.

Переименовать сеть

Имя — единственный изменяемый параметр сети. Изменение синхронное: подтверждение приходит сразу.

1. Откройте Provider Data Center → All Networks и перейдите в карточку сети.

2. В блоке General properties впишите новое имя в поле Name. Остальные поля — CIDR, Gateway, MTU, VLAN ID и счётчики адресов — только для чтения.

3. Нажмите Save changes. Пока имя не изменилось, кнопка неактивна.

4. Убедитесь, что новое имя стоит в заголовке карточки и в таблице All Networks.

Имя может быть пустым — тогда сеть опознаётся по своему ID.

Если переименование не прошло

Код	Причина	Что делать
-47301 «No param id»	сеть не опознана: обращение ушло без идентификатора	вернитесь в All Networks и откройте карточку сети заново
-47305 «No params has been provided»	сохранение отправлено без изменённых полей	впишите новое имя, затем сохраняйте
-403 «Access denied»	сеть назначена другому ВЦОД, а создал её другой пользователь	переименуйте её от имени Cluster master
-47306 «Network unknown»	сети с таким идентификатором больше нет — её могли удалить из другой сессии	обновите список All Networks
-78 «Database error»	ошибка базы данных	повторите; если повтор не помог, обратитесь в поддержку

Удалить сеть

Удаление асинхронное: команда уходит агенту сети, результат приходит позже. Cluster master удаляет любую сеть, vDC admin — только созданные им.

1. Отключите от сети все потребители: сетевые интерфейсы виртуальных машин и программно-определяемых маршрутизаторов (Edge). Пока сеть используется, удаление отклоняется.

2. Откройте карточку сети, нажмите Actions и выберите Delete Network. То же действие доступно в строке сети в списке All Networks.

3. Прочитайте предупреждение в диалоге: удаление может затронуть не только текущий ВЦОД, но и весь кластер. Подтвердите кнопкой Delete — или закройте диалог кнопкой Cancel.

4. Дождитесь, пока запись исчезнет из таблицы All Networks. Если сеть осталась в списке, обновите список ещё раз: удаление подтверждает агент сети, а не сам диалог.

Если удаление не прошло

Код	Причина	Что делать
действия Delete Network нет в меню Actions	вы не создатель сети и не Cluster master либо у сети отмечена ошибка жизненного цикла или назначения	действуйте от имени Cluster master; ошибку жизненного цикла разбирайте до удаления
-707 «Network is used still so can't be deleted»	к сети подключены машины или Edge	отключите потребителей и повторите
-403 «Access denied»	сеть назначена другому ВЦОД, а создал её другой пользователь	удаляйте от имени Cluster master
-659 «Failed to obtain cluster status while creating network»	состояние кластера недоступно в момент запроса	проверьте состояние кластера и повторите
-722 «Internal database error»	ошибка базы данных	повторите; если повтор не помог, обратитесь в поддержку
-12 «Failed to delete network»	агент не довёл удаление до конца — сеть могла остаться в конфигурации узлов	проверьте состояние узлов и журналы кластера, затем повторите удаление

См. также

• Сети кластера: типы, dual-stack и пулы адресов — устройство сети и границы параметров.
• Пул адресов и адресация ВМ — что делать после создания сети.

Методы API

Операции этой страницы в API: nets-create, net-list, net-set, nets-delete, vdc-assign-network, vdc-deassign-network — см. Справочник API.