コンテナー レジストリにコンテナー イメージをインポートする

コンテナー イメージをインポートするには、Azure Cloud ShellまたはローカルでAzure CLIを実行します。

コンテナー イメージをインポートするには、Azure Cloud ShellまたはローカルでAzure PowerShellを実行します。

まだ Azure コンテナー レジストリがない場合は、レジストリを作成します。 手順については、「 クイック スタート: Azure CLI を使用してプライベート コンテナー レジストリを作成する」を参照してください。

まだ Azure コンテナー レジストリがない場合は、レジストリを作成します。 手順については、「 クイック スタート: Azure PowerShell を使用してプライベート コンテナー レジストリを作成する」を参照してください。

たとえば、az acr import コマンドを使用して、Docker Hub から hello-world:latest という名前のレジストリに複数アーキテクチャの イメージをインポートします。 hello-world は Docker Hub からの公式イメージなので、このイメージは既定の library リポジトリにあります。 --source イメージのパラメーターには、リポジトリ名と、必要に応じてタグの値を指定します (タグではなく、マニフェスト ダイジェストでイメージを識別することもできます。これにより、特定のバージョンのイメージが使用されることを保証できます)。

az acr import \
  --name myregistry \
  --source docker.io/library/hello-world:latest \
  --image hello-world:latest

az acr manifest list-metadata コマンドを実行すると、複数のマニフェストがこのイメージに関連付けられていることを確認できます。

az acr manifest list-metadata \
  --name hello-world \
  --registry myregistry

タグを追加せずにダイジェストで成果物をインポートするには:

az acr import \
   --name myregistry \
   --source docker.io/library/hello-world@sha256:abc123 \
   --repository hello-world

Docker Hub アカウントがある場合は、Docker Hubからイメージをインポートするときに資格情報を使用します。 docker Hub ユーザー名とパスワードまたは 個人用アクセス トークン をパラメーターとして az acr importに渡します。 次の例では、Docker Hub 資格情報を使用して、Docker Hub の tensorflow リポジトリからパブリック イメージをインポートします。

az acr import \
  --name myregistry \
  --source docker.io/tensorflow/tensorflow:latest-gpu \
  --image tensorflow:latest-gpu \
  --username <Docker Hub user name> \
  --password <Docker Hub token>

たとえば、Import-AzContainerRegistryImage コマンドを使用して、Docker Hub から hello-world:latest という名前のレジストリに複数アーキテクチャの イメージをインポートします。 hello-world は Docker Hub からの公式イメージなので、このイメージは既定の library リポジトリにあります。 -SourceImage パラメーターには、リポジトリ名と、必要に応じてタグの値を指定します。 (タグではなく、マニフェスト ダイジェストでイメージを識別することもできます。これにより、特定のバージョンのイメージが使用されることを保証できます)。

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri docker.io -SourceImage library/hello-world:latest

Get-AzContainerRegistryManifest コマンドレットを実行することで、このイメージに複数のマニフェストが関連付けられていることを確認できます。

Get-AzContainerRegistryManifest -RepositoryName library/hello-world -RegistryName myregistry

Docker Hub アカウントがある場合は、Docker Hubからイメージをインポートするときに資格情報を使用します。 docker Hub ユーザー名とパスワードまたは 個人用アクセス トークン をパラメーターとして Import-AzContainerRegistryImageに渡します。 次の例では、Docker Hub 資格情報を使用して、Docker Hub の tensorflow リポジトリからパブリック イメージをインポートします。

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri docker.io -SourceImage tensorflow/tensorflow:latest-gpu -Username <Docker Hub user name> -Password <Docker Hub token>

az acr import \
--name myregistry \
--source mcr.microsoft.com/windows/servercore:ltsc2022\
--image servercore:ltsc2022

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri mcr.microsoft.com -SourceImage windows/servercore:ltsc2022

次の例では、 aci-helloworld:latestイメージを、 レジストリのパブリック エンドポイントへのアクセスが無効になっているソース レジストリ mysourceregistry から myregistry にインポートします。 ソース レジストリのリソース ID は、--registry パラメーターを使用して指定しています。 --source パラメーターには、レジストリ ログイン サーバー名ではなく、ソース リポジトリとタグのみを指定することに注意してください。

ソース レジストリMicrosoft Entra ID 認証を使用するには、--registry <source-registry-resource-id> フラグを含めます。

az acr import \
  --name myregistry \
  --source aci-helloworld:latest \
  --image aci-helloworld:latest \
  --registry /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry

次の例では、 aci-helloworld:latestイメージを、 レジストリのパブリック エンドポイントへのアクセスが無効になっているソース レジストリ mysourceregistry から myregistry にインポートします。 ソース レジストリのリソース ID は、-SourceRegistryResourceId パラメーターを使用して指定しています。 -SourceImage パラメーターには、レジストリ ログイン サーバー名ではなく、ソース リポジトリとタグのみを指定することに注意してください。

ソース レジストリに対して Entra ID 認証を使用するには、 -SourceRegistryResourceId <source-registry-resource-id> フラグを含めます。

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryResourceId '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry' -SourceImage aci-helloworld:latest

次の例では、 mysourceregistry は同じテナント内の myregistry とは異なるサブスクリプションにあります。 --registry パラメーターを使用して、ソース レジストリのリソース ID を指定します。 --source パラメーターは、レジストリ ログイン サーバー名ではなく、ソース リポジトリとタグのみを指定します。

az acr import \
  --name myregistry \
  --source aci-helloworld:latest \
  --image aci-hello-world:latest \
  --registry /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry

次の例では、 mysourceregistry は同じテナント内の myregistry とは異なるサブスクリプションにあります。 -SourceRegistryResourceId パラメーターを使用して、ソース レジストリのリソース ID を指定します。 -SourceImage パラメーターは、レジストリ ログイン サーバー名ではなく、ソース リポジトリとタグのみを指定します。

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryResourceId '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry' -SourceImage aci-helloworld:latest

az acr import \
  --name myregistry \
  --source sourceregistry.azurecr.io/sourcerepo:tag \
  --image targetimage:tag \
  --username <SP_App_ID> \
  --password <SP_Passwd>

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri sourceregistry.azurecr.io -SourceImage sourcerepo:tag -Username <SP_App_ID> -Password <SP_Passwd>

az acr import \
  --name myregistry \
  --source sourceregistry.azurecr.io/sourcerepo:tag \
  --image targetimage:tag \
  --username <SP_App_ID> \
  --password <SP_Passwd>

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri sourceregistry.azurecr.io -SourceImage sourcerepo:tag -Username <SP_App_ID> -Password <SP_Passwd>

# Login to Azure CLI with the identity, for example a user-assigned managed identity
az login --identity --username <identity_ID>

# Get access token returned by `az account get-access-token`
az account get-access-token

ターゲット テナントで、アクセス トークンをパスワードとして az acr import コマンドに渡します。 ソース レジストリは、ログイン サーバー名を指定します。 このコマンドではユーザー名は必要ありません。

az acr import \
  --name myregistry \
  --source sourceregistry.azurecr.io/sourcerepo:tag \
  --image targetimage:tag \
  --password ($token|ConvertFrom-Json).accessToken

# Login to Azure PowerShell with the identity, for example a user-assigned managed identity
Connect-AzAccount -Identity -AccountId <identity_ID>

# Get access token returned by `Get-AzAccessToken`
Get-AzAccessToken

ターゲット テナントで、アクセス トークンをパスワードとして Import-AzContainerRegistryImage コマンドレットに渡します。 ソース レジストリは、ログイン サーバー名を指定します。 このコマンドではユーザー名は必要ありません。

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri sourceregistry.azurecr.io -SourceImage sourcerepo:tag -Password <access-token>

az acr import \
  --name myregistry \
  --source docker.io/sourcerepo/sourceimage:tag \
  --image sourceimage:tag \
  --username <username> \
  --password <password>

Import-AzContainerRegistryImage -RegistryName myregistry -ResourceGroupName myResourceGroup -SourceRegistryUri docker.io/sourcerepo -SourceImage sourcerepo:tag -Username <username> -Password <password>