Руководство. Создание Реестр контейнеров Azure для AKS с поддержкой Arc

  • Статья

Область применения: AKS в Azure Stack HCI 22H2, AKS в Windows Server

Реестр контейнеров Azure — это частный реестр для образов контейнеров. Частный реестр контейнеров позволяет безопасно выполнять сборку и развертывать приложения, а также пользовательский код.

Во второй части седьмого руководства вы развернете экземпляр Реестр контейнеров Azure и отправьте в него образ контейнера для использования в AKS. Вы узнаете, как:

  • создадите экземпляр реестра контейнеров Azure;
  • Добавление тегов к образу контейнера для Реестр контейнеров Azure
  • Отправка образа в Реестр контейнеров Azure
  • просмотр образов в реестре.

В последующих руководствах этот экземпляр Реестр контейнеров Azure интегрируется с кластером Kubernetes, а приложение развертывается из образа.

Подготовка к работе

В предыдущем руководстве описано, как создать образ контейнера для простого приложения Azure для голосования. Если вы еще не создали образ приложения Azure для голосования, выполните инструкции из статьи Create container images to be used with Azure Container Service (Создание образов контейнеров с помощью службы контейнеров Azure).

Для работы с этим руководством необходимо запустить Azure CLI версии 2.0.53 или более поздней. Чтобы узнать версию, выполните команду az --version. Если вам необходимо выполнить установку или обновление, см. статью Установка Azure CLI 2.0.

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

Чтобы создать экземпляр Реестр контейнеров Azure, сначала потребуется группа ресурсов. Группа ресурсов Azure является логическим контейнером, в котором происходит развертывание ресурсов Azure и управление ими.

Создайте группу ресурсов с помощью команды az group create. В следующем примере создается группа ресурсов с именем myResourceGroup в регионе eastus.

az group create --name myResourceGroup --location eastus

Создайте экземпляр Реестра контейнеров Azure с помощью команды az acr create и введите собственное имя реестра. Имя реестра должно быть уникальным в пределах Azure и содержать от 5 до 50 буквенно-цифровых символов. В дальнейшем в этом руководстве <acrName> будет использоваться как заполнитель имени реестра контейнеров. Укажите уникальное имя для реестра. SKU Базовый — это оптимизированная по стоимости точка входа для целей разработки, обеспечивающая баланс ресурсов хранения и пропускной способности.

az acr create --resource-group myResourceGroup --name <acrName> --sku Basic

Вход в реестр контейнеров

Чтобы использовать экземпляр ACR, сначала необходимо войти. Используйте команду az acr login и укажите уникальное имя, присвоенное реестру контейнеров на предыдущем шаге:

az acr login --name <acrName>

По завершении команда возвращает сообщение Имя входа выполнено .

Добавление тега к образу контейнера

Чтобы просмотреть список сохраненных образов, используйте команду docker images:

docker images

В выходных данных этой команды отображается список текущих локальных образов:

REPOSITORY                                     TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front   v1                  84b41c268ad9        7 minutes ago       944MB
mcr.microsoft.com/oss/bitnami/redis            6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                     python3.6           a16ce562e863        6 weeks ago         944MB

Чтобы использовать образ контейнера azure-vote-front с Реестр контейнеров Azure, убедитесь, что вы помечаете образ адресом сервера входа в реестр. Данный тег используется для маршрутизации при отправке образов контейнеров в реестр образов.

Чтобы получить адрес сервера входа, используйте команду az acr list и запросите loginServer, как показано ниже:

az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table

Теперь пометьте тегом локальный образ azure-vote-front, используя адрес acrLoginServer реестра контейнеров. Чтобы указать номер версии образа, добавьте :v1 в конец имени образа:

docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1

Чтобы проверить применение тегов, запустите образы Docker еще раз:

docker images

Изображение помечается адресом экземпляра Реестр контейнеров Azure и номером версии:

REPOSITORY                                      TAG                 IMAGE ID            CREATED             SIZE
mcr.microsoft.com/azuredocs/azure-vote-front    v1                  84b41c268ad9        16 minutes ago      944MB
mycontainerregistry.azurecr.io/azure-vote-front v1                  84b41c268ad9        16 minutes ago      944MB
mcr.microsoft.com/oss/bitnami/redis             6.0.8               3a54a920bb6c        2 days ago          103MB
tiangolo/uwsgi-nginx-flask                      python3.6           a16ce562e863        6 weeks ago         944MB

Отправка образов в реестр

После создания образа и добавления тегов отправьте образ azure-vote-front в экземпляр Реестр контейнеров Azure. Используйте docker push и укажите собственный acrLoginServer адрес для имени образа, как показано ниже.

docker push <acrLoginServer>/azure-vote-front:v1

Чтобы завершить отправку образа для Реестр контейнеров Azure, может потребоваться несколько минут.

Перечисление образов в реестре

Чтобы вернуть список образов, отправленных в экземпляр Реестр контейнеров Azure, используйте команду az acr repository list. Укажите собственное <acrName> следующим образом:

az acr repository list --name <acrName> --output table

В следующем примере выводятся образы azure-vote-front по доступности в реестре:

Result
----------------
azure-vote-front

Чтобы просмотреть теги для определенного изображения, используйте команду az acr repository show-tags :

az acr repository show-tags --name <acrName> --repository azure-vote-front --output table

В следующем примере показан образ v1, отмеченный на предыдущем шаге:

Result
--------
v1

Теперь у вас есть образ контейнера, сохраненный в частном экземпляре Реестра контейнеров Azure. Этот образ развертывается из Реестр контейнеров Azure в кластер Kubernetes в следующем руководстве.

Дальнейшие действия

В этом руководстве вы создали Реестр контейнеров Azure и отправьте образ для использования в кластере Kubernetes. Вы научились выполнять следующие задачи:

  • создание экземпляра Реестра контейнеров Azure;
  • добавление тегов к образу контейнера для реестра контейнеров Azure;
  • отправка образа в реестр контейнеров Azure.
  • просмотр образов в реестре.

Перейдите к следующему руководству, чтобы узнать, как развертывать кластер Kubernetes в Azure.

Развертывание кластера Kubernetes