# GitLab

Репозитории, проекты, issues, merge requests, пайплайны и CI/CD

## Сценарии

### MR без ревью
Агент соберёт открытые merge request по проектам и покажет, какие висят без ревью дольше всех и за кем очередь.

### Упавшие пайплайны
Агент разберёт упавшие пайплайны: на каком job сломалось, чей коммит его запустил и повторялось ли это раньше.

### Утренняя сводка по проектам
Агент пришлёт сводку по расписанию: новые issue, принятые merge request и статус ночных пайплайнов CI/CD.

### События в чат команды
Агент поймает push, новый merge request или упавший pipeline по вебхуку и напишет об этом в рабочий чат.

## Как подключить

### Войдите под аккаунтом с доступом к проектам
Токен наследует права своего владельца: в приватном проекте роль Guest урезана, для чтения кода и пайплайнов нужна роль не ниже Reporter, для создания merge request — Developer.

### Определите адрес своего GitLab
Облачный GitLab — это https://gitlab.com. Для self-managed инстанса нужен его корневой адрес со схемой, например https://git.company.ru, без /api/v4 в конце — путь к API дописывается сам.

### Откройте «Personal access tokens» в профиле
Аватар в правом верхнем углу → «Edit profile» (Редактировать профиль) → в левом меню «Access» → «Personal access tokens». В выпадающем списке «Generate token» выберите «Legacy token».

### Выдайте scope «api» и скопируйте токен сразу
Отметьте scope «api» — он даёт чтение и запись по проектам, issues, merge request и пайплайнам; «read_api» оставит только просмотр. Срок обязателен, по умолчанию 365 дней. Токен вида glpat-… показывается один раз.

## Частые вопросы

### Как подключить GitLab?
Персональным токеном: аватар → «Edit profile» → «Access» → «Personal access tokens», в списке «Generate token» выберите «Legacy token» и отметьте scope «api» — «read_api» оставит только просмотр. Адрес указывается отдельным полем, по умолчанию https://gitlab.com.

### Что агент видит в GitLab?
Проекты, issues, merge request, комментарии, коммиты и пайплайны CI/CD — ровно в пределах прав вашего аккаунта, больше токен не даёт.

### Работает ли со своим инстансом?
Да: корень своего инстанса указывается при подключении вместо https://gitlab.com, без /api/v4 на конце. Токен при этом выпускается в том же инстансе, куда ходит агент.

### Пишет ли агент в GitLab?
По умолчанию агент читает проекты и отчитывается в чате. Со scope «api» запись технически возможна, но такие действия он согласует с вами перед выполнением.

[Открыть GitLab](https://gitlab.com)