使用docker-compose部署多容器应用至AWS Elastic Beanstalk遇故障求助

一、解决"Configuration files cannot be extracted"警告 #

• 检查zip包结构：压缩时必须直接选中AppDirectory下的所有文件/文件夹，不能把AppDirectory本身作为外层文件夹打包。EB要求根目录下直接存在docker-compose.yml、Dockerfile等核心文件，不允许嵌套层级。
• 验证包内容：手动解压zip包，确认根目录能直接看到docker-compose.yml、Dockerfile，没有多余的外层文件夹。

二、修复Nginx 502 Bad Gateway错误 #

• 确认端口映射规则：EB默认对外暴露80端口，需确保应用容器将服务端口映射到主机80端口，或通过EB配置指定端口。示例配置：

  services:
    app:
      image: your-dockerhub-username/app-image:latest
      ports:
        - "80:8000" # 假设应用内部使用8000端口
    proxy:
      image: your-dockerhub-username/proxy-image:latest
      ports:
        - "80:80"
      depends_on:
        - app
  

• 修正容器间通信地址：proxy容器访问app服务时，不能用localhost，必须使用docker-compose中定义的服务名（比如app:8000）。
• 添加私有镜像认证：如果Docker Hub镜像是私有仓库，需在EB环境配置的「软件」→「环境属性」中添加DOCKER_USER和DOCKER_PASS两个变量，填入你的Docker Hub账号密码。

三、获取环境日志（即使环境处于"更新"状态） #

• 使用AWS CLI拉取日志：本地配置好AWS CLI权限后，执行以下命令：

  aws elasticbeanstalk request-environment-info --environment-name your-env-name --info-type tail
  aws elasticbeanstalk retrieve-environment-info --environment-name your-env-name --info-type tail
  

• 直接查看EC2实例日志：登录环境对应的EC2实例，查看/var/log/eb-engine.log（部署流程日志）和/var/log/docker.log（容器运行日志），这两个文件能直接定位部署或容器启动的错误。

额外注意事项 #

• 选择正确的EB平台：必须选「Multi-container Docker」平台，而非单一容器的Docker平台。
• 兼容docker-compose语法：EB仅支持到docker-compose 3.7版本的语法，不要使用swarm模式相关的deploy字段等新特性。
• 精简上传包：既然镜像已推送到Docker Hub，本地的Dockerfile、requirements.txt、app/等构建相关文件无需打包上传，只保留docker-compose.yml即可，避免触发不必要的本地构建流程。

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