コンテナイメージマニフェストの形式

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 以降)

Docker Image Manifest V2 Schema 2 のサポートでは、次の機能が提供されます。

• 単一のイメージに複数のタグを使用する機能。

• Windows コンテナイメージを保存するためのサポート。詳細については、Amazon Elastic Container Service デベロッパーガイドの「Amazon ECR に Windows イメージをプッシュする」を参照してください。

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 はリポジトリに格納されているイメージマニフェスト形式を返します。その形式が返されるのは、その形式がクライアントによって理解される場合のみです。保存されているイメージマニフェスト形式がクライアントによって理解されない場合、Amazon ECR はイメージマニフェストを理解される形式に変換します。たとえば、Docker 1.9 クライアントが Docker Image Manifest V2 Schema 2 で保存されているイメージマニフェストをリクエストすると、Amazon ECR は Docker Image Manifest V2 Schema 1 形式でマニフェストを返します。次の表は、タグ別にイメージをプルしたときに、Amazon ECR でサポートされる利用可能な変換を示します。

クライアントによってリクエストされたスキーマ	V2、スキーマ 1 形式で ECR にプッシュされる	V2、スキーマ 2 形式で ECR にプッシュされる	OCI 形式で ECR にプッシュされる
V2、スキーマ 1	変換は必要ありません	V2、スキーマ 1 に変換される	V2、スキーマ 1 に変換される
V2、スキーマ 2	利用可能な変換はなく、クライアントは V2、スキーマ 1 にフォールバックする	変換は必要ありません	V2、スキーマ 2 に変換される
OCI	変換は利用できません	OCI に変換される	変換は必要ありません

重要

ダイジェスト別にイメージをプルした場合、利用可能な翻訳はありません。クライアントは、Amazon ECR に保存されているイメージマニフェストの形式を理解する必要があります。Docker 1.9 以前のクライアントで、Docker Image Manifest V2 Schema 2 イメージをダイジェストを使用してリクエストする場合、イメージのプルは失敗します。詳細については、Docker ドキュメントの「Registry compatibility」を参照してください。

この例では、タグで同じイメージをリクエストした場合、Amazon ECR はクライアントが理解できる形式にイメージマニフェストを変換します。イメージのプルが成功します。