GitLab CI流水线查找.gitconfig路径不符及权限问题求助

一、先修复核心错误：could not lock config file /home/gitlab-runner/.gitconfig: no such file or directory #

这个错误的根源是gitlab-runner用户的家目录/home/gitlab-runner不存在，导致Git无法创建或写入全局配置文件。按以下步骤解决：

1. 验证用户家目录配置
   先确认系统中gitlab-runner用户的家目录设置：

   getent passwd gitlab-runner
   

   正常输出应该包含/home/gitlab-runner作为家目录（例如：gitlab-runner:x:1001:1001:GitLab Runner:/home/gitlab-runner:/bin/bash）。

2. 创建并修复家目录权限
   手动创建家目录并赋予gitlab-runner用户完全控制权：

   sudo mkdir -p /home/gitlab-runner
   sudo chown gitlab-runner:gitlab-runner /home/gitlab-runner
   sudo chmod 700 /home/gitlab-runner
   

   -p参数确保父目录不存在时也能创建，chown将目录所有权转交给目标用户，chmod 700保证只有该用户能访问目录。

3. 提前初始化Git全局配置（可选）
   为避免流水线重复配置时出问题，可直接切换到gitlab-runner用户完成配置：

   sudo su - gitlab-runner
   git config --global user.email 'myname@test.com'
   git config --global user.name 'myname'
   exit
   

   完成后流水线的before_script配置可保留也可移除，因为配置已提前生效。

二、为什么流水线会查找/home/gitlab-runner/.gitconfig而非你的用户目录？ #

核心原因是GitLab Runner的运行身份：

• GitLab Runner默认是以gitlab-runner这个系统用户的身份执行流水线任务的，而非你登录EC2时使用的普通用户或root用户。
• Git的--global参数是针对当前执行命令的用户的全局配置，存储路径为该用户家目录下的.gitconfig。所以流水线中执行git config --global时，Git会去gitlab-runner用户的家目录（即/home/gitlab-runner）查找配置文件，而非你个人用户的家目录。

三、关于sudo useradd未创建家目录的疑问 #

你使用的sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash命令，理论上应该自动创建/home/gitlab-runner目录。如果未创建，可能的原因有：

• /home分区磁盘空间不足，无法创建目录
• 系统useradd默认配置文件（/etc/default/useradd）中CREATE_HOME被设为no，尽管命令行参数优先级更高，但部分系统可能存在异常
• 执行useradd时出现未被捕获的错误（比如权限问题，但你用了sudo，这种情况概率极低）

四、手动创建目录时权限拒绝的原因 #

你执行sudo mkdir gitlab-runner时出现权限拒绝，大概率是因为没有指定完整路径/home/gitlab-runner，而是在当前工作目录（比如/root或其他受限目录）下尝试创建同名目录，而当前目录的权限不允许sudo创建该目录。指定完整路径/home/gitlab-runner即可解决这个问题，也就是我们前面步骤中的命令。

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