如何在AWS ECS中配置Dockerfile的healthcheck及不生效问题排查

1. ECS运行环境版本不支持读取Docker原生HEALTHCHECK指令
   • Fargate启动类型下，1.3.0及更早的平台版本不支持解析Dockerfile中的HEALTHCHECK配置，就算不在ECS侧配置健康检查参数，也不会自动执行Docker原生的健康检测
   • EC2启动类型下，ECS实例上安装的ecs-agent版本低于1.18.0时，同样不支持读取Dockerfile中的健康检查配置
2. Dockerfile内HEALTHCHECK指令本身异常
   指令配置的命令存在依赖缺失（比如配置了curl但容器内没安装curl工具）、路径错误、执行权限不足、运行返回非0值等问题，会导致健康检查实际执行失败，看起来像是ECS没有执行检测
3. 误判覆盖逻辑
   只有当ECS任务定义的容器健康检查参数存在显式配置时，才会覆盖Dockerfile的HEALTHCHECK，不存在"没配置ECS参数就会默认覆盖原生配置"的逻辑

• 优先升级ECS运行环境到支持原生HEALTHCHECK的版本：
  • Fargate启动类型将平台版本升级到1.4.0及以上，建议直接使用LATEST标签的平台版本
  • EC2启动类型将实例上的ecs-agent升级到1.18.0及以上版本
• 验证Dockerfile HEALTHCHECK有效性：启动对应镜像的本地容器，手动执行HEALTHCHECK配置的命令，比如你的指令是HEALTHCHECK --interval=30s --timeout=3s CMD curl -f http://127.0.0.1/health || exit 1，则进入容器后执行curl -f http://127.0.0.1/health || exit 1，确认命令可以正常返回0，无报错
• 如果无法升级环境，直接在ECS任务定义的容器配置中显式添加健康检查参数，参数和Dockerfile中配置的保持一致即可，各参数对应关系如下：
  • ECS健康检查command参数，对应Dockerfile中HEALTHCHECK的CMD后执行的命令
  • ECSinterval参数，对应Dockerfile的--interval配置，默认30秒
  • ECStimeout参数，对应Dockerfile的--timeout配置，默认30秒
  • ECSretries参数，对应Dockerfile的--retries配置，默认3次
  • ECSstartPeriod参数，对应Dockerfile的--start-period配置，默认0秒
• 调整完成后重新注册任务定义，更新ECS服务即可生效

内容的提问来源于stack exchange，提问作者brouk.develop