GitLab
Взаимодействие с проектами GitLab, задачами, запросами на слияние и конвейерами
GitLab — это комплексная платформа DevOps, которая позволяет командам управлять, совместно работать и автоматизировать свой жизненный цикл разработки программного обеспечения. С GitLab вы можете легко управлять управлением исходным кодом, CI/CD, ревью и совместной работой в одном приложении.
С GitLab в AACFlow вы можете:
- Управлять проектами и репозиториями: Просматривать и получать ваши проекты GitLab, получать детали и организовывать репозитории
- Работать с задачами: Просматривать, создавать и комментировать задачи для отслеживания работы и эффективного сотрудничества
- Обрабатывать запросы на слияние: Просматривать, создавать и управлять запросами на слияние для изменений кода и ревью коллег
- Автоматизировать конвейеры CI/CD: Запускать, отслеживать и взаимодействовать с конвейерами GitLab как часть ваших автоматизированных потоков
- Сотрудничать с комментариями: Добавлять комментарии к задачам или запросам на слияние для эффективной коммуникации в вашей команде
Используя интеграцию GitLab в AACFlow, ваши агенты могут программно взаимодействовать с вашими проектами GitLab. Автоматизируйте управление проектами, отслеживание задач, ревью кода и операции с конвейерами в ваших рабочих процессах, оптимизируя процесс разработки программного обеспечения и улучшая сотрудничество в вашей команде.
Интегрируйте GitLab в рабочий процесс. Может управлять проектами, задачами, запросами на слияние, конвейерами и добавлять комментарии. Поддерживает все основные операции DevOps GitLab.
Просмотр проектов GitLab, доступных аутентифицированному пользователю
| Параметр | Тип | Обязательный | Описание |
|---|
owned | boolean | Нет | Ограничить проектами, принадлежащими текущему пользователю |
membership | boolean | Нет | Ограничить проектами, в которых текущий пользователь является участником |
search | string | Нет | Поиск проектов по имени |
visibility | string | Нет | Фильтр по видимости (public, internal, private) |
orderBy | string | Нет | Сортировка по полю (id, name, path, created_at, updated_at, last_activity_at) |
sort | string | Нет | Направление сортировки (asc, desc) |
perPage | number | Нет | Количество результатов на странице (по умолчанию 20, максимум 100) |
page | number | Нет | Номер страницы для пагинации |
| Параметр | Тип | Описание |
|---|
projects | array | Список проектов GitLab |
total | number | Общее количество проектов |
Получение деталей конкретного проекта GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь (например, "namespace/project") |
| Параметр | Тип | Описание |
|---|
project | object | Детали проекта GitLab |
Просмотр задач в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
state | string | Нет | Фильтр по состоянию (opened, closed, all) |
labels | string | Нет | Список названий меток через запятую |
assigneeId | number | Нет | Фильтр по ID пользователя-исполнителя |
milestoneTitle | string | Нет | Фильтр по названию вехи |
search | string | Нет | Поиск задач по названию и описанию |
orderBy | string | Нет | Сортировка по полю (created_at, updated_at) |
sort | string | Нет | Направление сортировки (asc, desc) |
perPage | number | Нет | Количество результатов на странице (по умолчанию 20, максимум 100) |
page | number | Нет | Номер страницы для пагинации |
| Параметр | Тип | Описание |
|---|
issues | array | Список задач GitLab |
total | number | Общее количество задач |
Получение деталей конкретной задачи GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
issueIid | number | Да | Номер задачи в проекте (# отображаемый в интерфейсе GitLab) |
| Параметр | Тип | Описание |
|---|
issue | object | Детали задачи GitLab |
Создание новой задачи в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
title | string | Да | Название задачи |
description | string | Нет | Описание задачи (поддерживается Markdown) |
labels | string | Нет | Список названий меток через запятую |
assigneeIds | array | Нет | Массив ID пользователей для назначения |
milestoneId | number | Нет | ID вехи для назначения |
dueDate | string | Нет | Дата выполнения в формате ГГГГ-ММ-ДД |
confidential | boolean | Нет | Является ли задача конфиденциальной |
| Параметр | Тип | Описание |
|---|
issue | object | Созданная задача GitLab |
Обновление существующей задачи в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
issueIid | number | Да | Внутренний ID задачи (IID) |
title | string | Нет | Новое название задачи |
description | string | Нет | Новое описание задачи (поддерживается Markdown) |
stateEvent | string | Нет | Событие состояния (close или reopen) |
labels | string | Нет | Список названий меток через запятую |
assigneeIds | array | Нет | Массив ID пользователей для назначения |
milestoneId | number | Нет | ID вехи для назначения |
dueDate | string | Нет | Дата выполнения в формате ГГГГ-ММ-ДД |
confidential | boolean | Нет | Является ли задача конфиденциальной |
| Параметр | Тип | Описание |
|---|
issue | object | Обновленная задача GitLab |
Удаление задачи из проекта GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
issueIid | number | Да | Внутренний ID задачи (IID) |
| Параметр | Тип | Описание |
|---|
success | boolean | Успешно ли удалена задача |
Добавление комментария к задаче GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
issueIid | number | Да | Внутренний ID задачи (IID) |
body | string | Да | Текст комментария (поддерживается Markdown) |
| Параметр | Тип | Описание |
|---|
note | object | Созданный комментарий |
Просмотр запросов на слияние в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
state | string | Нет | Фильтр по состоянию (opened, closed, merged, all) |
labels | string | Нет | Список названий меток через запятую |
sourceBranch | string | Нет | Фильтр по исходной ветке |
targetBranch | string | Нет | Фильтр по целевой ветке |
orderBy | string | Нет | Сортировка по полю (created_at, updated_at) |
sort | string | Нет | Направление сортировки (asc, desc) |
perPage | number | Нет | Количество результатов на странице (по умолчанию 20, максимум 100) |
page | number | Нет | Номер страницы для пагинации |
| Параметр | Тип | Описание |
|---|
mergeRequests | array | Список запросов на слияние GitLab |
total | number | Общее количество запросов на слияние |
Получение деталей конкретного запроса на слияние GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
mergeRequestIid | number | Да | Внутренний ID запроса на слияние (IID) |
| Параметр | Тип | Описание |
|---|
mergeRequest | object | Детали запроса на слияние GitLab |
Создание нового запроса на слияние в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
sourceBranch | string | Да | Название исходной ветки |
targetBranch | string | Да | Название целевой ветки |
title | string | Да | Название запроса на слияние |
description | string | Нет | Описание запроса на слияние (поддерживается Markdown) |
labels | string | Нет | Список названий меток через запятую |
assigneeIds | array | Нет | Массив ID пользователей для назначения |
milestoneId | number | Нет | ID вехи для назначения |
removeSourceBranch | boolean | Нет | Удалить исходную ветку после слияния |
squash | boolean | Нет | Объединить коммиты при слиянии |
draft | boolean | Нет | Пометить как черновик (работа в процессе) |
| Параметр | Тип | Описание |
|---|
mergeRequest | object | Созданный запрос на слияние GitLab |
Обновление существующего запроса на слияние в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
mergeRequestIid | number | Да | Внутренний ID запроса на слияние (IID) |
title | string | Нет | Новое название запроса на слияние |
description | string | Нет | Новое описание запроса на слияние |
stateEvent | string | Нет | Событие состояния (close или reopen) |
labels | string | Нет | Список названий меток через запятую |
assigneeIds | array | Нет | Массив ID пользователей для назначения |
milestoneId | number | Нет | ID вехи для назначения |
targetBranch | string | Нет | Новая целевая ветка |
removeSourceBranch | boolean | Нет | Удалить исходную ветку после слияния |
squash | boolean | Нет | Объединить коммиты при слиянии |
draft | boolean | Нет | Пометить как черновик (работа в процессе) |
| Параметр | Тип | Описание |
|---|
mergeRequest | object | Обновленный запрос на слияние GitLab |
Слияние запроса на слияние в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
mergeRequestIid | number | Да | Внутренний ID запроса на слияние (IID) |
mergeCommitMessage | string | Нет | Пользовательское сообщение коммита слияния |
squashCommitMessage | string | Нет | Пользовательское сообщение коммита объединения |
squash | boolean | Нет | Объединить коммиты перед слиянием |
shouldRemoveSourceBranch | boolean | Нет | Удалить исходную ветку после слияния |
mergeWhenPipelineSucceeds | boolean | Нет | Слить когда конвейер завершится успешно |
| Параметр | Тип | Описание |
|---|
mergeRequest | object | Слитый запрос на слияние GitLab |
Добавление комментария к запросу на слияние GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
mergeRequestIid | number | Да | Внутренний ID запроса на слияние (IID) |
body | string | Да | Текст комментария (поддерживается Markdown) |
| Параметр | Тип | Описание |
|---|
note | object | Созданный комментарий |
Просмотр конвейеров в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
ref | string | Нет | Фильтр по ссылке (ветка или тег) |
status | string | Нет | Фильтр по статусу (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled) |
orderBy | string | Нет | Сортировка по полю (id, status, ref, updated_at, user_id) |
sort | string | Нет | Направление сортировки (asc, desc) |
perPage | number | Нет | Количество результатов на странице (по умолчанию 20, максимум 100) |
page | number | Нет | Номер страницы для пагинации |
| Параметр | Тип | Описание |
|---|
pipelines | array | Список конвейеров GitLab |
total | number | Общее количество конвейеров |
Получение деталей конкретного конвейера GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
pipelineId | number | Да | ID конвейера |
| Параметр | Тип | Описание |
|---|
pipeline | object | Детали конвейера GitLab |
Запуск нового конвейера в проекте GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
ref | string | Да | Ветка или тег для запуска конвейера |
variables | array | Нет | Массив переменных для конвейера (каждая с ключом, значением и опциональным variable_type) |
| Параметр | Тип | Описание |
|---|
pipeline | object | Созданный конвейер GitLab |
Повторный запуск неудачного конвейера GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
pipelineId | number | Да | ID конвейера |
| Параметр | Тип | Описание |
|---|
pipeline | object | Повторно запущенный конвейер GitLab |
Отмена запущенного конвейера GitLab
| Параметр | Тип | Обязательный | Описание |
|---|
projectId | string | Да | ID проекта или URL-кодированный путь |
pipelineId | number | Да | ID конвейера |
| Параметр | Тип | Описание |
|---|
pipeline | object | Отмененный конвейер GitLab |
