Краткое руководство. Создание частного реестра контейнеров с помощью портала AzureQuickstart: Create a private container registry using the Azure portal

Реестр контейнеров Azure — это частный реестр 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.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 2.0.If you need to install or upgrade, see Install Azure CLI.

Также необходим локально установленный модуль Docker.You must also have Docker installed locally. Docker содержит пакеты, которые позволяют быстро настроить Docker в любой системе Mac, Windows или Linux.Docker provides packages that easily configure Docker on any Mac, Windows, or Linux system.

Вход в AzureSign in to Azure

Войдите на портал Azure по адресу 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

Введите значения параметров Имя реестра и Группа ресурсов.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. В целях этого руководства создайте группу ресурсов в регионе West US в расположении с именем myResourceGroup. Для SKU задайте значение "Базовый".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

В этом кратком руководстве описано, как создать реестр ценовой категории Базовый. Это оптимальный (недорогой) вариант для разработчиков, которые знакомятся с Реестром контейнеров Azure.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

Запишите значение сервера входа.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. Откройте командную оболочку в операционной системе и используйте команду az acr login в Azure CLI.Open a command shell in your operating system, and use the az acr login command in the Azure CLI.

az acr login --name <acrName>

По завершении команда возвращает Login Succeeded.The command returns Login Succeeded once completed.

Отправка образа в реестрPush image to registry

Чтобы отправить образ в реестр контейнеров Azure, сначала нужно получить этот образ.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. Имя сервера входа имеет формат <имя_реестра>.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

После передачи образа в реестр контейнеров удалите образ hello-world:v1 из локальной среды Docker.After pushing the image to your container registry, remove the hello-world:v1 image from your local Docker environment. (Обратите внимание, что команда docker rmi не приводит к удалению образа из репозитория hello-world в реестре контейнеров Azure.)(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

Запуск образа из реестраRun image from registry

Теперь вы можете извлекать и запускать образ контейнера hello-world:v1 из реестра контейнеров с помощью команды docker run: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

Дополнительная информацияNext steps

С помощью этого краткого руководства вы создали Реестр контейнеров Azure с использованием портала Azure, отправили образ контейнера, а затем извлекли этот образ оттуда и запустили его.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, перейдите к следующим руководствам.Continue to the Azure Container Registry tutorials for a deeper look at ACR.