Инструкция описывает вывод виджета «GitLab. Пайплайны» на вкладке «Пайплайны» карточки микросервиса. Виджет показывает пайплайны репозитория того микросервиса, карточка которого открыта.
Один виджет обслуживает все микросервисы: идентификатор проекта GitLab виджет получает из контекста карточки, а не из собственной конфигурации.
Перед началом работы
Для выполнения инструкции подготовьте:
- разрешения на создание виджетов и разрешение
update:home-mapping-sets; - внешний сервис GitLab;
- у сущностей микросервисов — параметр с числовым ID проекта GitLab, сопоставленный роли
microservice_gitlab_project_id. В каноничной модели каталога это параметрgitlab_repository_id, который заполняет процесс создания микросервиса из шаблона или источник данных «GitLab: активность репозиториев».
Набор данных «GitLab: виджеты» создаёт готовые виджеты для обеих вкладок. Инструкция показывает, как настроить виджет самостоятельно, например для другой системы контроля версий или с другими параметрами.
Создание виджета
Создайте виджет с идентификатором проекта из контекста:
- Создайте виджет типа «GitLab. Пайплайны» с внешним сервисом GitLab.
- В поле «ID проекта» укажите
{{ .context.repository.id }}. - Сохраните виджет.
Главная передаёт виджету на вкладке карточки микросервиса следующие значения:
| Путь | Значение |
|---|---|
.context.microservice.uuid | UUID сущности микросервиса |
.context.microservice.slug | Идентификатор микросервиса |
.context.microservice.name | Название микросервиса |
.context.repository.id | Значение роли microservice_gitlab_project_id |
.context.repository.url | Значение роли microservice_repository |
Контекст передаётся только на вкладках карточки микросервиса. Для дашбордов создайте отдельный виджет с конкретным ID проекта.
Заполнение слота виджета
Добавьте виджет в слот вкладки «Пайплайны»:
- Перейдите в раздел «Администрирование» → «Справочники» → «Правила маппинга» и откройте набор по умолчанию.
- На вкладке «Маппинг каталога» раскройте область «Микросервисы» и найдите блок «Виджеты».
- В поле «Виджет вкладки «Пайплайны»» выберите созданный виджет.
- Нажмите «Сохранить».
Вкладка «MRs» заполняется полем «Виджет вкладки «MRs»», например виджетом «GitLab. Запросы слияния» с тем же значением поля «ID проекта».
Проверка результата
Проверьте виджет на главной:
- Откройте главную → «Микросервисы» и выберите микросервис в таблице.
- Откройте вкладку «Пайплайны» в карточке микросервиса.
На вкладке отображаются пайплайны репозитория выбранного микросервиса. При выборе другого микросервиса виджет показывает пайплайны его репозитория.
Если на вкладке отображается «Раздел пока недоступен», слот виджета не заполнен. Если виджет не показывает данные, проверьте, что у микросервиса заполнен параметр, сопоставленный роли microservice_gitlab_project_id.