部署Jib构建的Docker镜像至AWS Elastic Beanstalk时遇目录缺失错误

问题根源 #

这个报错是Elastic Beanstalk的ECS代理在启动时，默认尝试监控/managed-agents/serviceconnect目录，但单容器Docker环境不需要ECS Service Connect功能，且镜像中也没有这个目录，导致代理启动失败，进而引发部署报错。

解决方案 #

下面是几个直接有效的解决办法，按优先级尝试：

1. 修改Dockerrun.aws.json添加环境变量
   在你的Dockerrun.aws.json文件中，给容器添加ECS_DISABLE_SERVICE_CONNECT_WATCHER环境变量，直接禁用ECS代理的Service Connect监控功能。示例配置如下：

   {
     "AWSEBDockerrunVersion": "1",
     "Image": {
       "Name": "你的Jib构建镜像名:标签",
       "Update": "true"
     },
     "Ports": [
       {
         "ContainerPort": "你的应用端口"
       }
     ],
     "environment": [
       {
         "name": "ECS_DISABLE_SERVICE_CONNECT_WATCHER",
         "value": "true"
       }
     ]
   }
   

   修改后重新打包部署即可。

2. 通过.ebextensions配置ECS代理参数
   如果修改Dockerrun文件无效，可通过Elastic Beanstalk的自定义配置文件直接修改ECS代理的全局配置：

   • 在项目根目录创建.ebextensions文件夹
   • 新建ecs-proxy-disable-service-connect.config文件，写入以下内容：

     container_commands:
       01_disable_service_connect_watcher:
         command: echo "ECS_DISABLE_SERVICE_CONNECT_WATCHER=true" >> /etc/ecs/ecs.config
     

   将这个配置文件和应用代码一起打包部署，它会在环境启动时自动修改ECS代理的配置。

3. 确认Jib镜像构建配置
   虽然你已经确认镜像中没有目标目录，但可以快速检查Jib的构建配置：

   • 查看是否有extraDirectories配置误指向了/managed-agents/serviceconnect路径
   • 确认应用启动脚本中没有尝试创建或访问该路径的逻辑

补充说明 #

这个问题是AWS ECS代理新版本引入的默认行为，单容器Docker环境并不依赖Service Connect功能，所以禁用该监控是最直接的解决方式，无需重建环境或修改镜像本身。

内容的提问来源于stack exchange，提问作者Kedarnath Yadav D