技术文章

外部链接将在新标签页打开。

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,两者都要置空,只清一列可能留下残留。

目标表置空字段材料中的语义
projectsrunners_token、runners_token_encrypted项目级 Runner 注册令牌
namespacesrunners_token、runners_token_encrypted群组级 Runner 注册令牌
application_settingsrunners_registration_token_encrypted实例级注册令牌
ci_runnerstoken、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 中按表逐条置空对应令牌列。但它是一份单点经验记录,版本适用性、执行后影响与恢复链路都缺少依据;把它当作“清理动作的字段清单”使用,而不是当作完整处置流程。

参考来源

  1. Revision db09a612-feba-461f-b78e-4a8f37d983ac

以上为本文写作时的参考资料,引用观点以原文为准。

作者:沐小悠

本文约 5 分钟读完 · 关键词:GitLab Runner、注册令牌重置、ci_runners、runners_token、数据库清理

更多文章 GET 示例接口