Kaiten

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

To Kaiten
Документация и инструкцииОсновные возможностиИнтеграции и APIДополнения и расширения

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

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

Сейчас интеграция работает только с облачной версией GitLab. Мы уже готовим релиз, который позволит подключать self-hosted GitLab-инстансы.

Как работать с дополнением 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.

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

Как разработать и добавить свое дополнение.

Дополнение: Интеграция с Google Документами, Таблицами и Презентациями.

Дополнение: Интеграция с GitHub.