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

Управление сетевыми сервисами и виртуализация сетевых функций > Работа с пакетами VNF и PNF > Настройка PNF-дескриптора

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

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

Блок/параметр	Описание
`name`	Имя физической сетевой функции.
`description`	Краткое описание физической сетевой функции.
`description_file`	Имя файла в формате PDF с технической документацией или спецификацией физической сетевой функции. Вам нужно поместить файл в корневую директорию пакета PNF. Пользователи могут просмотреть и скачать файл в веб-интерфейсе оркестратора. Необязательный параметр.
`provider`	Поставщик физической сетевой функции.
`version`	Версия физической сетевой функции.
`external_connections`	Внешние точки подключения физической сетевой функции.
`internal_connections`	Внутренние точки подключения VDU, входящих в состав физической сетевой функции. Необязательный блок.
`configurations`	Скрипты для выполнения действий на различных стадиях работы физической сетевой функции, например при развертывании физической сетевой функции.
`flavours`	Варианты развертывания физической сетевой функции. Вы можете выбрать один из указанных вариантов развертывания физической сетевой функции в веб-интерфейсе оркестратора.
`scaling`	Параметры масштабирования физической сетевой функции. Необязательный блок.
`user_configurations`	Элементы веб-интерфейса оркестратора, которые добавляются в область настройки физической сетевой функции. Необязательный блок.
`backups`	Задания резервного копирования физической сетевой функции. Необязательный блок.

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

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`.
	`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 в составе физической сетевой функции используют одну внешнюю точку подключения.

Пример блока

internal_connections

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


Блок/параметр		Описание
`- name`		Имя внутренней точки подключения.
	`description`	Краткое описание внутренней точки подключения.
	`ip`	IP-адрес внутренней точки подключения. Возможные значения: Значение в формате `XXX.XXX.XXX.XXX`, например: `192.168.110.126` IP-адрес назначается с помощью DHCP через резервирование по MAC-адресу OpenStack-порта. В этом случае IP-адрес его невозможно изменить. `AUTO` – автоматически назначить IP-адрес с помощью внешнего DHCP-сервера или скриптов. Скрипты можно указать в блоке `configurations`.
	`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 в составе физической сетевой функции используют одну внутреннюю точку подключения.

Пример блока

configurations

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


Блок/параметр		Описание
`- name`		Имя скрипта.
	`filename`	Имя файла скрипта или сценария Ansible. Вам нужно поместить скрипт в директорию /scripts пакета PNF.
	`stage`	Стадия работы физической сетевой функции, на которой скрипт запускается. Возможные значения: `initialization` – запустить скрипт при развертывании физической сетевой функции. `termination` – запустить скрипт при удалении физической сетевой функции. `none` – запустить скрипт при изменении значения элемента веб-интерфейса оркестратора из блока `user_configurations` в области настройки физической сетевой функции.
	`executor`	Интерпретатор скрипта. Возможные значения: `ansible`; `expect`; `/bin/sh`; `bin/bash`; `<путь к пользовательскому интерпретатору скрипта>`, например `/user/bin/php`.
	`authentication`	Метод аутентификации VNFM в физической сетевой функции для запуска скриптов. Возможные значения: `key` – аутентифицировать VNFM в физической сетевой функции по ключу, который генерируется при развертывании физической сетевой функции. Вам нужно получить ключ с помощью скрипта, поэтому мы рекомендуем не указывать это значение для первого скрипта. `password` – аутентифицировать VNFM в физической сетевой функции по имени и паролю учетной записи из блока `flavours` → `vdus`.
	`files_path`	Путь к файлам для запуска скриптов с помощью SSH. Вам нужно создать директорию в директории /scripts пакета PNF и поместить в созданную директорию файлы. Файлы будут скопированы на VDU. Необязательный параметр.
	`timeout`	Время ожидания выполнения скрипта в секундах. Если скрипт не выполняется по истечении указанного времени, выполнение прерывается. Отсчет времени начинается в момент запуска скрипта. Этот параметр можно указать, если для параметра `executor` вы указали путь к пользовательскому исполнителю скрипта.

Пример блока

flavours

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


Блок/параметр		Описание
`- name`		Имя варианта развертывания.
	`description`	Краткое описание варианта развертывания.
	`position`	Порядковый номер варианта развертывания. Вариант развертывания с наименьшим порядковым номером имеет наименьшую производительность.
	`management`	Параметры консолей администрирования VDU.
	`vdus`	Параметры VDU.

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


Блок/параметр			Описание
`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-сессии. Необязательный параметр.
	`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`. Необязательный параметр.
	`network_interfaces`			Параметры сетевых интерфейсов.
		`- name`		Имя сетевого интерфейса.
			`type`	Тип сетевого интерфейса. Возможные значения: `data` – сетевой интерфейс для передачи данных. `management` – управляющий сетевой интерфейс, который ссылается на сетевой порт.
			`description`	Краткое описание сетевого интерфейса.
			`connection_point_ref`	Имя внешней точки подключения из блока `external_configurations` для управляющего сетевого интерфейса.
	`auto_healing`			Параметры автоматического восстановления VDU.
		`triggers_set`		Внешние триггеры, при срабатывании которых начинается автоматическое восстановление VDU. Возможные значения: `any` – автоматическое восстановление VDU начинается, если срабатывает любой из указанных внешних триггеров. `all` – автоматическое восстановление VDU начинается, если срабатывают все указанные внешние триггеры. `<имя триггера>` – автоматическое восстановление VDU начинается, если срабатывает указанный внешний триггер.
		`triggers`		Внешние триггеры.
			`- name`	Имя внешнего триггера. Возможные значения: `unreachable`; `scale_up`; `scale_down`.
		`action_set`		Действие, которое выполняется при срабатывании внешнего триггера.
			`- type`	Тип действия. Возможные значения: `reboot` – перезагрузить VDU; `script` – запустить указанный скрипт.
			`configuration_name_ref`	Имя скрипта из блока `configurations`, который запускается при срабатывании внешнего триггера. Этот параметр необходимо указать, если для параметра `- type` вы указали значение `script`.

Пример блока

scaling

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

Параметр

Описание

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`, который запускается после восстановления резервной копии.

Пример блока

Идентификатор статьи: 287355, Последнее изменение: 22 окт. 2024 г.

В начало