Azure Container Registry のマルチアーキテクチャイメージ

[アーティクル]
10/31/2023

この記事では、マルチアーキテクチャ (multi-arch) イメージと、Azure Container Registry の機能を使用して、それらを作成、格納、使用する方法について説明します。

マルチアーキテクチャイメージは、さまざまなアーキテクチャおよび場合によってはさまざまなオペレーティングシステムのバリアントを組み合わせることができるコンテナーイメージの一種です。マルチアーキテクチャをサポートするイメージを実行すると、コンテナークライアントによって、OS とアーキテクチャに一致するイメージバリアントが自動的に選択されます。

マニフェストとマニフェスト一覧

マルチアーキテクチャイメージは、イメージマニフェストとマニフェスト一覧に基づいています。

Manifest

各コンテナーイメージは、マニフェストによって表されます。マニフェストは、イメージを一意に識別する JSON ファイルで、そのレイヤーとそれらに対応するサイズを参照します。

Linux hello-world イメージの基本のマニフェストは、次のようになります。

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
  "config": {
      "mediaType": "application/vnd.docker.container.image.v1+json",
      "size": 1510,
      "digest": "sha256:fbf289e99eb9bca977dae136fbe2a82b6b7d4c372474c9235adc1741675f587e"
    },
  "layers": [
      {
        "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
        "size": 977,
        "digest": "sha256:2c930d010525941c1d56ec53b97bd057a67ae1865eebf042686d2a2d18271ced"
      }
    ]
}

Azure Container Registry のマニフェストを表示するには、Azure portal または Azure CLI の az acr manifest list-metadata コマンドなどのツールを使用します。

マニフェスト一覧

マルチアーキテクチャイメージの マニフェスト一覧 (より一般的には、OCI イメージの場合に、イメージインデックスと呼ばれる) はイメージのコレクション (インデックス) であり、それを作成するには、1 つまたは複数のイメージ名を指定します。これには、サポートされている OS およびアーキテクチャ、サイズ、マニフェストダイジェストなどの各イメージの詳細が含まれます。マニフェスト一覧は、docker pull コマンドと docker run コマンドでイメージ名と同じように使用できます。

docker CLI では、docker manifest コマンドを使用して、マニフェストとマニフェスト一覧を管理します。

Note

現時点で、docker manifest コマンドとサブコマンドは試験段階です。試験段階のコマンドの使用の詳細については、Docker のドキュメントを参照してください。

マニフェスト一覧を表示するには、docker manifest inspect コマンドを使用します。マルチアーキテクチャイメージ mcr.microsoft.com/mcr/hello-world:latest の出力を次に示します。これには、Linux OS アーキテクチャ用に 2 つ、および Windows アーキテクチャ用に 1 つの 3 つのマニフェストがあります。

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.docker.distribution.manifest.list.v2+json",
  "manifests": [
    {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "size": 524,
      "digest": "sha256:83c7f9c92844bbbb5d0a101b22f7c2a7949e40f8ea90c8b3bc396879d95e899a",
      "platform": {
        "architecture": "amd64",
        "os": "linux"
      }
    },
    {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "size": 525,
      "digest": "sha256:873612c5503f3f1674f315c67089dee577d8cc6afc18565e0b4183ae355fb343",
      "platform": {
        "architecture": "arm64",
        "os": "linux"
      }
    },
    {
      "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
      "size": 1124,
      "digest": "sha256:b791ad98d505abb8c9618868fc43c74aa94d08f1d7afe37d19647c0030905cae",
      "platform": {
        "architecture": "amd64",
        "os": "windows",
        "os.version": "10.0.17763.1697"
      }
    }
  ]
}

マルチアーキテクチャマニフェスト一覧が Azure Container Registry に格納されている場合、Azure portal または az acr manifest list-metadata コマンドなどのツールを使用して、マニフェスト一覧を表示することもできます。

マルチアーキテクチャイメージのインポート

既存のマルチアーキテクチャイメージを Azure Container Registry にインポートするには、az acr import コマンドを使用します。イメージのインポートの構文は、単一アーキテクチャイメージの場合と同じです。単一アーキテクチャイメージのインポートと同様に、マルチアーキテクチャイメージのインポートでは、Docker コマンドを使用しません。

詳細については、「コンテナーレジストリにコンテナーイメージをインポートする」を参照してください。

マルチアーキテクチャイメージのプッシュ

さまざまなアーキテクチャのコンテナーイメージを作成するワークフローを構築している場合は、次の手順に従って、マルチアーキテクチャイメージを Azure Container Registry にプッシュします。

各アーキテクチャ固有のイメージにタグを付けて、コンテナーレジストリにプッシュします。次の例では、2 つの Linux アーキテクチャ (arm64 と amd64) を想定しています。

docker tag myimage:arm64 \
  myregistry.azurecr.io/multi-arch-samples/myimage:arm64

docker push myregistry.azurecr.io/multi-arch-samples/myimage:arm64

docker tag myimage:amd64 \
  myregistry.azurecr.io/multi-arch-samples/myimage:amd64

docker push myregistry.azurecr.io/multi-arch-samples/myimage:amd64

docker manifest create を実行して、マニフェスト一覧を作成し、前のイメージをマルチアーキテクチャイメージに結合します。

docker manifest create myregistry.azurecr.io/multi-arch-samples/myimage:multi \
 myregistry.azurecr.io/multi-arch-samples/myimage:arm64 \
 myregistry.azurecr.io/multi-arch-samples/myimage:amd64

docker manifest push を使用して、コンテナーレジストリにマニフェストをプッシュします。
```
docker manifest push myregistry.azurecr.io/multi-arch-samples/myimage:multi
```
docker manifest inspect コマンドを使用して、マニフェスト一覧を表示します。コマンド出力の例は、前のセクションに示しています。

マルチアーキテクチャマニフェストをレジストリにプッシュしたら、単一アーキテクチャイメージを処理する同じ方法で、マルチアーキテクチャイメージを操作します。たとえば、docker pull を使用してイメージをプルし、az acr repository コマンドを使用して、イメージのタグ、マニフェスト、その他のプロパティを表示します。

マルチアーキテクチャイメージの構築とプッシュ

ACR タスクの機能を使用すると、マルチアーキテクチャイメージを構築して、Azure Container Registry にプッシュできます。たとえば、Linux マルチアーキテクチャイメージを構築する複数ステップタスクを YAML ファイルに定義します。

次の例では、2 つのアーキテクチャ (arm64 と amd64) 用の個別の Dockerfile があることを前提としています。これは、アーキテクチャ固有のイメージを構築してプッシュし、次に latest タグがあるマルチアーキテクチャマニフェストを作成してプッシュします。

version: v1.1.0

steps:
- build: -t {{.Run.Registry}}/multi-arch-samples/myimage:{{.Run.ID}}-amd64 -f dockerfile.arm64 . 
- build: -t {{.Run.Registry}}/multi-arch-samples/myyimage:{{.Run.ID}}-arm64 -f dockerfile.amd64 . 
- push: 
    - {{.Run.Registry}}/multi-arch-samples/myimage:{{.Run.ID}}-arm64
    - {{.Run.Registry}}/multi-arch-samples/myimage:{{.Run.ID}}-amd64
- cmd: >
    docker manifest create
    {{.Run.Registry}}/multi-arch-samples/myimage:latest
    {{.Run.Registry}}/multi-arch-samples/myimage:{{.Run.ID}}-arm64
    {{.Run.Registry}}/multi-arch-samples/myimage:{{.Run.ID}}-amd64
- cmd: docker manifest push --purge {{.Run.Registry}}/multi-arch-samples/myimage:latest
- cmd: docker manifest inspect {{.Run.Registry}}/multi-arch-samples/myimage:latest

次のステップ

Azure Pipelines を使用して、さまざまなアーキテクチャのコンテナーイメージを構築します。
試験段階の Docker buildx プラグインを使用したマルチプラットフォームイメージの構築について確認します。

Azure Container Registry のマルチアーキテクチャ イメージ

マニフェストとマニフェスト一覧

Manifest

マニフェスト一覧

マルチアーキテクチャ イメージのインポート

マルチアーキテクチャ イメージのプッシュ

マルチアーキテクチャ イメージの構築とプッシュ

次のステップ

その他のリソース

Azure Container Registry のマルチアーキテクチャイメージ

マルチアーキテクチャイメージのインポート

マルチアーキテクチャイメージのプッシュ

マルチアーキテクチャイメージの構築とプッシュ