Дополнение GitLab: поддержка корпоративных GitLab серверов

Теперь дополнение GitLab можно использовать не только с облачной версией GitLab.com, но и с корпоративными серверами (self-managed GitLab). Это позволяет связывать карточки в Kaiten с объектами вашего GitLab: ветками, коммитами, merge requests и issues — независимо от того, где развернут сервер.

Как подключить self-managed GitLab?

Шаг 1. Включите дополнение

В правой боковой панели пространства нажмите на иконку дополнений и затем нажмите «Включить». Теперь дополнение будет доступно во всех карточках этого пространства.

Шаг 2. Перейдите в настройки

Откройте настройки дополнения и выберите вариант: Self-managed (собственный сервер)

Заполните поля:

Base URL — адрес вашего корпоративного сервера GitLab
Например: https://gitlab.company.ru
OAuth Client ID — идентификатор OAuth-приложения в GitLab
OAuth Client Secret — секретный ключ OAuth-приложения
Redirect URI (опционально) — адрес для перенаправления после авторизации.
Можно оставить значение по умолчанию или указать собственный URL, если у вас развёрнут свой экземпляр аддона GitLab (например, при on-premise установке Kaiten).

Если этого не сделать, то при открытии кнопки GitLab в карточке появится предупреждение о том что аддон не настроен.

Инструкция, как получить OAuth Client ID и OAuth Client Secret:

Также описана в раскрывающемся окне при настройке

1. Откройте GitLab Admin Area -> Applications

2. Нажмите "New application"

3. Заполните поля:
— Name: Kaiten Integration

— Redirect URI: https://addons.kaiten-dev.ru/gitlab/api/auth/callback (или используйте свой, если развернули собственный аддон)

— Confidential: снимите галочку (ВАЖНО!)

— Scopes: api, read_user, read _repository

4. Нажмите "Save application"

5. Скопируйте Application ID в поле Client ID

6. Скопируйте Secret в поле Client Secret

Шаг 3. Авторизируйтесь в GitLab

Теперь откройте любую карточку на пространстве, чтобы войти в свой аккаунт GitLab.

Готово! Теперь вы можете добавлять в карточки отдельные блоки с информацией о ваших ветках, коммитах, merge request, issue.

Шаг 4. Выберите нужный репозиторий

После авторизации выберите нужный репозиторий, а затем ветку. Kaiten запомнит выбор и предложит его в следующий раз.

Чтобы изменить репозиторий — нажмите «Выбрать другой репозиторий».

Каждый прикрепленный объект отображается в виде отдельного блока: статус MR, ответственный, количество изменений, номер issue и другая важная информация доступны без перехода в GitLab.

Ключевые возможности дополнения:

Разные пространства могут работать с разными GitLab серверами. Вы можете выбрать между облачной версией Gitlab.com и self-managed версией через настройки дополнения.

Дополнение GitLab настраивается на каждом отдельном пространстве, поэтому для разных пространств можно настроить разные версии GitLab.