GitLab Runner仅在gitlab-runner run进程运行时才执行流水线问题求助

1. 修改GitLab Runner服务的运行用户 #

systemctl默认以root启动gitlab-runner，但你的Runner只有非root用户运行时才接收作业，核心问题就在服务运行身份不匹配：

• 编辑服务配置：sudo systemctl edit gitlab-runner.service
• 在弹出的编辑界面中添加以下内容（替换成你的非root用户名和用户组）：

[Service]
User=your_non_root_user
Group=your_non_root_group

• 保存退出后，重新加载服务配置：sudo systemctl daemon-reload

2. 修复非root用户的权限问题 #

确保非root用户能访问GitLab Runner的核心目录和资源：

sudo chown -R your_non_root_user:your_non_root_group /etc/gitlab-runner
sudo chown -R your_non_root_user:your_non_root_group /home/your_non_root_user/.gitlab-runner

同时确认该用户有执行shell作业的基础权限——比如能正常运行git、访问项目仓库目录等。

3. 重新注册Runner（可选但建议） #

如果之前是用root注册的Runner，配置里的权限关联可能有遗留问题，用非root用户重新注册更稳妥：

• 切换到目标非root用户：su - your_non_root_user
• 执行注册命令：gitlab-runner register，按提示完成流程，确认选择shell执行器

4. 重启服务并验证 #

• 重启服务：sudo systemctl restart gitlab-runner
• 检查服务状态：sudo systemctl status gitlab-runner，确认服务是以指定的非root用户运行
• 查看Runner状态：gitlab-runner list，确认Runner处于活跃状态，提交测试流水线验证是否正常执行

排查小技巧 #

• 服务启动失败就看日志：journalctl -u gitlab-runner.service，根据错误提示定位（比如权限不足、配置文件语法错）
• 先手动用非root用户跑gitlab-runner run，确认无报错后再转服务模式

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