复制文件到Jenkins Docker容器后重启失败，如何解决权限问题？

问题根源 #

Jenkins官方Docker镜像默认使用UID为1000的jenkins用户运行容器内服务。你从EC2主机复制到容器/var/jenkins_home的文件，权限属于主机的root用户（或其他非1000 UID用户），导致容器内的jenkins用户没有读写权限，进而无法创建copy_reference_file.log文件。

解决方案 #

方法1：在EC2主机上修改备份文件权限后再复制 #

1. 解压S3下载的备份包后，进入解压后的目录（假设解压后目录为jenkins_home）：

   cd jenkins_home
   

2. 修改整个目录的所有者为UID 1000（对应容器内的jenkins用户）：

   sudo chown -R 1000:1000 .
   

3. 再将文件复制到容器内：

   docker cp . my-jenkins:/var/jenkins_home
   

4. 重启容器即可正常启动：

   docker restart my-jenkins
   

方法2：以root用户进入容器修改权限 #

如果已经将文件复制到容器内，可通过以下步骤修正权限：

1. 停止故障容器：

   docker stop my-jenkins
   

2. 以root用户启动临时容器，挂载故障容器的存储：

   docker run -it --user root --name temp-jenkins --volumes-from my-jenkins jenkins/jenkins:2.387.3 bash
   

3. 在临时容器内修改/var/jenkins_home的权限：

   chown -R jenkins:jenkins /var/jenkins_home
   

4. 退出临时容器，删除后重启原容器：

   exit
   docker rm temp-jenkins
   docker start my-jenkins
   

方法3：使用Docker卷规范备份/恢复（推荐） #

使用Docker卷可以避免直接操作容器内文件的权限问题，步骤更规范：

备份流程

1. 启动Jenkins时挂载Docker卷：

   docker run -d --name my-jenkins -p 8080:8080 --restart on-failure -v jenkins-home:/var/jenkins_home jenkins/jenkins:2.387.3
   

2. 打包卷内内容到EC2主机：

   docker run --rm -v jenkins-home:/var/jenkins_home -v $(pwd):/backup alpine tar czf /backup/jenkins.tar.gz -C /var/jenkins_home .
   

3. 上传到S3：

   aws s3 cp jenkins.tar.gz s3://dcp-jenkins-backup/
   

恢复流程

1. 创建新的Docker卷：

   docker volume create jenkins-home
   

2. 提前设置卷的权限（确保容器内jenkins用户可读写）：

   docker run --rm -v jenkins-home:/var/jenkins_home jenkins/jenkins:2.387.3 chown -R 1000:1000 /var/jenkins_home
   

3. 从S3下载备份并解压到卷内：

   aws s3 cp s3://dcp-jenkins-backup/jenkins.tar.gz .
   docker run --rm -v jenkins-home:/var/jenkins_home -v $(pwd):/backup alpine tar xzf /backup/jenkins.tar.gz -C /var/jenkins_home
   

4. 启动Jenkins容器挂载该卷：

   docker run -d --name my-jenkins -p 8080:8080 --restart on-failure -v jenkins-home:/var/jenkins_home jenkins/jenkins:2.387.3
   

为什么主机直接运行Jenkins无此问题？ #

主机直接运行Jenkins时，你通常以root或与Jenkins运行用户权限一致的账号操作文件，不存在用户空间隔离的权限限制；而Docker容器是独立的用户空间，容器内服务运行用户（jenkins）与主机用户权限不共享，因此会触发权限问题。

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