Skip to content

Интеграция с GitFlic CI

Подключение проекта GitFlic к Exlogare через OAuth и вебхук PIPELINE_FAIL.

GitFlic — российский Git-хостинг с собственным CI/CD. Интеграция с Exlogare устроена аналогично GitLab / GitHub / Bitbucket: OAuth-подключение даёт нам список проектов и обновляет токены, а вебхук PIPELINE_FAIL доставляет события о падениях.

Облако или self-hosted

Поддерживаются обе версии. Различия:

Облако (gitflic.ru)Self-hosted
База REST APIhttps://api.gitflic.ru{base_url}/rest-api
OAuth-хостhttps://oauth.gitflic.ruобычно совпадает с base_url
ЗаголовокAuthorization: token <token>то же

Регистрация OAuth-приложения

  1. В GitFlic откройте Настройки → Личные токены доступа → OAuth-приложения.
  2. Создайте новое приложение.
  3. Redirect URL: https://api.exlogare.net/api/integrations/gitflic/oauth/callback.
  4. Scopes: PROJECT_READ, PROJECT_WRITE, USER_READ.
  5. Сохраните, скопируйте client_id и client_secret.

Подключение в дашборде

  1. Откройте Dashboard → Integrations, секция GitFlic.
  2. Укажите base_url (по умолчанию https://gitflic.ru) и нажмите Подключить GitFlic — мастер перенаправит вас на GitFlic и обратно.
  3. Нажмите Sync projects, чтобы получить список своих проектов и выбрать наблюдаемые. Для каждого автоматически создаётся вебхук PIPELINE_FAIL.

Ручная регистрация вебхука

Если вам нужно использовать одно подключение для множества проектов, отправьте запрос вручную:

{base_url}/rest-api/project/{owner}/{alias}/setting/webhook
Authorization: token <pat-or-oauth-token>
Content-Type: application/json

{
  "url": "https://api.exlogare.net/webhook/gitflic?secret=<random>",
  "secret": "<random>",
  "events": { "PIPELINE_FAIL": true }
}

Параметр ?secret= сверяется с зашифрованным per-connection секретом.

Что происходит при падении

После получения PIPELINE_FAIL мы вычисляем упавший job, забираем его первый .log-артефакт по адресу /project/{owner}/{alias}/cicd/job/{job_id}/artifact/{uuid}/download и прогоняем анализ. Результат приходит в подключённые мессенджеры (Slack / Telegram / Matrix). Публикация комментариев в MR пока вне MVP — мессенджеры присылают полный отчёт со ссылкой на пайплайн.