glab-runner-controller — скилл для Claude Code: функции и установка
Скилл glab-runner-controller для Claude Code управляет контроллерами GitLab Runner и их токенами. Срабатывает на запросы о создании контроллера, его областях действия или токенах.
MIT 113 установок ★ 51 обновлён 2026-10-20
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a claude-codeЧто делает glab-runner-controller
Скилл управляет жизненным циклом контроллеров GitLab Runner и их токенами через команды glab runner-controller. Он помогает создавать, просматривать, обновлять и удалять контроллеры, а также задавать для них области действия на уровне экземпляра или отдельных раннеров.
Для токенов доступны создание, просмотр списка, ротация и отзыв. Новое значение токена показывается только при создании. Функция экспериментальная и требует прав администратора GitLab; она может работать с ошибками или исчезнуть без предупреждения.
Какие задачи решает
- создать и настроить контроллер GitLab Runner
- изменить состояние контроллера или удалить его
- ограничить контроллер выбранными раннерами
- выпустить, заменить или отозвать токен контроллера
Примеры запросов агенту
- Создай контроллер GitLab Runner с описанием «Production runners».
- Покажи области действия контроллера 42 и добавь раннеры 5 и 10.
- Создай токен для контроллера 42, затем отзови токен 1.
Как установить glab-runner-controller
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a claude-code2Вручную: положить файлы
~/.claude/skills/glab-runner-controller/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/glab-runner-controller/
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a codex2Вручную: положить файлы
.agents/skills/glab-runner-controller/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a cursor2Вручную: положить файлы
.cursor/skills/glab-runner-controller/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vince-winkintel/gitlab-cli-skills glab-runner-controller2Вручную: положить файлы
.github/skills/glab-runner-controller/SKILL.md1Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a gemini-cli2Командой платформы
gemini skills install https://github.com/vince-winkintel/gitlab-cli-skills --path glab-runner-controllerВручную: положить файлы
.devin/skills/glab-runner-controller/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о glab-runner-controller
Как установить glab-runner-controller в Claude Code?
Выполни npx skills add vince-winkintel/gitlab-cli-skills --skill glab-runner-controller -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/glab-runner-controller/SKILL.md.
Что делает glab-runner-controller?
Скилл управляет контроллерами GitLab Runner, их областями действия и токенами: создаёт и обновляет контроллеры, а также выпускает, ротирует и отзывает токены.
Что нужно для работы glab-runner-controller?
Нужны glab, авторизация в GitLab и права администратора. Функция экспериментальная; для неё могут требоваться свежая сборка glab и включённый флаг функции на экземпляре GitLab.
Исходный текст
SKILL.md · MIT
--- name: glab-runner-controller description: Manage GitLab runner controllers and authentication tokens. Create, inspect, update, delete controllers; manage scopes; and generate, rotate, and revoke tokens. Admin-only experimental feature for managing runner controller lifecycle. Triggers on runner controller, controller token, controller scope, experimental runner, admin runner. --- # glab-runner-controller Manage GitLab runner controllers and their authentication tokens. ## ⚠️ Experimental Feature **Status:** EXPERIMENTAL (Admin-only) - This feature may be broken or removed without prior notice - Use at your own risk - Requires GitLab admin privileges - See: https://docs.gitlab.com/policy/development_stages_support/ ## What It Does Runner controllers manage the orchestration of GitLab Runners in your infrastructure. This skill provides commands to: - Create and configure runner controllers - Inspect controller details and connection status - Manage controller lifecycle (list, get, update, delete) - Manage controller scopes (instance-level or runner-level) - Generate and rotate authentication tokens - Revoke compromised tokens ## Common Workflows ### Create Runner Controller ```bash # Create with default settings glab runner-controller create # Create with description glab runner-controller create --description "Production runners" # Create enabled controller glab runner-controller create --description "Prod" --state enabled ``` **States:** - `disabled` - Controller exists but inactive - `enabled` - Controller is active (default) - `dry_run` - Test mode (no actual runner execution) ### List and View Controllers ```bash # List all controllers glab runner-controller list # List with pagination glab runner-controller list --page 2 --per-page 50 # Output as JSON glab runner-controller list --output json # Get one controller with status details glab runner-controller get 42 glab runner-controller get 42 --output json ``` ### Update Controller ```bash # Update description glab runner-controller update 42 --description "Updated name" # Change state glab runner-controller update 42 --state disabled # Update both glab runner-controller update 42 --description "Prod" --state enabled ``` ### Delete Controller ```bash # Delete with confirmation prompt glab runner-controller delete 42 # Delete without confirmation glab runner-controller delete 42 --force ``` ## Scope Management Runner controller scopes determine what the controller is allowed to evaluate. ### List Scopes ```bash # List all scopes for controller 42 glab runner-controller scope list 42 # JSON output glab runner-controller scope list 42 --output json ``` ### Add Scopes ```bash # Allow the controller to evaluate all instance runners glab runner-controller scope create 42 --instance # Allow the controller to evaluate a specific runner glab runner-controller scope create 42 --runner 5 # Add multiple runner scopes glab runner-controller scope create 42 --runner 5 --runner 10 glab runner-controller scope create 42 --runner 5,10 ``` ### Remove Scopes ```bash # Remove the instance-level scope glab runner-controller scope delete 42 --instance # Remove a specific runner-level scope glab runner-controller scope delete 42 --runner 5 --force ``` > **Note:** Older docs/examples may refer to `glab runner-controller runner ...` subcommands. The current user-facing surface is `glab runner-controller scope ...` plus `glab runner-controller get`. ## Token Management Workflows ### Token Lifecycle **Create → Rotate → Revoke** is the typical token lifecycle for security best practices. #### 1. Create Token ```bash # Create token for controller 42 glab runner-controller token create 42 # Create with description glab runner-controller token create 42 --description "production" # Output as JSON (for automation) glab runner-controller token create 42 --output json ``` **Important:** Save the token value immediately - it's only shown once at creation. #### 2. List Tokens ```bash # List all tokens for controller 42 glab runner-controller token list 42 # List as JSON glab runner-controller token list 42 --output json # Paginate glab runner-controller token list 42 --page 1 --per-page 20 ``` #### 3. Rotate Token Rotation generates a new token and invalidates the old one. ```bash # Rotate token 1 (with confirmation) glab runner-controller token rotate 42 1 # Rotate without confirmation glab runner-controller token rotate 42 1 --force # Rotate and output as JSON glab runner-controller token rotate 42 1 --force --output json ``` **Use cases:** - Scheduled rotation (security policy compliance) - Token compromise response - Key rotation before employee departure #### 4. Revoke Token ```bash # Revoke token 1 (with confirmation) glab runner-controller token revoke 42 1 # Revoke without confirmation glab runner-controller token revoke 42 1 --force ``` **When to revoke:** - Token compromised or leaked - Controller decommissioned - Access no longer needed ### Token Security Best Practices 1. **Rotate regularly** - Set up scheduled rotation (e.g., every 90 days) 2. **Use descriptions** - Track token purpose and owner 3. **Revoke immediately** when compromised 4. **Never commit tokens** to version control 5. **Use `--output json`** for automation (parse token value securely) ## Decision Tree: Controller State Selection ``` Do you need the controller active? ├─ Yes → --state enabled ├─ Testing configuration? → --state dry_run └─ No (maintenance/setup) → --state disabled ``` ## Troubleshooting **"Permission denied" or "403 Forbidden":** - Runner controller commands require GitLab admin privileges - Verify you're authenticated as an admin user - Check `glab auth status` to confirm current user **"Runner controller not found":** - Verify controller ID with `glab runner-controller list` - Controller may have been deleted - Check if you have access to the correct GitLab instance **Token creation fails:** - Ensure controller exists and is enabled - Verify admin privileges - Check GitLab instance version (experimental features may require recent versions) **Token rotation shows old token still works:** - Token invalidation may take a few seconds to propagate - Wait 10-30 seconds and test again - Check controller state (disabled controllers don't enforce token validation) **Cannot delete controller:** - Check if controller has active runners - May need to decommission runners first - Use `--force` to override (⚠️ destructive) **Experimental feature not available:** - Verify glab version: `glab version` (requires a recent glab build) - Check if feature flag is enabled on GitLab instance - Confirm GitLab instance version supports runner controllers ## Related Skills **CI/CD & Runners:** - `glab-ci` - View and manage CI/CD pipelines and jobs - `glab-job` - Retry, cancel, view logs for individual jobs - `glab-runner` - Manage individual runners (list, assign, jobs, managers, update, delete) **Repository Management:** - `glab-repo` - Manage repositories (runner controllers are instance-level) **Authentication:** - `glab-auth` - Login and authentication management ## Command Reference For complete command syntax and all available flags, see: - [references/commands.md](references/commands.md)
© vince-winkintel · MIT · vince-winkintel/gitlab-cli-skills