Перейти к основному содержимому
Версия: Графиня 2026H1

GitLab

Последняя версия: 1.3.0

Дистрибутив: образ плагина GitLab

Описание​

Плагин GitLab предназначен для подключения Графини к GitLab API. Он позволяет использовать данные GitLab при построении графиков, таблиц и переменных: проекты, пайплайны, merge request, релизы, теги, users, audit events и другие ресурсы.

Для подключения используется стандартный конструктор источника данных. Проверка соединения выполняется по указанному API-адресу GitLab с помощью персонального токена доступа.

Настройка​

Ниже приведена форма создания источника данных GitLab из интерфейса Графини.

Базовая форма​

Базовая форма источника данных GitLab содержит только три пользовательских поля: URL, Токен доступа и Количество страниц.

Форма создания источника данных GitLab

Поля источника данных​

Ниже перечислены поля, которые используются при создании источника данных GitLab.

Название в UIКод поляТипОбязательностьПримечание
URLurltextобязательноБазовый URL GitLab API, например https://gitlab.com/api/v4
Токен доступаaccessTokenpasswordобязательноПерсональный токен доступа к GitLab API
Количество страницpageLimitnumberнеобязательноМаксимальное количество страниц данных для выборок в конструкторах, значение по умолчанию 5, допустимый диапазон 1..100

Динамические поля и зависимости​

У datasource-формы плагина GitLab нет пользовательских триггерных полей.

  • дополнительные поля не появляются при изменении значений
  • отдельные режимы аутентификации отсутствуют
  • форма всегда состоит из полей URL, Токен доступа и Количество страниц

Пример заполненной формы​

Пример заполнения источника данных GitLab

Правила заполнения, важные для проверки подключения​

  • поле URL обязательно и должно содержать корректный URL
  • для успешной проверки подключения указывайте именно базовый адрес GitLab API, обычно с суффиксом /api/v4
  • поле Токен доступа обязательно
  • токен должен быть действующим и иметь доступ к GitLab API
  • поле Количество страниц можно не заполнять, тогда используется значение 5
  • если поле Количество страниц заполнено, указывайте целое число от 1 до 100

Порядок создания источника данных​

  1. Откройте раздел Источники данных и нажмите Добавление источника.
  2. В поле Источник данных укажите понятное имя подключения.
  3. В поле Тип выберите GitLab.
  4. В поле URL укажите базовый адрес GitLab API.
  5. В поле Токен доступа вставьте персональный токен доступа.
  6. При необходимости заполните поле Количество страниц.
  7. Нажмите Проверить соединение.
  8. После успешной проверки нажмите Сохранить.

Пример заполнения​

  • URL: https://gitlab.company.local/api/v4
  • Токен доступа: персональный access token пользователя или сервисной учётной записи GitLab
  • Количество страниц: 5

Пример заполнения с увеличенным лимитом выборки для конструкторов​

  • URL: https://gitlab.company.local/api/v4
  • Токен доступа: персональный access token пользователя или сервисной учётной записи GitLab
  • Количество страниц: 20

Такой вариант удобен, если в GitLab много проектов и в выпадающих списках конструктора нужно просматривать больше результатов за один проход.