Tutorial: Criar um Registro de Contêiner do Azure para o AKS habilitado pelo Arc
Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server
Um Registro de Contêiner do Azure é um registro privado para imagens de contêiner. Um registro de contêiner privado permite criar e implantar seus aplicativos e o código personalizado com segurança.
Neste tutorial, parte dois de sete, você implanta uma instância do Registro de Contêiner do Azure e envia uma imagem de contêiner por push para ela para uso no AKS. Você aprenderá a:
- Cria uma instância do Registro de Contêiner do Azure
- Marcar uma imagem de contêiner para o Registro de Contêiner do Azure
- Fazer upload da imagem no Registro de Contêiner do Azure
- Exibir imagens no seu registro
Em tutoriais posteriores, essa instância do Registro de Contêiner do Azure é integrada a um cluster do Kubernetes e um aplicativo é implantado a partir da imagem.
Antes de começar
O tutorial anterior descreveu como criar uma imagem de contêiner para um aplicativo simples de Votação do Azure. Se você não tiver criado a imagem do aplicativo de Votação do Azure, retorne ao Tutorial 1 – Criar imagens de contêiner.
Este tutorial requer que você execute 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
Para criar uma instância do Registro de Contêiner do Azure, primeiro você precisa de um grupo de recursos. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.
Crie um grupo de recursos com o comando az group create. No exemplo a seguir, um grupo de recursos chamado myResourceGroup é criado na região eastus:
az group create --name myResourceGroup --location eastus
Crie uma instância do Registro de Contêiner do Azure com o comando az acr create e forneça seu próprio nome de registro. O nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos. No restante deste tutorial, <acrName> é usado como um espaço reservado para o nome do registro de contêiner. Forneça seu próprio nome de registro exclusivo. 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
Logon no registro de contêiner
Para usar a instância do ACR, você deve primeiro fazer logon. Use o comando az acr login e forneça o nome exclusivo fornecido ao registro de contêiner na etapa anterior:
az acr login --name <acrName>
O comando retorna uma mensagem de logon bem-sucedido quando concluído.
Marcar uma imagem de contêiner
Para ver uma lista das imagens locais atuais, use o comando docker images:
docker images
A saída deste comando mostra uma lista de suas imagens locais atuais:
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
Para usar a imagem de contêiner azure-vote-front com o Registro de Contêiner do Azure, marque a imagem com o endereço do servidor de logon do registro. Essa marca é usada para roteamento ao enviar imagens de contêiner por push a um registro da imagem.
Para obter o endereço do servidor de logon, use o comando az acr list e consulte o loginServer da seguinte maneira:
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
Agora, marque a imagem local azure-vote-front com o endereço acrLoginServer do registro de contêiner. Para indicar a versão da imagem, adicione :v1 no final do nome da imagem:
docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1
Para verificar se as tags foram aplicadas, execute docker images novamente:
docker images
Uma imagem é marcada com o endereço da instância do Registro de Contêiner do Azure e um número de versão:
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
Efetuar push de imagens para registro
Com sua imagem criada e marcada, envie a imagem azure-vote-front para sua instância do Registro de Contêiner do Azure. Use docker push e forneça seu próprio acrLoginServer endereço para o nome da imagem da seguinte maneira:
docker push <acrLoginServer>/azure-vote-front:v1
Pode levar alguns minutos para concluir o push de imagem para o Registro de Contêiner do Azure.
Lista de imagens no registro
Para retornar uma lista de imagens que foram enviadas por push para sua instância do Registro de Contêiner do Azure, use o comando az acr repository list . Forneça seu próprio <acrName> da seguinte maneira:
az acr repository list --name <acrName> --output table
A saída de exemplo a seguir lista a imagem azure-vote-front como disponível no registro:
Result
----------------
azure-vote-front
Para ver as marcas de uma imagem específica, use o comando az acr repository show-tags :
az acr repository show-tags --name <acrName> --repository azure-vote-front --output table
A saída de exemplo a seguir mostra a imagem v1 marcada em uma etapa anterior:
Result
--------
v1
Agora você tem uma imagem de contêiner que é armazenada em uma instância privada de Registro de Contêiner do Azure. Essa imagem é implantada do Registro de Contêiner do Azure em um cluster do Kubernetes no próximo tutorial.
Próximas etapas
Neste tutorial, você criou um Registro de Contêiner do Azure e enviou uma imagem por push para uso em um cluster do Kubernetes. Você aprendeu a:
- Criar uma instância do Registro de Contêiner do Azure (ACR)
- Marcar uma imagem de contêiner para ACR
- Carregar a imagem para ACR
- Exibir imagens no seu registro
Avance para o próximo tutorial para aprender como implantar um cluster do Kubernetes no Azure.