在AWS Elastic Beanstalk部署Docker化Jenkins与PostgreSQL遇权限错误

你遇到的cannot touch '/var/jenkins_home/copy_reference_file.log': Permission denied错误，本质是Jenkins容器默认使用的jenkins用户（UID 1000）没有对/var/jenkins_home目录的写入权限。在Elastic Beanstalk的多容器环境中，挂载的主机目录权限通常和容器内用户不匹配，导致这个问题。下面是几种可行的解决方案：

方案1：启动时修改容器内目录权限（快速修复） #

在Jenkins的容器定义中添加command参数，先修改/var/jenkins_home的所有权，再启动Jenkins服务。这样每次容器启动都会确保权限正确：

{
  "AWSEBDockerrunVersion": 2,
  "containerDefinitions": [
    {
      "name": "postgres-db",
      "image": "postgres:9.5-alpine",
      "essential": true,
      "memory": 256,
      "portMappings": [
        {
          "hostPort": 5432,
          "containerPort": 5432
        }
      ]
    },
    {
      "name": "jenkins",
      "image": "jenkins/jenkins:lts",
      "essential": true,
      "memory": 512,
      "portMappings": [
        {
          "hostPort": 8080,
          "containerPort": 8080
        },
        {
          "hostPort": 50000,
          "containerPort": 50000
        }
      ],
      "command": ["/bin/sh", "-c", "chown -R jenkins:jenkins /var/jenkins_home && exec /usr/local/bin/jenkins.sh"]
    }
  ]
}

注意：确保exec命令正确，不同Jenkins镜像的启动脚本路径可能略有差异，比如部分镜像用jenkins-runner，你可以根据实际镜像调整。

方案2：以root用户运行Jenkins（不推荐，仅用于测试） #

临时可以指定Jenkins容器以root用户运行，这样就不会有权限问题，但这会带来安全风险，不建议在生产环境使用：

{
  "name": "jenkins",
  "image": "jenkins/jenkins:lts",
  "essential": true,
  "memory": 512,
  "portMappings": [
    {
      "hostPort": 8080,
      "containerPort": 8080
    },
    {
      "hostPort": 50000,
      "containerPort": 50000
    }
  ],
  "user": "root"
}

方案3：通过.ebextensions配置主机目录权限（推荐，持久化） #

这种方法更可靠，通过Elastic Beanstalk的自定义扩展配置，在实例启动时就创建并设置好Jenkins数据目录的权限，再挂载到容器中：

1. 在项目根目录创建.ebextensions/jenkins-permissions.config文件，内容如下：

container_commands:
  01_create_jenkins_dir:
    command: "mkdir -p /var/app/current/jenkins_home"
    ignoreErrors: true  # 如果目录已存在，忽略错误
  02_set_jenkins_perms:
    command: "chown -R 1000:1000 /var/app/current/jenkins_home"

2. 修改Dockerrun.aws.json，添加卷定义和挂载配置：

{
  "AWSEBDockerrunVersion": 2,
  "containerDefinitions": [
    {
      "name": "postgres-db",
      "image": "postgres:9.5-alpine",
      "essential": true,
      "memory": 256,
      "portMappings": [
        {
          "hostPort": 5432,
          "containerPort": 5432
        }
      ]
    },
    {
      "name": "jenkins",
      "image": "jenkins/jenkins:lts",
      "essential": true,
      "memory": 512,
      "portMappings": [
        {
          "hostPort": 8080,
          "containerPort": 8080
        },
        {
          "hostPort": 50000,
          "containerPort": 50000
        }
      ],
      "mountPoints": [
        {
          "sourceVolume": "jenkins-home-volume",
          "containerPath": "/var/jenkins_home"
        }
      ]
    }
  ],
  "volumes": [
    {
      "name": "jenkins-home-volume",
      "host": {
        "sourcePath": "/var/app/current/jenkins_home"
      }
    }
  ]
}

这个方案的优势是权限设置在实例初始化时完成，后续容器重启也不会再出现权限问题，同时保持了Jenkins以非root用户运行的安全性。

内容的提问来源于stack exchange，提问作者lenard-bernardo-ei