Синхронизация Jira CMDB#
В разделе Администрирование → Синхронизация доступен тип Сервисы и бизнес-сервисы · Jira CMDB для Jira Data Center / Server. IR только читает Jira; объекты Jira и команды IR не создаются. Нужны права глобального администратора или администратора целевой группы и запущенный планировщик IR.
Настройка и импорт#
- Создайте источник типа Jira CMDB. Укажите группу IR, базовый URL Jira и заголовки авторизации. Заголовки шифруются и не возвращаются в браузер; пустое поле при редактировании сохраняет прежние значения.
- Укажите путь поиска: обычно
/rest/assets/1.0/aql/objects, для старых версий Insight —/rest/insight/1.0/iql/objects. Выберите поддерживаемый сервером параметрqlQueryилиiql. Проверка TLS, разрешённые сети и ограниченные повторы запросов работают как у синхронизации команд. - Задайте отдельные AQL-запросы для сервисов и бизнес-сервисов.
objectType = "System"иobjectType = "Product"— изменяемые примеры. Можно выбирать другие типы, схемы и условия. Выборки не должны пересекаться. Для постраничной загрузки при необходимости задайте стабильную сортировку в AQL. - Сохраните источник и нажмите Загрузить поля и команды. Планировщик загрузит данные; интерфейс покажет ход операции. Каталог при этом не меняется.
- Выберите поле команды-владельца отдельно для каждой выборки. Атрибуты выбираются по ID или точному имени. По умолчанию название берётся из метки объекта. Описание, запасное описание, окружение, критичность и статус жизненного цикла необязательны. После смены поля владельца сохраните настройки и повторно загрузите команды.
- Сопоставьте каждую команду CMDB с существующей активной командой IR в целевой группе. Несколько команд CMDB могут соответствовать одной команде IR. Неразрешённые сопоставления блокируют применение; текущие владельцы не сбрасываются.
- Выберите сторону и атрибут связи. Например,
System.Productвключает сервис в состав бизнес-сервиса. Поддерживаются несколько ссылок и обратное направление связи. - Сохраните настройки, создайте Превью, проверьте изменения и нажмите Применить. После успешного применения выбранное расписание запускается автоматически.
В разделе Сопоставление значений окружения и критичности используются JSON-словари environment_values, criticality_values, business_criticality_values. Для неизвестного значения нужно задать соответствие. Статус жизненного цикла, включая status.name из Assets, сохраняется в metadata.jira_cmdb и не заменяет состояние работоспособности.
Обновления и сохранность данных#
- Объекты определяются по источнику и внешнему ID. Переименование сохраняет объект и его slug.
- Меняются выбранные поля. Локальные политики, каналы, ручной статус, прочие метаданные и вручную созданные связи сохраняются.
- Новые бизнес-сервисы не публикуются. Для несопоставленных полей и новых правил влияния компонентов используются значения IR по умолчанию. Последующие обновления сохраняют локальные настройки влияния компонентов.
- Смена команды сервиса блокируется, пока к нему привязаны ротация, политики или каналы команды. Эти настройки нужно согласовать до переноса.
- Отсутствующие или исключённые фильтром объекты сохраняются. Импортированная связь удаляется только при загрузке обоих объектов и отсутствии ссылки между ними. Ссылки за пределы выборки показываются как предупреждения.
- Смена запросов, полей и сопоставлений требует нового превью. Изменение интервала пересчитывает следующую проверку от момента сохранения без нового превью.
- После успешного импорта нельзя менять группу назначения и базовый URL Jira.
Все страницы загружаются до записи в каталог. Повторяющиеся ID, неполная загрузка, изменение количества объектов, ошибки HTTP, истёкшая блокировка или устаревшее превью прерывают импорт без потери существующих данных. Ошибки записываются в лог без токенов и сырых ответов Jira; повторы по расписанию используют заданный интервал.
Удаление и повторное подключение#
При удалении источника можно оставить или удалить импортированные сервисы и бизнес-сервисы. При сохранении новый источник для того же URL Jira и группы IR привяжет объекты по внешним ID после превью. Удаление затрагивает только созданные источником объекты и их зависимые настройки через обычный механизм удаления IR. Сопоставленные команды IR всегда сохраняются.
API#
Используется /api/admin/directory-sync с config.source_type: "jira_assets". В /options доступен cmdb_preset. POST /{id}/inspect ставит загрузку полей в очередь с текущей revision. Состояние читается через GET /{id}: pending_mode, running, preview_result.attributes, team_catalog, issues, warnings. Для применения необходим действующий preview_token. Прежние источники и права токенов directory-sync:read/write сохраняют совместимость.