Первые тесты переноса виртуальных машин с 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 в выпадающем списке справа;
- Для просмотра подробной информации выберите нужное действие.
