GitLab Runner 注册令牌重置后:dbconsole 中该清哪些令牌字段
依据一份 Stack Overflow 修订页,注册令牌重置后可在 gitlab-rails dbconsole 中执行四条 UPDATE,分别置空 projects、namespaces、application_settings 与 ci_runners 的令牌字段;材料未涉及版本适用性、旧 Runner 为何不能自动恢复,也未给出重启或重新注册步骤。
能做的事很具体:在 GitLab 实例的 gitlab-rails dbconsole 中,用四条 UPDATE 把项目、群组、实例注册令牌和 Runner 自身令牌字段置空。这来自一份 Stack Overflow 修订页,回答者称按 GitLab 官方文档的数据库清理命令解决了问题;本次材料只覆盖这段 SQL 与执行入口,不覆盖版本范围、旧 Runner 为何失效,也不覆盖之后的重启与重新注册流程。
材料说了什么,没说什么#
该修订页(来源)的核心是一组清理语句,并给出官方文档链接作为依据。本次抓取时间为 2026-11-18,来源发布日期与更新时间均未知,无法据此判断它对应哪个 GitLab 版本。
- 来源事实:四条 SQL 分别针对
projects、namespaces、application_settings、ci_runners的令牌列。 - 来源事实:执行入口是
gitlab-rails dbconsole,不是普通psql会话。 - 材料未提供:适用版本、执行前备份方式、执行后是否需要重启、旧 Runner 的恢复机制、重新注册的完整链路。这些均待核实,本文不补写。
四条清理语句分别动哪里#
按材料原文,四组字段如下。注意列名区分 *_token 与 *_token_encrypted,两者都要置空,只清一列可能留下残留。
| 目标表 | 置空字段 | 材料中的语义 |
|---|---|---|
projects | runners_token、runners_token_encrypted | 项目级 Runner 注册令牌 |
namespaces | runners_token、runners_token_encrypted | 群组级 Runner 注册令牌 |
application_settings | runners_registration_token_encrypted | 实例级注册令牌 |
ci_runners | token、token_encrypted | 已注册 Runner 的认证令牌 |
前三条对应“重置注册令牌”后旧值残留的清理,第四条则把已有 Runner 记录的认证令牌一并清掉。材料没有解释后者的连带影响,但字段语义本身提示:清空 ci_runners.token 会影响这些 Runner 记录原有的认证凭据,具体表现需在目标环境核实。
在 dbconsole 中执行的写法#
以下语句照材料转录,本次未在任何 GitLab 实例上执行,不提供预期输出。执行前应确认实例版本与备份状态。
# 进入 Rails 数据库控制台
gitlab-rails dbconsole
-- 项目级令牌
UPDATE projects SET runners_token = null, runners_token_encrypted = null;
-- 群组级令牌
UPDATE namespaces SET runners_token = null, runners_token_encrypted = null;
-- 实例级注册令牌
UPDATE application_settings SET runners_registration_token_encrypted = null;
-- 已注册 Runner 的令牌
UPDATE ci_runners SET token = null, token_encrypted = null;
操作顺序上,材料未规定先后。若只想清理注册令牌而不影响现有 Runner 记录,第四条是否需要执行,材料没有给出判断依据,应按实际故障现象决定。
执行前的边界条件#
- 版本匹配待核实。列名随 GitLab 版本演进可能变化,材料未标注版本;执行前先用
\d projects一类命令核对列是否存在,避免语句直接报错。 - 这是直接写库。绕过应用层校验,材料未提供回滚方案;执行前自备备份属于推断性建议,非来源内容。
- 清空不等于恢复。材料只说明“解决了问题”,没有说明旧 Runner 是否自动恢复、是否需要重新注册。这部分本文不作结论。
- 实例级令牌置空后,
application_settings中该令牌的再生成方式材料未涉及,待核实。
结论#
如果问题确实是注册令牌重置后旧令牌残留在库中,材料给出的路径是明确的:在 gitlab-rails dbconsole 中按表逐条置空对应令牌列。但它是一份单点经验记录,版本适用性、执行后影响与恢复链路都缺少依据;把它当作“清理动作的字段清单”使用,而不是当作完整处置流程。
参考来源
以上为本文写作时的参考资料,引用观点以原文为准。