在Kubernetes的Jenkins实例中使用Docker-Compose挂载空卷问题

嘿，我之前在GKE上部署默认配置的Jenkins做概念验证时，也碰到过几乎一模一样的问题！咱们一步步来拆解排查，应该能快速解决：

1. 先确认Docker在Pod里能不能正常跑 #

你手动装了Docker客户端，但默认Jenkins Pod里是没启动Docker Daemon的——这就好比你装了浏览器但没开网络，肯定没法用。先在Pod里跑个命令验证下：

docker ps

如果报错说“连不上Docker daemon”，那核心问题就在这了。概念验证阶段可以临时启动daemon试试：

# 如果Pod里有systemd的话
sudo systemctl start docker
# 要是没systemd，直接用dockerd命令启动
sudo dockerd &

不过这里大概率会碰到权限问题，因为默认Jenkins Pod是用非root用户运行的，接下来咱们解决这个。

2. 给Jenkins Pod加权限 #

默认Jenkins用的是jenkins用户（UID 1000），这用户没权限操作Docker或者修改目录权限。最简单的办法是修改Jenkins的Deployment配置，让Pod以root用户运行：

# 找到你的Jenkins Deployment的spec.template.spec部分
spec:
  template:
    spec:
      securityContext:
        runAsUser: 0
        runAsGroup: 0

更新配置后重启Pod，再操作Docker就不用加sudo了，挂载卷的权限问题也会少很多。

3. 检查挂载目录的权限和存在性 #

如果你的Docker-Compose配置里是挂载Pod内的空目录（比如./empty:/app/test），得先确保这个empty目录存在，而且当前用户能读写。可以在Jenkins任务的测试步骤前加两行命令：

mkdir -p ./empty
chmod 777 ./empty  # 概念验证阶段先这么搞，生产环境记得改更严格的权限

另外，也可以在docker-compose.yml里给卷加权限标签：

volumes:
  - ./empty:/app/test:rw,z

:z是SELinux的共享标签，有些K8s环境下必须加这个才能正常挂载。

4. （后续优化参考）别手动装工具啦！ #

虽然你现在是概念验证，但还是提一句：后续真要落地的话，直接用预装了Docker和Docker-Compose的Jenkins镜像（比如jenkinsci/docker-in-docker），能省掉超多权限和环境配置的麻烦，比手动安装靠谱多了。

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