К основному содержанию
скилл CX Codex

glab-runner — скилл для Claude Code: управление GitLab Runner

Скилл glab-runner помогает управлять GitLab CI/CD Runner через glab: просматривать задания, назначать и приостанавливать раннеры, а также удалять их.

MIT 129 установок ★ 51 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner -a claude-code
Открыть на GitHub

Что делает glab-runner

Скилл описывает команды glab runner для работы с раннерами на уровне проекта, группы или инстанса. С его помощью можно посмотреть список и статус раннеров, назначить раннер проекту или отвязать от него, проверить задания и связанные процессы-менеджеры. Для списка и заданий доступны JSON и постраничный просмотр.

Приостановка через glab runner update --pause прекращает приём новых заданий, но не останавливает процесс раннера на хосте. Удаление необратимо. Для управления раннерами инстанса нужны права администратора GitLab, а назначение и отвязка требуют роли Maintainer в проекте. Перед удалением активного раннера проверьте его задания: работающий процесс может продолжать их выполнять.

Какие задачи решает

  • просмотреть раннеры проекта или группы
  • назначить раннер проекту или отвязать его
  • проверить задания, обработанные раннером
  • приостановить раннер без удаления
  • удалить выведенный из эксплуатации раннер

Примеры запросов агенту

  • Покажи раннеры текущего проекта и выведи результат в JSON.
  • Проверь, какие задания выполняет раннер 123, затем приостанови его.
  • Назначь раннер 123 проекту owner/project.

Как установить glab-runner

1Через Skills CLI (Vercel)

npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner -a claude-code

2Вручную: положить файлы

~/.claude/skills/glab-runner/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/glab-runner/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о glab-runner

Как установить glab-runner в Claude Code?

Выполните npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner -a claude-code. Файл скилла появится по пути ~/.claude/skills/glab-runner/SKILL.md.

Что делает glab-runner?

Скилл помогает управлять GitLab Runner командами glab runner: просматривать раннеры и их задания, назначать их проектам, приостанавливать и удалять.

Останавливает ли пауза процесс раннера?

Нет. glab runner update --pause запрещает раннеру брать новые задания, но процесс на хосте продолжает работать.

Исходный текст

SKILL.md · MIT
---
name: glab-runner
description: Manage GitLab CI/CD runners — list, assign, unassign, inspect recent jobs and managers, pause/unpause via update, and delete runners at project, group, or instance level. Use when viewing runner status, assigning runners to projects, checking what jobs a runner handled, seeing manager processes, temporarily pausing a runner, or removing a decommissioned runner. Triggers on runner, glab runner, list runners, assign runner, unassign runner, runner jobs, runner managers, pause runner, unpause runner, delete runner, CI runner.
---

# glab runner

Manage GitLab CI/CD runners from the command line.

## List totals and pagination

`glab runner list` and `glab runner jobs` use the API-reported total in their text headers when available, separate from the number of returned rows. Missing totals must not be treated as proof there are no other pages. JSON contains the requested page's items, not every item counted by the header. Use `--page` and `--per-page` to traverse results explicitly; do not equate JSON array length with the server total.

## Quick Start

```bash
# List runners for current project
glab runner list

# Pause a runner
glab runner update <runner-id> --pause

# Delete a runner
glab runner delete <runner-id>
```

## Common Workflows

### List Runners

```bash
# List all runners for current project
glab runner list

# List for a specific project
glab runner list --repo owner/project

# List all runners (instance-level, admin only)
glab runner list --instance

# Output as JSON
glab runner list --output json

# Paginate
glab runner list --page 2 --per-page 50
```

**Sample JSON output parsing:**
```bash
# Find all paused runners
glab runner list --output json | python3 -c "
import sys, json
runners = json.load(sys.stdin)
paused = [r for r in runners if r.get('paused')]
for r in paused:
    print(f"{r['id']}: {r.get('description','(no description)')} — {r.get('status')}")
"
```

### Pause or Resume a Runner

Pausing a runner prevents it from picking up new jobs without removing it.

```bash
# Pause runner 123
glab runner update 123 --pause

# Resume a paused runner
glab runner update 123 --unpause

# Pause in a specific project context
glab runner update 123 --pause -R owner/project
```

**When to pause:**
- Maintenance window (updates, reboots)
- Investigating a failing runner
- Temporarily reducing runner capacity
- Before decommissioning (verify no jobs are running first)

> **Note:** Older docs/examples may mention `glab runner pause`, but the supported command surface uses `glab runner update --pause` / `--unpause`.

### Inspect Jobs Processed by a Runner

```bash
# List recent jobs for runner 9
glab runner jobs 9

# Show only running jobs
glab runner jobs 9 --status running

# JSON output for automation
glab runner jobs 9 --output json
```

Useful for checking whether a runner is currently busy before pausing or deleting it.

### Inspect Runner Managers

```bash
# List managers attached to a runner
glab runner managers 9

# JSON output
glab runner managers 9 --output json
```

Use this when you need to understand which runner manager processes/backends are associated with a runner.

### Delete a Runner

```bash
# Delete with confirmation prompt
glab runner delete 123

# Delete without confirmation
glab runner delete 123 --force

# Delete in a specific project context
glab runner delete 123 --repo owner/project
```

**⚠️ Deletion is permanent.** Pause first if unsure.

## Decision Tree: Pause vs Delete

```
Do you need the runner gone permanently?
├─ No → Pause it (recoverable)
└─ Yes → Is it actively running jobs?
          ├─ Yes → Check `glab runner jobs <id>`, then pause first and wait for jobs to finish
          └─ No → Delete with --force
```

## Runner Status Reference

| Status | Meaning |
|---|---|
| `online` | Connected and ready to accept jobs |
| `offline` | Not connected (check runner process) |
| `paused` | Connected but not accepting new jobs |
| `stale` | No contact in the last 3 months |

## Troubleshooting

**"runner: command not found":**
- Requires a current `glab` release. Check with `glab version`.

**"Permission denied" on instance-level runners:**
- Instance-level runner management requires GitLab admin privileges.
- Project runners can be managed by project maintainers.

**Runner won't pause or unpause:**
- Verify runner ID with `glab runner list`.
- Check permissions (must be at least Maintainer on the project).
- Use `glab runner update <id> --pause` or `--unpause`.

**Runner stuck "online" after pause:**
- The runner process is still running on the host — it just won't accept new jobs.
- This is expected. To fully stop, SSH into the runner host and stop the process.

**Cannot delete runner:**
- Runner may be shared/group-level (requires higher privileges).
- Check if runner is assigned to multiple projects; removing from one project may require project-level deletion vs instance-level.

### Assign / Unassign Runners to Projects

Assign an existing runner to a project so it can pick up jobs:

```bash
# Assign a runner to the current project
glab runner assign <runner-id>

# Assign to a specific project
glab runner assign <runner-id> --repo owner/project
```

Remove a runner from a project (does not delete the runner):

```bash
# Unassign from current project
glab runner unassign <runner-id>

# Unassign from a specific project
glab runner unassign <runner-id> --repo owner/project
```

**Note:** Assigning/unassigning requires at least Maintainer role on the project. This is different from `glab runner delete` which permanently removes the runner.

## Related Skills

- `glab-runner-controller` — Manage runner controllers and orchestration (admin-only, experimental)
- `glab-ci` — View and manage CI/CD pipelines and jobs
- `glab-job` — Retry, cancel, trace logs for individual jobs

## Command Reference

Authored command summary; complete live help is linked below.

```
glab runner <command> [--flags]

Commands:
  assign    Assign a runner to a project
  delete    Delete a runner
  jobs      List jobs processed by a runner
  list      List runners for a project (default), group, or instance
  managers  List runner managers
  unassign  Unassign a runner from a project
  update    Update runner settings, including pause/unpause

Flags (list):
  -g, --group    List runners for a group (exclusive with --repo/--instance)
  --jq           Filter JSON output using a jq expression
  --instance     List all runners available to the user (instance scope)
  --output       Format output as: text, json
  --page         Page number
  --per-page     Number of items per page
  --repo         Select a repository
  -h, --help     Show help
```

Use only one of `--group`, `--repo`, or `--instance`. The command enforces mutual exclusion even though the captured help describes `--group` as ignored with `--repo`.

See [references/commands.md](references/commands.md) for complete parent, list, and jobs help.

© vince-winkintel · MIT · vince-winkintel/gitlab-cli-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
gitlab odyssey4me Управляет GitLab через glab CLI. Создаёт issue и MR, проверяет статус пайплайнов, просматривает репозитории. CX Codex +1 305установок glab henricook Скилл glab для Claude Code: учит агента пользоваться GitLab CLI — создавать merge request, разбирать issues, следить за пайплайнами и дёргать API. Проект живёт в GitLab. CX Codex +1 1 100установок cyrus-setup-gitlab cyrusagents Скилл cyrus-setup-gitlab настраивает glab и git-идентичность, чтобы Cyrus мог создавать ветки, коммиты и merge request'ы в вашем проекте. CX Codex +1 830установок gitlab-ci-patterns Seth Hobson Скилл gitlab-ci-patterns для Claude Code помогает собирать GitLab CI/CD-пайплайны со стадиями, кэшем и деплоем. Описывает пайплайны для тестирования, сборки и доставки приложений. CX Codex +1 13 112установок gitlab-mcp-skill zereight Помогает работать с инструментами GitLab MCP. Подключается к задачам с merge request, issues, репозиториями и CI-пайплайнами. CX Codex +1 1 400установок shepherd chrisbanes Скилл shepherd отслеживает открытые pull request и merge request, разбирает замечания ревьюеров и падения CI, а также готовит правки к пушу. CX Codex +1 1 400установок

Из того же набора45

Весь набор →
glab-issue Скилл glab-issue управляет задачами GitLab через glab: создаёт issues, ищет их по фильтрам, добавляет заметки и меняет статус. CX Codex +1 148установок glab-repo Скилл glab-repo автоматизирует управление проектами GitLab через CLI: создание, клонирование, форки, очистку веток и настройку удалённых репозиториев прямо в диалоге с агентом. CX Codex +1 145установок glab-job Скилл glab-job управляет отдельными задачами CI/CD в GitLab: читает логи, перезапускает упавшие сборки и скачивает артефакты. CX Codex +1 135установок glab-config Скилл glab-config управляет конфигурацией glab — CLI для GitLab: умолчания, прокси для каждого хоста, переменные цвета и редактора. CX Codex +1 129установок glab-release Скилл glab-release для Claude Code управляет релизами GitLab: создаёт и удаляет их, показывает список и загружает файлы. Срабатывает на задачах с версиями, тегами, описаниями релизов и их файлами. CX Codex +1 129установок glab-skills Учит агентов работать с командой glab skills: просматривать, ставить и обновлять встроенные или удалённые скилы GitLab CLI. CX Codex +1 128установок glab-variable Набор команд glab variable под рукой у агента: завести переменную пайплайна, поправить флаги, перенести секреты между проектами и группами GitLab. CX Codex +1 126установок glab-changelog Скилл glab-changelog для Claude Code генерирует changelog проекта по релизам, тегам и коммитам GitLab. Помогает подготовить заметки к выпуску и зафиксировать историю версий. CX Codex +1 125установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой