Tutorial: Criar um Registro de Contêiner do Azure para 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, a parte dois de sete, você implanta uma instância de Registro de Contêiner do Azure e envia uma imagem de contêiner para ele 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 Registro de Contêiner do Azure
- Carregar a imagem para Registro de Contêiner do Azure
- Exibir imagens no seu registro
Em tutoriais posteriores, essa instância 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 de Votação do Azure simples. 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 exige 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 de 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 logon bem-sucedido quando concluída.
Marcar uma imagem de contêiner
Para ver uma lista das imagens locais atuais, use o comando docker images:
docker images
A saída desse comando mostra uma lista das 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 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 marcas são aplicadas, execute imagens do Docker novamente:
docker images
Uma imagem é marcada com o endereço da instância 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 por push a imagem azure-vote-front para sua instância de Registro de Contêiner do Azure. Use o 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 da imagem para 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 de 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 de Registro de Contêiner do Azure para um cluster do Kubernetes no próximo tutorial.
Próximas etapas
Neste tutorial, você criou um Registro de Contêiner do Azure e efetuou push de uma imagem 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.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de