为何Jenkins工作空间执行docker compose up提示找不到配置文件？

在Ubuntu系统中，在Jenkins工作空间目录/var/lib/jenkins/workspace/minimal-react-app下执行docker compose up -d命令时，提示“no configuration file provided: not found”，但执行ls命令可见目录下存在dist、docker、docker-compose.yml文件；而将相同文件放在用户主目录/home/ubuntu/minimal-react-app下执行该命令则可正常运行，请问这一差异的原因是什么？

# Jenkins工作空间下执行失败
root@VM-0-7-ubuntu:/var/lib/jenkins/workspace/minimal-react-app# ls
dist  docker  docker-compose.yml
root@VM-0-7-ubuntu:/var/lib/jenkins/workspace/minimal-react-app# docker compose up -d
no configuration file provided: not found  # <----- 原因？
 
# 用户主目录下执行成功
root@VM-0-7-ubuntu:/home/ubuntu/minimal-react-app# ls
dist  docker  docker-compose.yml
root@VM-0-7-ubuntu:/home/ubuntu/minimal-react-app# docker compose up -d
[+] Running 7/7
 ✔ nginx 6 layers [⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled    
# ...

可能的原因分析 #

1. 文件权限不匹配 #

Jenkins工作空间目录/var/lib/jenkins默认归属jenkins用户和组，即便你用root身份执行命令，Docker daemon可能以非root用户（比如docker用户或jenkins用户）运行，导致无法读取该目录下的docker-compose.yml。而用户主目录/home/ubuntu的权限策略通常更宽松，root或普通用户都能正常访问文件。

可以用以下命令检查权限细节：

ls -l /var/lib/jenkins/workspace/minimal-react-app/docker-compose.yml

如果文件所属用户/组为jenkins:jenkins，且Docker运行用户无读取权限，就会触发“找不到文件”的错误。

2. Docker的用户隔离或上下文限制 #

若通过Jenkins插件调用Docker，任务执行时可能默认以jenkins用户身份运行，该用户的权限范围受限制，即便手动切换到root执行，Docker daemon的运行上下文仍可能无法穿透Jenkins的目录权限隔离。另外，Docker的用户命名空间隔离机制也可能导致无法读取Jenkins工作空间的文件，而用户主目录不在隔离范围内。

3. 文件名存在不可见字符或拼写差异 #

虽然ls显示存在docker-compose.yml，但实际文件名可能包含空格、制表符等不可见字符，或是大小写不符合（比如Docker-Compose.yml）。在用户主目录复制文件时，可能自动修正了这些异常，而Jenkins工作空间的文件是直接生成或拉取的，保留了这些问题。

用以下命令查看文件名的原始格式：

ls -b /var/lib/jenkins/workspace/minimal-react-app/

如果输出类似docker-compose.yml\ ，说明文件名末尾有空格。

4. Jenkins工作空间的特殊挂载属性 #

Jenkins工作空间可能通过NFS、tmpfs等特殊文件系统挂载，或是目录设置了noexec、nodev等限制属性，导致Docker无法读取该目录下的配置文件。用户主目录通常是本地普通文件系统，没有这类限制。

用以下命令检查挂载类型：

mount | grep /var/lib/jenkins

若发现是特殊挂载，可调整挂载参数或把配置文件复制到普通目录后再执行Docker命令。

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