Tutorial: Criar um Azure Container Registry para o AKS ativado pelo Arc
Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server
Um Azure Container Registry é um registo privado para imagens de contentor. Um registo de contentor privado permite-lhe criar e implementar as suas aplicações e código personalizado de forma segura.
Neste tutorial, parte dois de sete, vai implementar uma instância Azure Container Registry e enviar uma imagem de contentor para a mesma para utilização no AKS. Vai aprender a:
- Criar uma instância do Azure Container Registry
- Etiquetar uma imagem de contentor para Azure Container Registry
- Carregar a imagem para Azure Container Registry
- Ver imagens no registo
Nos tutoriais posteriores, esta Azure Container Registry instância está integrada num cluster do Kubernetes e é implementada uma aplicação a partir da imagem.
Antes de começar
O tutorial anterior descreveu como criar uma imagem de contentor para uma aplicação de Voto do Azure simples. Se não tiver criado a imagem de aplicação de Votação do Azure, regresse ao Tutorial 1 – Criar imagens de contentor.
Este tutorial requer que execute a versão 2.0.53 ou posterior da CLI do Azure. Executar az --version
para localizar a versão. Se precisar de instalar ou atualizar, veja Install Azure CLI (Instalar o Azure CLI).
Criar um Azure Container Registry
Para criar uma instância Azure Container Registry, primeiro precisa de um grupo de recursos. Um grupo de recursos do Azure é um contentor lógico no qual os recursos do Azure são implementados e geridos.
Crie um grupo de recursos com o comando az group create. No exemplo seguinte, é criado um grupo de recursos designado myResourceGroup na região eualeste:
az group create --name myResourceGroup --location eastus
Crie uma instância do Azure Container Registry com o comando az acr create e indique o seu próprio nome de registo. O nome do registo tem de ser exclusivo no Azure e pode incluir de 5 a 50 carateres alfanuméricos. No resto deste tutorial, <acrName>
é utilizado como um marcador de posição para o nome do registo de contentor. Forneça o seu próprio nome de registo exclusivo. O SKU Básico é um ponto de entrada com otimização de custos para fins de desenvolvimento que fornece um equilíbrio de armazenamento e débito.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic
Iniciar sessão no registo de contentor
Para utilizar a instância do ACR, primeiro tem de iniciar sessão. Utilize o comando az acr login e forneça o nome exclusivo dado ao registo de contentor no passo anterior:
az acr login --name <acrName>
O comando devolve uma mensagem Início de Sessão Bem-sucedido quando concluído.
Marcar uma imagem de contentor
Para ver uma lista das imagens locais atuais, utilize o comando docker images:
docker images
A saída deste 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 utilizar a imagem de contentor azure-vote-front com Azure Container Registry, certifique-se de que identifica a imagem com o endereço do servidor de início de sessão do seu registo. Esta etiqueta é utilizada para encaminhamento ao enviar imagens de contentor para um registo de imagem.
Para obter o endereço do servidor de início de sessão, utilize o comando az acr list e consulte o loginServer da seguinte forma:
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
Agora, identifique a sua imagem local azure-vote-front com o endereço acrLoginServer do registo de contentor. Para indicar a versão da imagem, adicione :v1 ao fim do nome da imagem:
docker tag mcr.microsoft.com/azuredocs/azure-vote-front:v1 <acrLoginServer>/azure-vote-front:v1
Para verificar se as etiquetas estão aplicadas, execute novamente as imagens do Docker :
docker images
Uma imagem é etiquetada com o endereço da instância Azure Container Registry 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
Enviar imagens para o registo
Com a imagem criada e etiquetada, envie a imagem azure-vote-front para a sua instância de Azure Container Registry. Utilize docker push e forneça o seu próprio acrLoginServer
endereço para o nome da imagem da seguinte forma:
docker push <acrLoginServer>/azure-vote-front:v1
Poderá demorar alguns minutos a concluir o push da imagem para Azure Container Registry.
Listar imagens no registo
Para devolver uma lista de imagens que foram enviadas para a instância Azure Container Registry, utilize o comando az acr repository list. Indique o seu próprio <acrName>
da seguinte forma:
az acr repository list --name <acrName> --output table
A saída de exemplo seguinte lista a imagem azure-vote-front como disponível no registo:
Result
----------------
azure-vote-front
Para ver as etiquetas de uma imagem específica, utilize 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 seguinte mostra a imagem v1 marcada num passo anterior:
Result
--------
v1
Tem agora uma imagem de contentor armazenada numa instância privada do Azure Container Registry. Esta imagem é implementada do Azure Container Registry para um cluster do Kubernetes no próximo tutorial.
Passos seguintes
Neste tutorial, criou um Azure Container Registry e emite uma imagem para utilização num cluster do Kubernetes. Aprendeu a:
- Criar uma instância do Azure Container Registry (ACR)
- Marcar uma imagem de contentor para o ACR
- Carregar os ficheiros de imagem para o ACR
- Ver imagens no registo
Avance para o próximo tutorial para saber como implementar um cluster do Kubernetes no Azure.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários