(PRETERIDO) Implantar e usar o Registro de Contêiner do Azure
Dica
Para obter a versão atualizada deste tutorial que usa Serviço de Kubernetes do Azure, consulte Tutorial: Implantar e usar Registro de Contêiner do Azure.
Aviso
O ACS (Serviço de Contêiner do Azure) está sendo preterido. Não estão sendo adicionados novos recursos ou funcionalidades ao ACS. Todas as APIs, a experiência do portal, os comandos da CLI e a documentação estão marcados como preteridos.
Em 2017, introduzimos o AKS (Serviço de Kubernetes do Azure) para simplificar o gerenciamento, a implantação e as operações do Kubernetes. Se você usar o orquestrador do Kubernetes, migre para o AKS até o dia 31 de janeiro de 2020. Para começar, confira Migrar para o Serviço de Kubernetes do Azure.
Para obter mais informações, consulte o Comunicado de preterimento do Serviço de Contêiner do Azure em Azure.com.
O ACR (Registro de Contêiner do Azure) é um registro privado baseado no Azure, para imagens de contêiner do Docker. Este tutorial, parte dois de sete, demonstra a implantação de uma instância de Registro de Contêiner do Azure e envia por push uma imagem de contêiner. As etapas concluídas incluem:
- Implantando uma instância de ACR (Registro de Contêiner do Azure)
- Marcando uma imagem de contêiner para ACR
- Carregando da imagem para ACR
Nos próximos tutoriais, essa instância do ACR será integrada a um cluster do Kubernetes do Serviço de Contêiner do Azure.
Antes de começar
No tutorial anterior, uma imagem de contêiner foi criada 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ê esteja executando a CLI do Azure versão 2.0.4 ou posterior. Execute az --version para encontrar a versão. Se você precisar instalar ou atualizar, confira Instalar a CLI do Azure.
Implantar o Registro de Contêiner do Azure
Ao implantar um 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. Neste exemplo, criaremos um grupo de recursos myResourceGroup na região westeurope.
az group create --name myResourceGroup --location westeurope
Crie um Registro de Contêiner do Azure com o comando az acr create. O nome de um registro de contêiner deve ser exclusivo.
az acr create --resource-group myResourceGroup --name <acrName> --sku Basic
Durante o restante deste tutorial, utilizamos <acrname> como um espaço reservado para o nome do registro de contêiner.
Logon no registro de contêiner
Use o comando az acr login para fazer logon na instância do ACR. Você precisa fornecer o nome exclusivo fornecido para o registro de contêiner quando ele foi criado.
az acr login --name <acrName>
O comando retorna uma mensagem de 'Logon bem-sucedido' quando é concluído.
Marcar imagens de contêiner
Para consultar uma lista de imagens atuais, utilize o comando docker images.
docker images
Saída:
REPOSITORY TAG IMAGE ID CREATED SIZE
azure-vote-front latest 4675398c9172 13 minutes ago 694MB
redis latest a1b99da73d05 7 days ago 106MB
tiangolo/uwsgi-nginx-flask flask 788ca94b2313 9 months ago 694MB
Cada imagem de contêiner precisa ser marcada com o nome do registro loginServer. Essa marca é usada para roteamento ao enviar imagens de contêiner por push a um registro da imagem.
Para obter o nome de loginServer, execute o comando a seguir.
az acr list --resource-group myResourceGroup --query "[].{acrLoginServer:loginServer}" --output table
Agora, marque a imagem azure-vote-front com o loginServer do registro de contêiner. Além disso, adicione :v1 ao final do nome da imagem. Esta marcação indica a versão da imagem.
docker tag azure-vote-front <acrLoginServer>/azure-vote-front:v1
Depois de marcado, execute imagens do Docker para verificar a operação.
docker images
Saída:
REPOSITORY TAG IMAGE ID CREATED SIZE
azure-vote-front latest eaf2b9c57e5e 8 minutes ago 716 MB
mycontainerregistry082.azurecr.io/azure-vote-front v1 eaf2b9c57e5e 8 minutes ago 716 MB
redis latest a1b99da73d05 7 days ago 106MB
tiangolo/uwsgi-nginx-flask flask 788ca94b2313 8 months ago 694 MB
Efetuar push de imagens para registro
Envie a imagem azure-vote-front por push ao registro.
Usando o exemplo a seguir, substitua o nome do loginServer do ACR pelo loginServer do seu ambiente.
docker push <acrLoginServer>/azure-vote-front:v1
Isso leva alguns minutos para ser concluído.
Lista de imagens no registro
Para retornar uma lista de imagens que foram enviadas por push ao Registro de Contêiner do Azure, use o comando az acr repository list. Atualize o comando com o nome da instância do ACR.
az acr repository list --name <acrName> --output table
Saída:
Result
----------------
azure-vote-front
E, em seguida, 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
Saída:
Result
--------
v1
Na conclusão do tutorial, a imagem de contêiner foi armazenada em uma instância privada de Registro de Contêiner do Azure. Essa imagem será implantada do ACR para um cluster Kubernetes em tutoriais subsequentes.
Próximas etapas
Neste tutorial, um Registro de Contêiner do Azure foi preparado para ser usado em um cluster do Kubernetes do ACS. As etapas a seguir foram concluídas:
- Implantando uma instância de Registro de Contêiner do Azure
- Marcando uma imagem de contêiner para ACR
- Carregando a imagem para ACR
Avance para o próximo tutorial para saber mais sobre a implantação de um cluster do Kubernetes no Azure.