glab-runner-controller

glab-runner-controller

管理 GitLab Runner 控制器及其认证令牌。

⚠️ 实验性功能

状态： 实验性（仅管理员可用）

• 此功能可能在没有事先通知的情况下被破坏或移除
• 使用风险自担
• 需要 GitLab 管理员权限
• 参阅：https://docs.gitlab.com/policy/development_stages_support/

功能说明

Runner 控制器用于管理基础设施中 GitLab Runner 的编排。此技能提供以下命令：

• 创建和配置 Runner 控制器
• 管理控制器生命周期（列出、更新、删除）
• 生成和轮换认证令牌
• 撤销已泄露的令牌

常见工作流

创建 Runner 控制器

# 使用默认设置创建
glab runner-controller create

# 创建时添加描述
glab runner-controller create --description "Production runners"

# 创建已启用的控制器
glab runner-controller create --description "Prod" --state enabled

状态说明：

• disabled - 控制器已创建但未激活
• enabled - 控制器已激活（默认）
• dry_run - 测试模式（不实际执行 Runner）

列出和查看控制器

# 列出所有控制器
glab runner-controller list

# 分页列出
glab runner-controller list --page 2 --per-page 50

# 以 JSON 格式输出
glab runner-controller list --output json

更新控制器

# 更新描述
glab runner-controller update 42 --description "Updated name"

# 更改状态
glab runner-controller update 42 --state disabled

# 同时更新描述和状态
glab runner-controller update 42 --description "Prod" --state enabled

删除控制器

# 删除（会有确认提示）
glab runner-controller delete 42

# 跳过确认直接删除
glab runner-controller delete 42 --force

令牌管理工作流

令牌生命周期

创建 → 轮换 → 撤销 是安全最佳实践中的典型令牌生命周期。

1. 创建令牌

# 为控制器 42 创建令牌
glab runner-controller token create 42

# 创建时添加描述
glab runner-controller token create 42 --description "production"

# 以 JSON 格式输出（便于自动化）
glab runner-controller token create 42 --output json

重要： 令牌值创建后只显示一次，请立即保存。

2. 列出令牌

# 列出控制器 42 的所有令牌
glab runner-controller token list 42

# 以 JSON 格式列出
glab runner-controller token list 42 --output json

# 分页查看
glab runner-controller token list 42 --page 1 --per-page 20

3. 轮换令牌

轮换操作会生成新令牌并使旧令牌失效。

# 轮换令牌 1（带确认提示）
glab runner-controller token rotate 42 1

# 跳过确认直接轮换
glab runner-controller token rotate 42 1 --force

# 轮换并以 JSON 格式输出
glab runner-controller token rotate 42 1 --force --output json

适用场景：

• 定期轮换（满足安全策略要求）
• 令牌泄露后的响应
• 员工离职前的密钥轮换