AWS ECS运行任务报CannotPullContainerError镜像未找到问题咨询

:latest后缀的来源 #

这是OCI容器生态的通用默认规则，*所有容器运行时（包括ECS底层的容器运行环境）*在处理镜像引用时，如果没有显式指定标签（即:标签名部分），都会自动追加:latest作为默认标签，该行为和ECS无关，是容器领域的通用约定。

报错原因 #

你认知中“不带:后缀的镜像”本身不存在，你填写的id.dkr.ecr.us-east-1.amazonaws.com/thing/1234567只是ECR仓库的地址，不是完整的镜像引用，完整镜像引用必须包含标签部分。你仓库中该镜像没有打latest标签，所以运行时自动补全的xxx:latest地址不存在，就触发了拉取失败报错。

解决方法 #

• 第一步：先确认镜像的实际标签，执行AWS CLI命令查询：
  aws ecr describe-images --repository-name thing/1234567 --region us-east-1
  返回结果中的imageTags字段即为该镜像绑定的实际标签，例如v1、prod等。
• 第二步：根据需求选择对应方案：
  1. 不需要用latest标签的场景：直接修改ECS任务定义，在镜像地址后显式追加实际标签即可，例如实际标签为v1就填写为id.dkr.ecr.us-east-1.amazonaws.com/thing/1234567:v1，显式指定标签后就不会触发自动追加latest的逻辑。
  2. 希望保留不带标签的填写方式的场景：给现有镜像追加latest标签后推送至ECR即可，操作命令如下：

# 替换<实际标签>为你上一步查询到的标签值
docker tag id.dkr.ecr.us-east-1.amazonaws.com/thing/1234567:<实际标签> id.dkr.ecr.us-east-1.amazonaws.com/thing/1234567:latest
docker push id.dkr.ecr.us-east-1.amazonaws.com/thing/1234567:latest

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