如何将30-40台GitLab Runner从旧服务器迁移至性能更强的新服务器？

为什么直接复制config.toml行不通 #

直接复制旧服务器的config.toml到新机器无法完成有效迁移，核心原因包括：

• Runner的注册令牌与旧服务器的主机环境绑定，GitLab服务器会识别到新机器的不同身份，拒绝Runner接入
• Docker类型Runner依赖本地Docker镜像缓存、网络配置、容器运行时状态，这些不会随config.toml同步
• SSH类型Runner的密钥对、已知主机文件等认证数据存储在本地系统目录，仅复制配置文件会导致SSH连接失败

正确的迁移步骤 #

1. 批量注册新Runner
   从GitLab项目/群组的Runner设置页面获取注册令牌，编写批量注册脚本，快速创建与旧Runner同类型的实例。
   示例Docker Runner注册命令：

   gitlab-runner register \
     --non-interactive \
     --url "https://你的GitLab服务器地址/" \
     --registration-token "你的注册令牌" \
     --description "新服务器Docker Runner" \
     --executor "docker" \
     --docker-image "alpine:latest" \
     --tag-list "docker,new-server"
   

   对于SSH类型Runner，只需将--executor改为ssh，并添加--ssh-user、--ssh-host等参数即可。

2. 验证新Runner可用性
   在GitLab的Runner管理界面确认所有新Runner处于在线状态，手动触发几个CI/CD任务，验证Docker构建、SSH部署等流程正常运行。

3. 逐步淘汰旧Runner
   先在GitLab界面暂停旧Runner，待所有正在运行的任务完成后，在旧服务器执行gitlab-runner unregister --all-runners，再在GitLab界面删除旧Runner条目。

额外提示 #

• 可以从旧config.toml中提取标签、执行器参数（如Docker镜像、SSH端口）等配置，直接复用在批量注册脚本中，确保新Runner与旧Runner行为一致
• 迁移SSH类型Runner时，提前在新服务器配置好目标主机的SSH密钥和免密登录权限

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