Первые тесты переноса виртуальных машин с vRA7 на vRA8 показали, что мигрированные машины не регистрируются во встроенном IPAM. Использовать его на подсетях, где уже есть VM, не получится, — требуется внешний IPAM. Наш SolarWinds IPAM не имеет готовой интеграции с vRA8, поэтому разработали плагин сами.

• Плагин создавался в соответствии с документацией по разработке пакетов интеграции Creating and DeployingaProvider-specific IPAM Integration Package for VMware Cloud Assembly;
• За основу взят набор инструментов для разработки пакета VMware vRealize Automation Third-Party IPAM SDK;
• Для взаимодействия с SolarWinds IPAM применяется Orion SDK for Python.

Плагин SolarWinds IPAM

v0.7.2

Подготовка к работе

SolarWinds.zip содержит плагин для vRA 8, готовый к установке и работе. В архиве содержится набор модулей Python, которые легко адаптировать под свою среду.

Основные изменения, которые Вам возможно потребуются — это настройка выборки подсетей из IPAM и их параметров для передачи в vRA. За этот функционал отвечает модуль GetIPRanges (./src/SolarWinds_GetIPRanges/source.py).

• функции collect_ranges и get_paginator содержат запросы к IPAM для создания списка и подсчета общего количества подсетей;
• для получения дополнительных данных о подсетях эти запросы потребуется изменить (в комментариях есть образцы запросов с выборкой данных из Custom Properties);
• структура таблиц SolarWinds IPAM может изменяться (наш сервер IPAM — старый, он пережил несколько обновлений, и его набор таблиц отличается от свежего сервера последней версии), проверяйте работу своих запросов в SWQL Studio (входит в Orion SDK);
• в функции collect_ranges можно отредактировать значения возвращаемых в vRA полей.

После редактирования кода необходимо заново собрать дистрибутив плагина. Можно вручную заменить файлы в архиве SolarWinds.zip или можно воспользоваться скриптом _create_package.sh.

Установка и обновление плагина

Установка плагина SolarWinds IPAM:

• Перейдите в Infrastructure -> Connections -> Integrations;
• Нажмите Add Integration и выберите IPAM;
• Зайдите в Manage IPAM Providers и импортируйте плагин из SolarWinds.zip;
• После установки пакета выберите его в поле Provider;
• Заполните все поля формы и нажмите Validate для проверки соединения с сервером IPAM;
• Если видите сообщение «Credentials Validated Successfully«, то нажмите Add для завершения настройки плагина;
• После установки плагин запросит у IPAM список доступных подсетей (SolarWinds_GetIPRanges, запускается автоматически каждые 10 минут);
• Для проверки статуса загрузки подсетей заново откройте настроенный пакет интеграции, результат загрузки отображается в поле Status (первое поле на форме).

Плагин готов к работе. Теперь при настройке нового IP Range (Manage IP Ranges) можно указать тип источника External и выбрать настроенный пакет интеграции.

Обновление плагина:

• Перейдите в Infrastructure -> Connections -> Integrations и откройте подключенный пакет интеграции;
• Зайдите в Manage IPAM Providers и импортируйте архив с новой версией плагина, если название плагина такое же как у одного из установленных, то vRA предложит его обновить;
• Заполните необходимые поля формы, выполните проверку соединения Validate и сохраните изменения.

Просмотр логов выполнения

В процессе настройки и работы плагин SolarWinds IPAM будет выполнять определенные действия: ValidateEndpoint, GetIPRanges, AllocateIP, DeallocateIP. vRA позволяет просматривать лог работы и параметры вызова/выполнения каждого действия:

• Перейдите в Extensibility -> Activity -> Action Runs;
• Выберите All runs в выпадающем списке справа;
• Для просмотра подробной информации выберите нужное действие.

Загрузка плагина

vra-solarwinds-ipam v0.7.2