Настройка VNF-дескриптора

06 мая 2026

ID 266608

Вам нужно указать параметры виртуальной сетевой функции в VNF-дескрипторе в формате YAML или XML, после чего добавить VNF-дескриптор в корневую директорию пакета VNF. VNF-дескриптор имеет следующую структуру:

Блок/параметр

Описание

name

Имя виртуальной сетевой функции.

description

Краткое описание виртуальной сетевой функции.

description_file

Имя файла в формате PDF с технической документацией или спецификацией виртуальной сетевой функции. Вам нужно поместить файл в корневую директорию пакета VNF. Пользователи могут посмотреть и скачать файл в веб-интерфейсе оркестратора.

Необязательный параметр.

provider

Поставщик виртуальной сетевой функции.

version

Версия виртуальной сетевой функции.

external_connections

Внешние точки подключения виртуальной сетевой функции. Вы можете настроить указанные внешние точки подключения виртуальной сетевой функции в веб-интерфейсе оркестратора.

internal_connections

Внутренние точки подключения VDU, входящих в состав виртуальной сетевой функции.

Необязательный блок.

virtual_links

Виртуальные соединения для связи внутренних точек подключения.

Этот блок необходимо указать, если вы указали блок internal_connections.

images

Образы дисков VDU. Вы можете развернуть несколько VDU с помощью одного образа диска VDU.

configurations

Скрипты для выполнения действий на различных стадиях работы виртуальной сетевой функции, например при развертывании виртуальной сетевой функции.

flavours

Варианты развертывания виртуальной сетевой функции. Вы можете выбрать один из указанных вариантов развертывания виртуальной сетевой функции в веб-интерфейсе оркестратора.

scaling

Параметры масштабирования виртуальной сетевой функции.

Необязательный блок.

user_configurations

Элементы веб-интерфейса оркестратора, которые добавляются в область настройки виртуальной сетевой функции.

Необязательный блок.

backups

Задания резервного копирования виртуальной сетевой функции.

Необязательный блок.

Пример VNF-дескриптора

external_connections

Блок external_connections имеет следующую структуру:

Блок/параметр

Описание

- name

Имя внешней точки подключения.

description

Краткое описание внешней точки подключения.

ip

IP-адрес внешней точки подключения. Вам нужно ввести значение в формате XXX.XXX.XXX.XXX, например:

192.168.110.126

mask

Маска подсети внешней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
255.255.255.0

Маска подсети назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае маску подсети невозможно изменить.
AUTO – автоматически назначить маску подсети с помощью внешнего DHCP-сервера или скрипта из блока configurations.
MANUAL – маску подсети требуется указать вручную в веб-интерфейсе оркестратора при настройке внешних точек подключения виртуальной сетевой функции.

gw

IP-адрес шлюза внешней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
192.168.110.126

IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес невозможно изменить.
AUTO – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скрипта из блока configurations.
MANUAL – IP-адрес требуется указать вручную в веб-интерфейсе оркестратора при настройке внешних точек подключения виртуальной сетевой функции.

Необязательный параметр.

dns

IP-адрес DNS-сервера внешней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
192.168.110.126

IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес невозможно изменить.
AUTO – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скрипта из блока configurations.
MANUAL – IP-адрес требуется указать вручную в веб-интерфейсе оркестратора при настройке внешних точек подключения виртуальной сетевой функции.

Необязательный параметр.

group

Группа, к которой относится внешняя точка подключения.

Этот параметр необходимо указать, если несколько VDU в составе виртуальной сетевой функции используют одну внешнюю точку подключения.

Пример блока

internal_connections

Блок internal_connections имеет следующую структуру:

Блок/параметр

Описание

- name

Имя внутренней точки подключения.

description

Краткое описание внутренней точки подключения.

virtual_link_name

Имя виртуального соединения из блока virtual_links для внутренней точки подключения.

ip

IP-адрес внутренней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
192.168.110.126

IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес невозможно изменить.
AUTO – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скрипта из блока configurations.
MANUAL – IP-адрес требуется указать вручную в веб-интерфейсе оркестратора при настройке внешних точек подключения виртуальной сетевой функции.

mask

Маска подсети внутренней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
255.255.255.0

Маска подсети назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае маску подсети невозможно изменить.
AUTO – автоматически назначить маску подсети с помощью внешнего DHCP-сервера или скрипта из блока configurations.

gw

IP-адрес шлюза внутренней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
192.168.110.126

IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес невозможно изменить.
AUTO – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скрипта из блока configurations.

Необязательный параметр.

dns

IP-адрес DNS-сервера внутренней точки подключения. Возможные значения:

Значение в формате XXX.XXX.XXX.XXX, например:
192.168.110.126

IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес невозможно изменить.
AUTO – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скрипта из блока configurations.

Необязательный параметр.

group

Группа, к которой относится внутренняя точка подключения.

Этот параметр необходимо указать, если несколько VDU в составе виртуальной сетевой функции используют одну внутреннюю точку подключения.

Пример блока

virtual_links

Блок virtual_links имеет следующую структуру:

Блок/параметр

Описание

- name

Имя виртуального соединения.

cidr

IPv4-префикс виртуального соединения. Вам нужно ввести значение в формате XXX.XXX.XXX.XXX/XX, например:

192.168.2.0/24

ip_version

Версия IP-адресов в подсети. Возможные значения:

v4;
v6.

Пример блока

images

Блок images имеет следующую структуру:

Блок/параметр

Описание

- name

Имя образа диска VDU.

container_format

Формат контейнера для образа диска VDU.

disk_format

Формат образа диска VDU.

type

Тип VIM.

file_name

Имя файла образа диска VDU. Вам нужно поместить образ диска VDU в директорию /image пакета VNF.

Пример блока

configurations

Блок configurations имеет следующую структуру:

Блок/параметр

Описание

- name

Имя скрипта.

filename

Имя файла скрипта, сценария Ansible или атрибута user-data для Cloud-init. Вам нужно поместить скрипт в директорию /scripts пакета VNF.

stage

Стадия работы виртуальной сетевой функции, на которой скрипт запускается. Возможные значения:

initialization – запустить скрипт при развертывании виртуальной сетевой функции.
termination – запустить скрипт при удалении виртуальной сетевой функции.
none – запустить скрипт при изменении значения элемента веб-интерфейса оркестратора из блока user_configurations в области настройки виртуальной сетевой функции.

executor

Интерпретатор скрипта. Возможные значения:

ansible;
expect;
/bin/sh;
bin/bash;
cloud-init;
<путь к пользовательскому интерпретатору скрипта>, например /usr/bin/php.

authentication

Метод аутентификации VNFM в виртуальной сетевой функции для запуска скриптов. Возможные значения:

key – аутентифицировать VNFM в виртуальной сетевой функции по ключу, который генерируется при развертывании виртуальной сетевой функции. Вам нужно получить ключ с помощью скрипта, поэтому мы рекомендуем не указывать это значение для первого скрипта.
password – аутентифицировать VNFM в виртуальной сетевой функции по имени и паролю учетной записи из блока flavours → vdus.

files_path

Путь к файлам для запуска скриптов с помощью SSH. Вам нужно создать директорию в директории /scripts пакета VNF и поместить в созданную директорию файлы. Файлы будут скопированы на VDU.

Необязательный параметр.

config_drive

Использование config-drive. Возможные значения:

true;
false.

Этот параметр можно указать, если для параметра executor вы указали значение cloud_init.

timeout

Время ожидания выполнения скрипта в секундах. Если скрипт не выполняется по истечении указанного времени, выполнение прерывается. Отсчет времени начинается в момент запуска скрипта.

Этот параметр можно указать, если для параметра executor вы указали путь к пользовательскому исполнителю скрипта.

Пример блока

flavours

Блок flavours имеет следующую структуру:

Блок/параметр

Описание

- name

Имя варианта развертывания.

description

Краткое описание варианта развертывания.

position

Порядковый номер варианта развертывания. Вариант развертывания с наименьшим порядковым номером имеет наименьшую производительность.

affinity

Группы VDU, которые размещаются на одном хосте OpenStack. Мы рекомендуем разместить на одном хосте OpenStack VDU, требующие минимальных задержек при обмене информацией друг с другом.

anti-affinity

Группы VDU, которые размещаются на разных хостах OpenStack. Мы рекомендуем развернуть на разных хостах OpenStack VDU, для которых может потребоваться вертикальное масштабирование или обеспечение отказоустойчивости.

management

Параметры консолей администрирования VDU.

vdus

Параметры VDU.

Блоки affinity и anti-affinity имеют следующую структуру:

Блок/параметр

Описание

groups

Группы VDU.

- name

Имя группы VDU.

vdu_name

Имена VDU. Вам нужно указать список значений, например:

vdu_name:

- VDU_1

- VDU_2

Блок management имеет следующую структуру:

Блок/параметр

Описание

vnc

Параметры управления VDU с помощью VNC-консоли.

- vdu_name

Имя VDU.

ssh

Параметры управления VDU с помощью SSH-консоли.

- vdu_name

Имя VDU.

def_user

Имя учетной записи для установки SSH-сессии.

authentication

Метод аутентификации VNFM в виртуальной сетевой функции для запуска скриптов. Возможные значения:

key – аутентифицировать VNFM в виртуальной сетевой функции по ключу, который генерируется при развертывании виртуальной сетевой функции. Вам нужно получить ключ с помощью скрипта из блока configurations.
password – аутентифицировать VNFM в виртуальной сетевой функции по имени и паролю учетной записи из блока vdus.

web

Параметры управления VDU с помощью веб-консоли.

- vdu_name

Имя VDU.

protocol

Протокол подключения к веб-консоли. Возможные значения:

http;
https.

port

Порт подключения к веб-консоли. Вам нужно ввести значение в диапазоне от 1 до 65 536. По умолчанию используется порт 80.

path

Путь к веб-консоли.

def_user

Имя учетной записи для аутентификации в веб-консоли.

def_password

Пароль учетной записи для аутентификации в веб-консоли.

Блок vdus имеет следующую структуру:

Блок/параметр

Описание

- name

Имя VDU.

password_rules

Требования к паролю VDU. Необязательный блок.

length

Минимальная длина пароля.

use_upper_case

Пользователи должны использовать прописные символы в пароле. Возможные значения:

true;
false.

use_lower_case

Пользователи должны использовать строчные символы в пароле. Возможные значения:

true;
false.

use_digits

Пользователи должны использовать цифры в пароле. Возможные значения:

true;
false.

specific_symbols

Специальные символы, которые пользователи должны использовать в пароле, например:

@"!

specific_symbols_min_usage

Минимальное количество специальных символов в пароле.

check_connection_mode

Тип проверки доступности VDU при развертывании. По умолчанию используется SSH-проверка. Возможные значения:

ssh;
none.

Необязательный параметр.

zabbix_template

Имя шаблона Zabbix для VDU.

monitoring_type

Тип мониторинга виртуальной сетевой функции. Возможные значения:

agent – мониторинг с помощью Zabbix-агента.
snmp – мониторинг с помощью протокола SNMP.

ssh_port

Номер порта для установки SSH-сессии.

Необязательный параметр.

ssh_host_key_algorithm

Используемый алгоритм ключа хоста (англ. host key algorithm). Возможные значения:

ssh-rsa.
ssh-ed25519. Мы рекомендуем использовать этот алгоритм хоста ключа, так как он является криптостойким.

Если вы не указываете этот параметр, по умолчанию используется алгоритм ssh-rsa для обеспечения обратной совместимости.

configurations

Имена скриптов из блока configurations, которые запускаются на VDU. Вам нужно указать список значений, например:

vdu_name:

- config_1

- config_2

backups

Имена заданий резервного копирования из блока backups, которые используются на VDU. Вам нужно указать список значений, например:

vdu_name:

- backup_1

- backup_2

Необязательный блок.

def_user

Имя учетной записи для аутентификации VNFM в виртуальной сетевой функции.

Необязательный параметр.

def_password

Пароль учетной записи для аутентификации VNFM в виртуальной сетевой функции.

Необязательный параметр.

password_authentication

Аутентификация VNFM в виртуальной сетевой функции по паролю. Возможные значения:

yes;
no.

Необязательный параметр.

disks

Параметры виртуальных дисков VDU.

- name

Имя виртуального диска VDU.

order

Порядок подключения виртуального диска VDU.

type

Тип эфемерного диска OpenStack.

image

Имя образа виртуального диска VDU из блока images.

Необязательный параметр, если вы создаете пустой диск VDU.

storage_db

Размер виртуального диска VDU в гигабайтах.

cpu

Параметры процессора VDU.

smt

Требования к одновременной гиперпоточности (англ. simultaneous multithreading) при развертывании VDU. Возможные значения:

prefer – использовать одновременную гиперпоточность, если она включена на хосте VDU.
isolate – не использовать одновременную гиперпоточность.
require – использовать одновременную гиперпоточность.

cpu_pinning

Использование привязки процессора (англ. CPU pinning). Возможные значения:

shared – не привязывать ядра процессора к VDU.
dedicated – привязывать ядра процессора к VDU.

num_vpu

Количество привязываемых к VDU ядер процессора.

memory

Параметры оперативной памяти VDU.

total_memory_mb

Количество оперативной памяти VDU в мегабайтах.

page_size

Размер страниц памяти при развертывании VDU. Возможные значения:

small – 4 КБ.
large – 2 МБ или 1 ГБ.
any – любой размер.
4KB.
2MB.
2048.
1GB.

network_interfaces

Параметры сетевых интерфейсов.

- name

Имя сетевого интерфейса.

type

Тип сетевого интерфейса. Возможные значения:

data – сетевой интерфейс для передачи данных.
management – управляющий сетевой интерфейс, который ссылается на сетевой порт.

description

Краткое описание сетевого интерфейса.

connection_point_ref

Имя внешней точки подключения из блока external_connections для управляющего сетевого интерфейса.

port_security

Использование функции Port security. Возможные значения:

disabled;
enabled.

Необязательный параметр.

properties

Дополнительные параметры сетевого интерфейса.

vnic_type

vNIC-тип сетевого интерфейса. Возможные значения:

virtio;
direct;
macvtap;
vhost.

auto_healing

Параметры автоматического восстановления VDU.

triggers_set

Внешние триггеры, при срабатывании которых начинается автоматическое восстановление VDU. Возможные значения:

any – автоматическое восстановление VDU начинается, если срабатывает любой из указанных внешних триггеров.
all – автоматическое восстановление VDU начинается, если срабатывают все указанные внешние триггеры.
<имя триггера> – автоматическое восстановление VDU начинается, если срабатывает указанный внешний триггер.

triggers

Внешние триггеры.

- name

Имя внешнего триггера. Возможные значения:

unreachable;
scale_up;
scale_down.

action_set

Действие, которое выполняется при срабатывании внешнего триггера.

- type

Тип действия. Возможные значения:

reprovision – повторно развернуть VDU;
reboot – перезагрузить VDU;
script – запустить указанный скрипт.

configuration_name_ref

Имя скрипта из блока configurations, который запускается при срабатывании внешнего триггера.

Этот параметр необходимо указать, если для параметра - type вы указали значение script.

bootstrap_timeout

Время ожидания доступности по SSH при развертывании VDU в секундах. Если VDU не доступна по SSH по истечении указанного времени, происходит откат развертывания.

Необязательный параметр.

Пример блока

scaling

Блок scaling имеет следующую структуру:

Параметр

Описание

scale_in_status

Горизонтальное масштабирование до варианта развертывания с более низким порядковым номером. Возможные значения:

permit;
deny.

scale_out_status

Горизонтальное масштабирование до варианта развертывания с более высоким порядковым номером. Возможные значения:

permit;
deny.

scale_up_status

Вертикальное масштабирование до варианта развертывания с более низким порядковым номером. Возможные значения:

permit;
deny.

scale_down_status

Вертикальное масштабирование до варианта развертывания с более высоким порядковым номером. Возможные значения:

permit;
deny.

Пример блока

user_configurations

Блок user_configurations имеет следующую структуру:

Блок/параметр

Описание

tab

Вкладки, которые добавляются в область настройки виртуальной сетевой функции.

- name

Имя вкладки.

variables

Элементы веб-интерфейса оркестратора, которые отображаются на вкладке.

- name

Имя элемента веб-интерфейса оркестратора.

description

Краткое описание элемента веб-интерфейса оркестратора.

input_type

Тип элемента веб-интерфейса оркестратора. Возможные значения:

input – поле.
dropdown – раскрывающийся список.

default_value

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

Этот параметр можно указать, если для параметра input_type вы указали значение input.

values

Значения, которые отображаются в раскрывающемся списке.

Этот блок можно указать, если для параметра input_type вы указали значение dropdown.

- value

Имя значения.

is_default

Значение по умолчанию. Возможные значения:

true;
false.

Необязательный параметр.

required

Обязательный элемент веб-интерфейса оркестратора. Возможные значения:

true;
false.

Необязательный параметр.

type

Тип значения, которое может быть указано для элемента веб-интерфейса оркестратора.

Необязательный параметр.

example

Подсказка, которая отображается при изменении значения элемента веб-интерфейса оркестратора.

Необязательный параметр.

update_configuration_name

Имена скриптов из блока configurations, которые запускаются при изменении значения элемента веб-интерфейса оркестратора. Вам нужно указать список значений, например:

update_configuration_name:

- config_1

- config_2

Пример блока

backups

Блок backups имеет следующую структуру:

Блок/параметр

Описание

- name

Имя задания резервного копирования.

description

Краткое описание задания резервного копирования.

backup

Параметры резервного копирования.

path

Путь к директории виртуальной сетевой функции, в которой содержатся файлы для резервного копирования.

interval

Интервал времени в секундах для резервного копирования.

store_config

Количество хранимых резервных копий.

backup_type

Тип резервного копирования.

authentication

Метод аутентификации VNFM в виртуальной сетевой функции для запуска скриптов. Возможные значения:

key – аутентифицировать VNFM в виртуальной сетевой функции по ключу, который генерируется при развертывании виртуальной сетевой функции. Вам нужно получить ключ с помощью скрипта из блока configurations.
password – аутентифицировать VNFM в виртуальной сетевой функции по имени и паролю учетной записи из блока flavours → vdus.

configuration_name_ref

Имя скрипта из блока configurations, который запускается перед резервным копированием.

restore

Параметры восстановления из резервной копии.

path

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

backup_type

Тип резервного копирования.

authentication

Метод аутентификации VNFM в виртуальной сетевой функции для запуска скриптов. Возможные значения:

key – аутентифицировать VNFM в виртуальной сетевой функции по ключу, который генерируется при развертывании виртуальной сетевой функции. Вам нужно получить ключ с помощью скрипта из блока configurations.
password – аутентифицировать VNFM в виртуальной сетевой функции по имени и паролю учетной записи из блока flavours → vdus.

configuration_name_ref

Имя скрипта из блока configurations, который запускается после восстановления резервной копии.

Пример блока

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!