基于scratch镜像的AWS Fargate任务自定义健康检查异常问题

问题根源 #

AWS ECS的容器健康检查命令必须以CMD或CMD-SHELL开头，直接指定二进制路径不符合格式要求——哪怕你的健康检查二进制能正常访问/health端点，Fargate也无法正确识别健康状态。

可行解决方案 #

1. 用CMD格式指定健康检查命令

因为Scratch镜像没有Shell，直接使用CMD模式调用你的健康检查二进制，ECS任务定义中的健康检查命令需配置为：

CMD ["/app/healthcheck"]

• 这是JSON数组格式，对应Docker中HEALTHCHECK CMD的执行模式，Fargate会直接启动二进制进程，无需依赖Shell
• 确保Dockerfile中已正确赋予二进制可执行权限：COPY --chmod=755 healthcheck /app/healthcheck

2. 把健康检查逻辑嵌入主应用

如果不想维护独立的健康检查二进制，可以在Go主应用中添加子命令逻辑：

// 示例：在主应用中添加healthcheck子命令
func main() {
    cmd := &cobra.Command{
        Use:   "healthcheck",
        Run: func(cmd *cobra.Command, args []string) {
            // 调用本地/health端点，成功返回0，失败返回非0
            resp, err := http.Get("http://localhost:8080/health")
            if err != nil || resp.StatusCode != http.StatusOK {
                os.Exit(1)
            }
            os.Exit(0)
        },
    }
    // ... 其他主命令逻辑
    if err := cmd.Execute(); err != nil {
        os.Exit(1)
    }
}

然后ECS健康检查命令配置为：

CMD ["/app/your-main-app", "healthcheck"]

3. 验证健康检查二进制的退出码

Fargate完全通过命令的退出码判断健康状态：

• 健康状态必须返回0
• 不健康状态返回非0值（如1）
  检查你的healthcheck二进制是否正确设置了退出码，比如在Go代码中用os.Exit(0)或os.Exit(1)对应不同状态。

额外配置注意事项 #

• ECS任务定义中，健康检查的interval（间隔）、timeout（超时）、retries（重试次数）要匹配你的应用响应速度，避免因超时导致误判
• 确认容器内的网络配置允许healthcheck二进制访问本地的/health端点（比如端口是否正确，是否有内部网络限制）

内容的提问来源于stack exchange，提问作者Nikola-Milovic