ECS Fargate部署Docker镜像报容器启动系列错误如何解决？

报错根因 #

1. 首次报错核心原因：任务定义中entryPoint格式完全错误，你错误地将JSON数组的语法字符串拆成了两个独立元素，系统会把第一个元素[\"/bin/sh -c\"当做可执行文件查找，自然找不到对应路径。
2. 修改后的二次报错原因：调整后的entryPoint存在转义或格式解析问题，导致系统没有把-c识别为/bin/sh的参数，反而将其当做独立的可执行文件去执行，触发路径找不到报错。
3. 本地无法进入容器的核心原因：大概率是镜像构建阶段存在问题，比如COPY的本地文件路径错误、文件未成功写入镜像。

修复步骤 #

1. 修正Dockerfile配置 #

首先确认COPY的源路径是Docker构建上下文下的正确相对路径，同时添加执行权限的命令写入Dockerfile，参考配置如下：

FROM centos:7
COPY /src/main/build/application.zip /tmp/application.zip
COPY /src/main/residual-container-setup/application/init.sh /tmp/init.sh
# 给init脚本赋予执行权限
RUN chmod +x /tmp/init.sh
# 调试阶段可添加下方命令，构建时确认文件是否存在
# RUN ls -l /tmp/ && cat /tmp/init.sh

构建镜像时如果出现COPY失败的报错，直接调整源路径到正确位置即可。

2. 修正ECS任务定义entryPoint配置 #

entryPoint为字符串数组格式，每个参数为独立元素，不要添加多余的转义字符，正确配置如下：

"entryPoint": ["/bin/sh", "-c", "/tmp/init.sh"]

如果是通过AWS控制台可视化填写entryPoint，不需要手动加JSON引号和转义，按参数分行填写即可：第一行填/bin/sh，第二行填-c，第三行填/tmp/init.sh，避免控制台自动转义导致格式错误。

3. 本地先验证镜像可用性 #

镜像构建完成后先不要推ECR，本地执行命令验证：

• 验证文件是否成功写入镜像：docker run --rm $docker_image ls /tmp/，确认输出中包含application.zip和init.sh
• 验证脚本可正常执行：docker run --rm $docker_image /tmp/init.sh，确认脚本可正常启动
• 验证可进入容器：docker run -it $docker_image /bin/sh，如果该命令无法执行，先单独测试基础镜像可用性：docker run -it centos:7 /bin/sh，如果基础镜像能正常进入，说明你自己构建的镜像存在问题，优先排查COPY、RUN阶段的异常。

所有本地验证通过后，再将镜像推送到ECR，重新更新ECS任务定义部署即可。

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