自学内容网 自学内容网

GitLab 迁移后 Token 失效解决方法

在 GitLab 迁移过程中,如果未正确迁移或替换 gitlab-secrets.json 文件,会导致一些与加密相关的数据和功能失效,例如:

  1. CI/CD Runner Token 失效:CI/CD 相关的 runner token 无法匹配,导致构建失败或需要重新注册 GitLab Runner。
  2. API Token 和 Access Token 失效:用户的 API 访问令牌、OAuth 令牌、Webhooks 等失效,导致项目与外部服务(如自动化脚本、GitLab CI 任务、外部系统集成)失去连接。
  3. Repository 的 SSH 密钥无法解密: GitLab 实例使用 SSH 密钥与仓库交互,迁移后由于无法解密这些密钥,Git 操作(如 push、pull)可能会失败。

GitLab gitlab-secrets.json 文件未迁移的常见报错:

  • 500 错误:当访问 GitLab 的 Webhooks 或 CI/CD 相关页面时,可能会出现 500 Internal Server Error,提示无法读取或验证 token。
  • Invalid Token 错误:GitLab Web 界面或 API 返回 "Invalid token" 错误。
  • Runner Authentication Failed:CI 任务启动时,GitLab Runner 无法正确认证,出现 Runner authentication failed 错误。

替换 gitlab-secrets.json 的步骤:

  1. 备份旧服务器的 gitlab-secrets.json: 在旧的 GitLab 服务器上,找到并备份 /etc/gitlab/gitlab-secrets.json 文件:
cp /etc/gitlab/gitlab-secrets.json /path/to/backup/gitlab-secrets.json
  1. 将备份文件复制到新服务器: 在新的 GitLab 服务器中,将备份的 gitlab-secrets.json 文件复制到 /etc/gitlab/ 目录下:
scp /path/to/backup/gitlab-secrets.json root@new-gitlab-server:/etc/gitlab/
  1. 替换新的 gitlab-secrets.json: 覆盖新服务器上已经生成的 gitlab-secrets.json
mv /etc/gitlab/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json.bak
cp /path/to/backup/gitlab-secrets.json /etc/gitlab/gitlab-secrets.json
  1. 验证文件完整性: 使用 md5sum 检查文件是否一致:
md5sum /etc/gitlab/gitlab-secrets.json
  1. 重新加载配置并重启 GitLab 服务
    • 重新加载 GitLab 配置文件:
gitlab-ctl reconfigure
    • 重启 GitLab 服务:
gitlab-ctl restart

通过这些步骤替换 gitlab-secrets.json 文件后,GitLab 应该可以恢复对所有加密数据(如 tokens、webhooks、runner 等)的正常访问。如果不进行此操作,GitLab 会无法解密 token,导致相关功能出现故障,通常表现为 token 无法验证或 API 调用失败等问题。


原文地址:https://blog.csdn.net/fanhonooo/article/details/142355542

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!