GitLab

Проекты, задачи, merge request и пайплайны GitLab в процессах Pailot

GitLab — платформа DevOps (разработка и эксплуатация): репозиторий, задачи, merge request (запрос на слияние) и CI/CD (Continuous Integration / Continuous Delivery — непрерывная сборка и поставка). Блок ходит в API (Application Programming Interface — программный интерфейс) по токену.

С GitLab в Pailot вы можете:

Смотреть проекты и карточку проекта
Создавать, обновлять, удалять задачи и добавлять комментарий
Работать с merge request: список, создание, обновление, слияние, комментарий
Запускать, смотреть, повторять и отменять пайплайн

Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Токен — в переменных окружения рабочего пространства.

Инструменты

`gitlab_list_projects`

Список проектов, доступных текущему пользователю.

Вход

Параметр	Тип	Обязательный	Описание
`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_get_project`

Карточка проекта.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием (например, `namespace/project`)

Выход

Параметр	Тип	Описание
`project`	object	Данные проекта

`gitlab_list_issues`

Список задач проекта.

Вход

Параметр	Тип	Обязательный	Описание
`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_get_issue`

Карточка задачи.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`issueIid`	number	Да	Номер задачи в проекте (тот, что с # в интерфейсе GitLab)

Выход

Параметр	Тип	Описание
`issue`	object	Данные задачи

`gitlab_create_issue`

Создать задачу в проекте.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`title`	string	Да	Название задачи
`description`	string	Нет	Описание (поддерживается Markdown)
`labels`	string	Нет	Метки через запятую
`assigneeIds`	array	Нет	ID исполнителей
`milestoneId`	number	Нет	ID вехи
`dueDate`	string	Нет	Срок в формате YYYY-MM-DD
`confidential`	boolean	Нет	Конфиденциальная задача

Выход

Параметр	Тип	Описание
`issue`	object	Созданная задача

`gitlab_update_issue`

Обновить задачу.

Вход

Параметр	Тип	Обязательный	Описание
`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	Нет	Срок в формате YYYY-MM-DD
`confidential`	boolean	Нет	Конфиденциальная задача

Выход

Параметр	Тип	Описание
`issue`	object	Обновлённая задача

`gitlab_delete_issue`

Удалить задачу.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`issueIid`	number	Да	Внутренний ID задачи (IID)

Выход

Параметр	Тип	Описание
`success`	boolean	Задача удалена

`gitlab_create_issue_note`

Добавить комментарий к задаче.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`issueIid`	number	Да	Внутренний ID задачи (IID)
`body`	string	Да	Текст комментария (поддерживается Markdown)

Выход

Параметр	Тип	Описание
`note`	object	Созданный комментарий

`gitlab_list_merge_requests`

Список merge request проекта.

Вход

Параметр	Тип	Обязательный	Описание
`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	Список merge request
`total`	number	Всего merge request

`gitlab_get_merge_request`

Карточка merge request.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`mergeRequestIid`	number	Да	Внутренний ID merge request (IID)

Выход

Параметр	Тип	Описание
`mergeRequest`	object	Данные merge request

`gitlab_create_merge_request`

Создать merge request.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`sourceBranch`	string	Да	Исходная ветка
`targetBranch`	string	Да	Целевая ветка
`title`	string	Да	Название merge request
`description`	string	Нет	Описание (поддерживается Markdown)
`labels`	string	Нет	Метки через запятую
`assigneeIds`	array	Нет	ID исполнителей
`milestoneId`	number	Нет	ID вехи
`removeSourceBranch`	boolean	Нет	Удалить исходную ветку после слияния
`squash`	boolean	Нет	Сжать коммиты при слиянии
`draft`	boolean	Нет	Черновик (work in progress)

Выход

Параметр	Тип	Описание
`mergeRequest`	object	Созданный merge request

`gitlab_update_merge_request`

Обновить merge request.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`mergeRequestIid`	number	Да	Внутренний ID merge request (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	Нет	Черновик (work in progress)

Выход

Параметр	Тип	Описание
`mergeRequest`	object	Обновлённый merge request

`gitlab_merge_merge_request`

Слить merge request.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`mergeRequestIid`	number	Да	Внутренний ID merge request (IID)
`mergeCommitMessage`	string	Нет	Своё сообщение коммита слияния
`squashCommitMessage`	string	Нет	Своё сообщение squash-коммита
`squash`	boolean	Нет	Сжать коммиты перед слиянием
`shouldRemoveSourceBranch`	boolean	Нет	Удалить исходную ветку после слияния
`mergeWhenPipelineSucceeds`	boolean	Нет	Слить, когда пайплайн успешен

Выход

Параметр	Тип	Описание
`mergeRequest`	object	Слитый merge request

`gitlab_create_merge_request_note`

Добавить комментарий к merge request.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`mergeRequestIid`	number	Да	Внутренний ID merge request (IID)
`body`	string	Да	Текст комментария (поддерживается Markdown)

Выход

Параметр	Тип	Описание
`note`	object	Созданный комментарий

`gitlab_list_pipelines`

Список пайплайнов проекта.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`ref`	string	Нет	Фильтр по ref (ветка или тег)
`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	Список пайплайнов
`total`	number	Всего пайплайнов

`gitlab_get_pipeline`

Карточка пайплайна.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`pipelineId`	number	Да	ID пайплайна

Выход

Параметр	Тип	Описание
`pipeline`	object	Данные пайплайна

`gitlab_create_pipeline`

Запустить пайплайн.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`ref`	string	Да	Ветка или тег для запуска
`variables`	array	Нет	Переменные пайплайна (у каждой — key, value и необязательный variable_type)

Выход

Параметр	Тип	Описание
`pipeline`	object	Созданный пайплайн

`gitlab_retry_pipeline`

Повторить упавший пайплайн.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`pipelineId`	number	Да	ID пайплайна

Выход

Параметр	Тип	Описание
`pipeline`	object	Повторённый пайплайн

`gitlab_cancel_pipeline`

Отменить выполняющийся пайплайн.

Вход

Параметр	Тип	Обязательный	Описание
`projectId`	string	Да	ID проекта или путь с URL-кодированием
`pipelineId`	number	Да	ID пайплайна

Выход

Параметр	Тип	Описание
`pipeline`	object	Отменённый пайплайн

На этой странице

На этой странице

Получить доступ

Копилот собирает процесс. Менеджер запускает сам. Можно поставить в контур компании.

Получить доступ