Amazon ECR
用户指南 (API Version 2015-09-21)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

容器映像清单格式

Amazon ECR 支持以下容器映像清单格式:

  • Docker Image Manifest V2 Schema 1 (与 Docker 版本 1.9 和更早版本配合使用)

  • Docker Image Manifest V2 Schema 2 (与 Docker 版本 1.10 和更新版本配合使用)

  • Open Container Initiative (OCI) 规范草案 (v1.0-RC1 和更高版本)

对 Docker Image Manifest V2 Schema 2 的支持可提供以下功能:

  • 能够为每个映像使用多个标签。

  • 支持存储 Windows 容器映像。有关更多信息,请参阅 Amazon Elastic Container Service Developer Guide 中的将 Windows 映像推送到 Amazon ECR

Amazon ECR 映像清单转换

在 Amazon ECR 中推送和拉取映像时,您的容器引擎客户端 (例如 Docker) 将与注册表进行通信以就客户端了解的清单格式以及要用于映像的注册表达成一致。

在使用 Docker 版本 1.9 或更旧版本将映像推送到 Amazon ECR 时,映像清单格式将存储为 Docker Image Manifest V2 Schema 1。在使用 Docker 版本 1.10 或更新版本将映像推送到 Amazon ECR 时,映像清单格式将存储为 Docker Image Manifest V2 Schema 2。

在从 Amazon ECR 按标签提取映像时,Amazon ECR 将返回存储在存储库中的映像清单格式 (但仅在客户端了解该格式的情况下这样做)。如果客户端不了解存储的映像清单格式 (例如,如果 Docker 1.9 客户端请求存储为 Docker Image Manifest V2 Schema 2 的映像清单),Amazon ECR 会将映像清单转换为客户端了解的格式 (在此情况下,为 Docker Image Manifest V2 Schema 1)。下表描述了在按标签拉取映像时,Amazon ECR 支持的可用转换:

客户端请求的架构 作为 V2 Schema 1 推送到 ECR 作为 V2 Schema 2 推送到 ECR 作为 OCI 推送到 ECR
V2 Schema 1 无需转换 已转换为 V2 Schema 1 已转换为 V2 Schema 1
V2 Schema 2 无可用转换,客户端将回退到 V2 Schema 1 无需转换 已转换为 V2 Schema 2
OCI 无可用转换 已转换为 OCI 无需转换

重要

如果您按摘要拉取映像,则无可用转换;您的客户端必须了解存储在 Amazon ECR 中的映像清单格式。如果您在 Docker 1.9 或更旧版本的客户端上按摘要请求 Docker Image Manifest V2 Schema 2 映像,则无法拉取映像。有关更多信息,请参阅 Docker 文档中的注册表兼容性

但在此示例中,如果按标签请求同一映像,Amazon ECR 会将映像清单转换为客户端可了解的格式,并且将成功拉取映像。