如何备份恢复GitLab Runner，重装系统后无需重新配置？

必须备份的核心内容 #

• 核心配置文件：/etc/gitlab-runner/config.toml
  这个文件存储了所有你注册到gitlab.com的Runner凭证、执行器配置、并发规则、标签设置、缓存规则等所有核心参数，注意该文件默认权限为root只读，备份时请保留文件权限属性，避免泄露注册token
• 自定义服务配置（如果有修改过才需要备份）：/etc/systemd/system/gitlab-runner.service（Systemd发行版）或对应SysVinit/Upstart的服务配置文件
• 自定义数据（根据你的使用场景选择备份）：
  如果你使用shell、虚拟机等本地执行器，并且在Runner运行环境中存储了自定义依赖、全局脚本、构建缓存，需要备份对应路径，默认shell执行器的工作目录为/home/gitlab-runner/下的构建子目录，缓存路径可查看config.toml中cache段的配置

重装系统后恢复步骤 #

1. 首先在新系统中安装和原环境大版本一致的GitLab Runner，避免配置兼容性问题
2. 停止GitLab Runner服务：

   sudo systemctl stop gitlab-runner
   

3. 将备份的config.toml覆盖到/etc/gitlab-runner/路径下，修正文件权限：

   sudo chown root:root /etc/gitlab-runner/config.toml
   sudo chmod 600 /etc/gitlab-runner/config.toml
   

4. 如果你备份了自定义服务配置，将文件放回原路径后重载系统服务配置：

   sudo systemctl daemon-reload
   

5. 启动GitLab Runner服务：

   sudo systemctl start gitlab-runner
   

6. 验证Runner连通性，正常会提示所有注册的Runner状态为alive，无需重新到gitlab.com注册：

   sudo gitlab-runner verify
   

可选验证操作 #

你可以登录gitlab.com进入对应仓库的「设置」→「CI/CD」→「Runner」页面，确认目标Runner状态显示为在线，也可以手动触发一次CI任务验证运行正常即可。

内容的提问来源于stack exchange，提问作者GaryO