当我的任务无法在 Amazon ECS 集群中启动时，如何解决“Image does not exist”（映像不存在）错误？

简短描述

当从 Amazon Elastic Container Registry (Amazon ECR) 私有存储库拉取映像时，您会收到此错误。

如果您没有收到此错误消息，请为您的问题或错误消息选择以下解决方法之一：

• 您的容器由于应用程序问题或资源限制而退出。要解决此问题，请参阅如何对容器退出时停止或无法启动的 Amazon ECS 任务进行故障排除？
• 应用程序负载均衡器的运行状况检查失败。要解决此问题，请参阅如何让使用 Amazon EC2 启动类型的 Amazon ECS 任务通过应用程序负载均衡器运行状况检查？
• Docker 无法提取容器映像。要解决此问题，请参阅 Amazon ECS 中的 CannotPullContainer 任务错误。
• 您会收到类似于以下内容的错误消息：“[AWS service] was unable to place a task because no container instance met all of its requirements”（[AWS 服务] 无法下达任务，因为没有容器实例满足其所有要求）。要解决此问题，请参阅如何解决 Amazon ECS 中的错误“[AWS service] was unable to place a task because no container instance met all of its requirements”（[AWS 服务] 无法下达任务，因为没有容器实例满足其所有要求）？
• 您会收到类似于以下内容的错误消息：“[AWS service] was unable to place a task because no container instance met all of its requirements.The closest matching container-instance container-instance-id has insufficient CPU units available”（[AWS 服务] 无法下达任务，因为没有容器实例满足其所有要求。匹配最接近的容器实例 container-instance-id 可用的 CPU 单元不足）。或者，请参阅如何解决 Amazon ECS 中的错误“the closest matching container-instance container-instance-id has insufficient CPU units available”（匹配最接近的容器实例 container-instance-id 可用的 CPU 单元不足）？
• 您会收到类似于以下内容的错误消息：“[AWS service] was unable to place a task because no container instance met all of its requirements.The closest matching container-instance container-instance-id encountered error "AGENT"（[AWS 服务] 无法下达任务，因为没有容器实例满足其所有要求。匹配最接近的容器实例 container-instance-id 遇到错误“AGENT”）。要解决此问题，请参阅如何解决 Amazon ECS 中我的服务的错误“the closest matching container-instance container-instance-id encountered error 'AGENT'”（匹配最接近的容器实例 container-instance-id 遇到错误“AGENT”）？

**注意：**要对 Amazon ECS 服务问题进行故障排除，请在服务事件日志中查看诊断信息。

解决方法

**注意：**如果在运行 AWS 命令行界面 (AWS CLI) 命令时收到错误，请参阅 AWS CLI 错误故障排除。此外，请确保您使用的是最新版本的 AWS CLI。

要解决 Image does not exist（映像不存在）错误，请完成以下步骤：

1. 验证映像是否已在您的 Amazon ECS 任务定义中声明。有关详细信息，请参阅映像。
2. 验证 Docker 映像是否存在于 Amazon ECR 存储库中。有关详细信息，请参阅在 Amazon ECR 中查看映像详细信息。要查看存储库信息，请使用 Amazon ECR 控制台。或者运行以下命令。
   要确认映像是否存在于 ECR 存储库中，请运行 list-images 命令：

   aws ecr list-images --repository-name "hello-world"  --region us-east-1

   要筛选 ECR 存储库中的映像，请运行 describe-images 命令：

   aws ecr describe-images --repository-name "hello-world" --region us-east-1 --query 'sort_by(imageDetails,& imagePushedAt)[*]'

   **注意：**请将 repository-name 和 region 替换为您的值。
3. 在任务定义中指定 Amazon ECR 映像。使用映像的完整 URI。有关详细信息，请参阅 Amazon ECR 映像和任务定义 IAM 角色。
   **重要事项：**验证映像的 URI 中是否没有前导或尾随的字符空格。

相关信息

Amazon ECR 中的私有映像