Kaiten

Документация и инструкции

Log in
Log in
Основные возможностиИнтеграции, API, ДополненияДополнения и расширения

Интеграция с GitLab: дополнение

Теперь вы можете связывать карточки в Kaiten с объектами GitLab: ветками, коммитами, merge requests и issues. Интеграция помогает видеть весь контекст разработки прямо внутри карточки задачи — быстро, прозрачно и без переключения между системами.

Для использования дополнения в серверной версии необходимо подключить модуль «Дополнения».

Как работать с дополнением GitLab в Kaiten

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

  1. В карточках появится кнопка дополнения. В первый раз нужно будет выполнить авторизацию в GitLab.

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

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

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

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

Как подключить 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.

Готово! Теперь перейдите в карточку выберите нужный репозиторий, а затем ветку.

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

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

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

Что почитать дальше

Didn't find the answer to your question?

Create a request — we'll help you out

Submit a request