Краткое руководство. Создание частного реестра контейнеров с помощью портала 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 private Docker container images and related artifacts. В этом кратком руководстве вы создадите реестр контейнеров с помощью портала 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.

Переход к реестру контейнеров на портале

На вкладке Основные сведения введите значения в поле Группа ресурсов и Имя реестра.In the Basics tab, enter values for Resource group and Registry name. Имя реестра должно быть уникальным в пределах 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'.

Создание реестра контейнеров на портале

Примите значения по умолчанию для остальных параметров.Accept default values for the remaining settings. Щелкните Просмотр и создание.Then select Review + create. Проверив параметры, нажмите кнопку Создать.After reviewing the settings, select Create.

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

Когда появится сообщение Развертывание прошло успешно, выберите реестр контейнеров на портале.When the Deployment succeeded message appears, select the container registry in the portal.

Страница обзора реестра контейнеров на портале

Запишите значение сервера входа.Take note of the value of the Login server. Это значение используется в следующих шагах при отправке и извлечении изображения с помощью Docker.You use this value in the following steps when you push and pull images with Docker.

Вход в раздел реестраLog in to registry

Перед отправкой и извлечением образов контейнеров необходимо войти в экземпляр реестра.Before pushing and pulling container images, you must log in to the registry instance. Войдите в Azure CLI на локальном компьютере, а затем выполните команду az acr login.Sign into the Azure CLI on your local machine, then run the az acr login command. (При входе с помощью Azure CLI укажите только имя реестра.(Specify only the registry name when logging in with the Azure CLI. Не добавляйте суффикс "azurecr.io".)Don't include the 'azurecr.io' suffix.)

az acr login --name <registry-name>

По завершении команда возвращает 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

Прежде чем отправить образ в реестр, нужно добавить в него тег с полным именем сервера входа для реестра.Before you can push an image to your registry, you must tag it with the fully qualified name of your registry 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. Замените значение <login-server> именем сервера входа для экземпляра ACR.Replace <login-server> with the login server name of your ACR instance.

docker tag hello-world <login-server>/hello-world:v1

Наконец, воспользуйтесь командой docker push для принудительной отправки образа в экземпляр реестра.Finally, use docker push to push the image to the registry instance. Замените значение <login-server> именем сервера входа для экземпляра реестра.Replace <login-server> with the login server name of your registry instance. В этом примере создается репозиторий hello-world с образом hello-world:v1.This example creates the hello-world repository, containing the hello-world:v1 image.

docker push <login-server>/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 <login-server>/hello-world:v1

Список образов контейнеровList container images

Чтобы вывести список образов в вашем реестре, перейдите в реестр на портале и выберите Репозитории, а затем выберите репозиторий hello-world, созданный с помощью docker push.To list the images in your registry, navigate to your registry in the portal and select Repositories, then select the hello-world repository you created with docker push.

Список образов контейнеров на портале

Выбрав репозиторий hello-world, вы увидите образ с тегом v1 в разделе Теги.By selecting the hello-world repository, you see the v1-tagged image under Tags.

Запуск образа из реестра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 <login-server>/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.

Удаление группы ресурсов на портале

Дальнейшие действия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.