Tutorial – Criar um Registro de Contêiner do Azure (ACR) e compilar imagens

Artigo
12/05/2023

O ACR (Registro de Contêiner do Azure) é um registro particular de imagens de contêiner. Um registro de contêiner privado permite que você crie e implante com segurança seus aplicativos e códigos personalizados.

Neste tutorial, parte dois de sete, você pode implantar uma instância do ACR e enviar por push uma imagem de contêiner a ele. Você aprenderá como:

Criar uma instância de ACR.
Use Tarefas do ACR para compilar e enviar imagens de contêiner por push para o ACR.
Exibir imagens no seu registro.

Antes de começar

No tutorial anterior, você usou o Docker para criar uma imagem de contêiner para um aplicativo Front simples do Microsoft Azure Store. Se você não tiver criado a imagem do aplicativo Front do Microsoft Azure Store, retorne ao Tutorial 1: preparar um aplicativo para o AKS.

CLI do Azure
PowerShell do Azure

Este tutorial exige a CLI do Azure versão 2.0.53 ou posterior. Execute az --version para encontrar a versão. Se você precisa instalar ou atualizar, consulte Instalar a CLI do Azure.

Criar um Registro de Contêiner do Azure

Antes de criar uma instância do ACR, você precisa de um grupo de recursos. Um grupo de recursos do Azure é um contêiner lógico em que você implanta e gerencia os recursos do Azure.

Importante

Este tutorial usa myResourceGroup como um espaço reservado para o nome do grupo de recursos. Se você quiser usar um nome diferente, substitua myResourceGroup pelo seu próprio nome de grupo de recursos.

CLI do Azure
PowerShell do Azure

Crie um grupo de recursos usando o comando az group create.

az group create --name myResourceGroup --location eastus

Crie uma instância do ACR com o comando az acr create e forneça seu próprio nome de registro exclusivo. O nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos. O restante deste tutorial usa uma variável de ambiente, $ACRNAME, como um espaço reservado para o nome do registro de contêiner. Você pode definir esta variável de ambiente com seu nome ACR exclusivo para usar nos futuros comandos. A SKU Basic é um ponto de entrada de otimização de custo para fins de desenvolvimento que fornece um equilíbrio entre o armazenamento e taxa de transferência.
```
az acr create --resource-group myResourceGroup --name $ACRNAME --sku Basic
```

Crie um grupo de recursos usando o cmdlet New-AzResourceGroup.
```
New-AzResourceGroup -Name myResourceGroup -Location eastus
```
Crie uma instância do ACR com o cmdlet New-AzContainerRegistry e forneça seu próprio nome de registro exclusivo. O nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos. O restante deste tutorial usa uma variável de ambiente, $ACRNAME, como um espaço reservado para o nome do registro de contêiner. Você pode definir esta variável de ambiente com seu nome ACR exclusivo para usar nos futuros comandos. A SKU Basic é um ponto de entrada de otimização de custo para fins de desenvolvimento que fornece um equilíbrio entre o armazenamento e taxa de transferência.
```
New-AzContainerRegistry -ResourceGroupName myResourceGroup -Name $ACRNAME -Location eastus -Sku Basic
```

Compilar e enviar imagens de contêiner por push para o registro

Crie e envie por push as imagens para o ACR usando o comando az acr build da CLI do Azure.

Observação

Para esta etapa, não há um cmdlet equivalente do Azure PowerShell que execute essa tarefa.

No exemplo a seguir, não compilamos a imagem rabbitmq. Essa imagem está disponível no repositório público do Docker Hub e não precisa ser compilada ou enviada por push para sua instância do ACR.
```
az acr build --registry $ACRNAME --image aks-store-demo/product-service:latest ./src/product-service/
az acr build --registry $ACRNAME --image aks-store-demo/order-service:latest ./src/order-service/
az acr build --registry $ACRNAME --image aks-store-demo/store-front:latest ./src/store-front/
```

Exiba as imagens em sua instância do ACR usando o comando az acr repository list.

az acr repository list --name $ACRNAME --output table

A saída de exemplo a seguir lista as imagens disponíveis no registro:

Result
----------------
aks-store-demo/product-service
aks-store-demo/order-service
aks-store-demo/store-front

Exiba as imagens em sua instância do ACR usando o cmdlet Get-AzContainerRegistryRepository.
```
Get-AzContainerRegistryRepository -RegistryName $ACRNAME
```
A saída de exemplo a seguir lista as imagens disponíveis no registro:
```
aks-store-demo/productservice
aks-store-demo/orderservice
aks-store-demo/storefront
```

Próximas etapas

Neste tutorial, você criou um ACR e efetuou push de uma imagem para ele a fim de usar em um cluster do AKS. Você aprendeu a:

Criar uma instância de ACR.
Use Tarefas do ACR para compilar e enviar imagens de contêiner por push para o ACR.
Exibir imagens no seu registro.

No próximo tutorial, você aprenderá como implantar um cluster do Kubernetes no Azure.

Implantar um cluster do Kubernetes