クイック スタート:Azure portal を使用したプライベート コンテナー レジストリの作成Quickstart: Create a private container registry using the Azure portal

Azure Container Registry は、プライベート Docker コンテナー イメージを保存および管理する Azure のプライベート Docker レジストリです。An Azure container registry is a private Docker registry in Azure where you can store and manage your private Docker container images. このクイックスタートでは、Azure Portal を使用してコンテナー レジストリを作成します。In this quickstart, you create a container registry with the Azure portal. 次に、Docker コマンドを使用してコンテナー イメージをレジストリにプッシュし、最後にレジストリからイメージをプルして実行します。Then, use Docker commands to push a container image into the registry, and finally pull and run the image from your registry.

レジストリにログインし、コンテナー イメージを操作するために、このクイック スタートでは、Azure CLI を実行している必要があります (バージョン 2.0.55 以降を推奨)。To log in to the registry to work with container images, this quickstart requires that you are running the Azure CLI (version 2.0.55 or later recommended). バージョンを確認するには、az --version を実行します。Run az --version to find the version. インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。If you need to install or upgrade, see Install Azure CLI.

Docker もローカルにインストールする必要があります。You must also have Docker installed locally. Docker では、MacWindows、または Linux システムで Docker を簡単に構成できるパッケージが提供されています。Docker provides packages that easily configure Docker on any Mac, Windows, or Linux system.

Azure へのサインインSign in to Azure

Azure Portal ( https://portal.azure.com ) にサインインします。Sign in to the Azure portal at https://portal.azure.com.

コンテナー レジストリの作成Create a container registry

[リソースの作成] > [コンテナー] > [コンテナー レジストリ] の順に選択します。Select Create a resource > Containers > Container Registry.

Azure Portal でコンテナー レジストリを作成する

[レジストリ名][リソース グループ] に値を入力します。Enter values for Registry name and Resource group. レジストリの名前は Azure 内で一意にする必要があります。また、5 ~ 50 文字の英数字を含める必要があります。The registry name must be unique within Azure, and contain 5-50 alphanumeric characters. このクイック スタートでは、myResourceGroup という名前の新しいリソース グループを West US に作成し、 [SKU] には [Basic] を選択します。For this quickstart create a new resource group in the West US location named myResourceGroup, and for SKU, select 'Basic'. [作成] を選択して ACR インスタンスをデプロイします。Select Create to deploy the ACR instance.

Azure portal でコンテナー レジストリを作成する

このクイック スタートでは、Basic レジストリを作成します。これは、Azure Container Registry について学習している開発者にとって、コストが最適なオプションです。In this quickstart you create a Basic registry, which is a cost-optimized option for developers learning about Azure Container Registry. 利用可能なサービス レベルの詳細については、コンテナー レジストリの SKU に関するページを参照してください。For details on available service tiers, see Container registry SKUs.

"デプロイメントに成功しました" というメッセージが表示されたら、ポータルでコンテナー レジストリを選択します。When the Deployment succeeded message appears, select the container registry in the portal.

Azure portal でのコンテナー レジストリの概要

ログイン サーバーの値を書き留めておきます。Take note of the value of the Login server. 後の手順で、Azure CLI および Docker を使用してレジストリを操作するときに、この値を使用します。You use this value in the following steps while working with your registry with the Azure CLI and Docker.

レジストリへのログインLog in to registry

コンテナー イメージをプッシュしたりプルしたりするには、あらかじめ ACR インスタンスにログインしておく必要があります。Before pushing and pulling container images, you must log in to the ACR instance. オペレーティング システムでコマンド シェルを開き、Azure CLI で az acr login コマンドを使用します (コンテナー名のみを指定します。Open a command shell in your operating system, and use the az acr login command in the Azure CLI.(Specify only Container Name. "azurecr.io" は含めないでください)。Do not include 'azurecr.io')

az acr login --name <acrName>

このコマンドは、完了すると Login Succeeded を返します。The command returns Login Succeeded once completed.

レジストリにイメージをプッシュするPush image to registry

Azure Container Registry にイメージをプッシュするには、まずイメージを用意する必要があります。To push an image to an Azure Container registry, you must first have an image. ローカル コンテナー イメージがまだない場合は、次の docker pull コマンドを実行して、既存のイメージを Docker Hub からプルします。If you don't yet have any local container images, run the following docker pull command to pull an existing image from Docker Hub. この例では、hello-world イメージをプルします。For this example, pull the hello-world image.

docker pull hello-world

イメージをレジストリにプッシュするには、ACR ログイン サーバーの完全修飾名を使用して、そのイメージにタグを付けておく必要があります。Before you can push an image to your registry, you must tag it with the fully qualified name of your ACR login server. ログイン サーバー名は、 <registry-name>.azurecr.io (すべて小文字) という形式です。たとえば、mycontainerregistry007.azurecr.io などです。The login server name is in the format <registry-name>.azurecr.io (all lowercase), for example, mycontainerregistry007.azurecr.io.

docker tag コマンドを使用してイメージにタグ付けします。Tag the image using the docker tag command. <acrLoginServer> を ACR インスタンスのログイン サーバー名で置き換えます。Replace <acrLoginServer> with the login server name of your ACR instance.

docker tag hello-world <acrLoginServer>/hello-world:v1

最後に、docker push を使用して、ACR インスタンスにイメージをプッシュします。Finally, use docker push to push the image to the ACR instance. <acrLoginServer> を ACR インスタンスのログイン サーバー名で置き換えます。Replace <acrLoginServer> with the login server name of your ACR instance. この例では、hello-world レポジトリを作成します。これには、hello-world:v1 イメージが含まれています。This example creates the hello-world repository, containing the hello-world:v1 image.

docker push <acrLoginServer>/hello-world:v1

コンテナー レジストリにイメージをプッシュした後は、ローカルの Docker 環境から hello-world:v1 イメージを削除しますAfter pushing the image to your container registry, remove the hello-world:v1 image from your local Docker environment. (この docker rmi コマンドは、Azure コンテナー リポジトリ内の hello-world リポジトリからイメージを削除しないことに注意してください)。(Note that this docker rmi command does not remove the image from the hello-world repository in your Azure container registry.)

docker rmi <acrLoginServer>/hello-world:v1

コンテナー イメージの一覧表示List container images

レジストリ内のイメージを一覧表示するには、ポータルでレジストリに移動し、 [リポジトリ] を選択してから、docker push で作成したリポジトリを選択します。To list the images in your registry, navigate to your registry in the portal and select Repositories, then select the repository you created with docker push.

この例では、hello-world リポジトリを選択したので、 [タグ]v1 タグが付いたイメージが表示されます。In this example, we select the hello-world repository, and we can see the v1-tagged image under TAGS.

Azure portal でコンテナー イメージを一覧表示する

レジストリからイメージを実行するRun image from registry

ここで、docker run を使用して、コンテナー レジストリから hello-world:v1 コンテナー イメージをプルして実行できます。Now, you can pull and run the hello-world:v1 container image from your container registry by using docker run:

docker run <acrLoginServer>/hello-world:v1  

出力例:Example output:

Unable to find image 'mycontainerregistry007.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry007.azurecr.io/hello-world:v1

Hello from Docker!
This message shows that your installation appears to be working correctly.

[...]

リソースをクリーンアップするClean up resources

リソースをクリーンアップするには、ポータルで myResourceGroup リソース グループに移動します。To clean up your resources, navigate to the myResourceGroup resource group in the portal. リソース グループが読み込まれたら、 [リソース グループの削除] をクリックして、リソース グループ、コンテナー レジストリ、およびそこに格納されているコンテナー イメージを削除します。Once the resource group is loaded click on Delete resource group to remove the resource group, the container registry, and the container images stored there.

Azure portal でリソース グループを削除する

次のステップNext steps

このクイック スタートでは、Azure portal を使って Azure Container Registry を作成し、コンテナー イメージをプッシュしてから、レジストリからイメージをプルして実行しました。In this quickstart, you created an Azure Container Registry with the Azure portal, pushed a container image, and pulled and ran the image from the registry. Azure Container Registry のチュートリアルに進んで、ACR についての理解を深めましょう。Continue to the Azure Container Registry tutorials for a deeper look at ACR.