Início Rápido: Criar um registro de contêiner privado do Docker usando o Azure PowerShell
O Registro de Contêiner do Azure é um serviço de registro privado para gerar, armazenar e fornecer imagens de contêiner e artefatos relacionados. Neste guia de início rápido, você vai criar uma instância do Registro de Contêiner do Azure com o Azure PowerShell. Em seguida, use os comandos do Docker para efetuar push de uma imagem de contêiner no Registro e, por fim, efetuar pull e executar a imagem do seu Registro.
Pré-requisitos
Observação
Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Confira Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.
Este início rápido requer o módulo Azure PowerShell. Execute Get-Module -ListAvailable Az para determinar a versão instalada. Se você precisar instalá-lo ou atualizá-lo, confira Instalar o módulo do Azure PowerShell.
Você também deve ter o Docker instalado localmente. O docker fornece pacotes para sistemas macOS, WindowsLinux.
Como o Azure Cloud Shell não inclui todos os componentes de Docker necessários (o daemon dockerd), você não pode usar o Cloud Shell para este guia de início rápido.
Entrar no Azure
Entre em sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.
Connect-AzAccount
Criar grupo de recursos
Depois que você estiver autenticado com o Azure, crie um grupo de recursos com New-AzResourceGroup. Um grupo de recursos é um contêiner lógico no qual você implanta e gerenciar os recursos do Azure.
New-AzResourceGroup -Name myResourceGroup -Location EastUS
Criar um registro de contêiner
Em seguida, crie um registro de contêiner em seu novo grupo de recursos com o comando New-AzContainerRegistry.
O nome do registro deve ser exclusivo no Azure e conter de 5 a 50 caracteres alfanuméricos. O exemplo a seguir cria um registro chamado "mycontainerregistry". Substitua mycontainerregistry no seguinte comando e execute-o para criar o registro:
$registry = New-AzContainerRegistry -ResourceGroupName "myResourceGroup" -Name "mycontainerregistry" -EnableAdminUser -Sku Basic
Dica
Neste guia de início rápido, você criará um registro básico, que é uma opção com otimização de custo para desenvolvedores que estão aprendendo sobre o Registro de Contêiner do Azure. Escolha outras camadas para aumentar a taxa de transferência de armazenamento e imagem, além de recursos como a conexão usando um ponto de extremidade privado. Para obter detalhes sobre as camadas de serviço (SKUs) disponíveis, confira Camadas de serviço do registro de contêiner.
Fazer logon no registro
Antes de efetuar push e pull de imagens de contêiner, você precisa fazer logon no seu registro com o cmdlet Connect-AzContainerRegistry. O exemplo a seguir usa as mesmas credenciais com as quais você fez logon ao se autenticar no Azure com o cmdlet Connect-AzAccount.
Observação
No exemplo a seguir, o valor de $registry.Name é o nome do recurso, não o nome totalmente qualificado do registro.
Connect-AzContainerRegistry -Name $registry.Name
O comando retorna Login Succeeded na conclusão.
Efetuar push de imagem para registro
Para enviar por push uma imagem para um Registro de Contêiner do Azure, primeiro você deve ter uma imagem. Se você ainda não tiver imagens de contêiner locais, execute o comando docker pull a seguir para efetuar pull de uma imagem pública existente. Para este exemplo, efetue pull da imagem hello-world do Microsoft Container Registry.
docker pull mcr.microsoft.com/hello-world
Para efetuar push de uma imagem para o Registro, você precisa marcá-la com o nome totalmente qualificado de seu servidor de logon do Registro. O nome do servidor de logon está no formato <registry-name>.azurecr.io (tudo em letras minúsculas), por exemplo, mycontainerregistry.azurecr.io.
Marque a imagem usando o comando docker tag. Substitua o <login-server> pelo nome do servidor de logon da sua instância do ACR.
docker tag mcr.microsoft.com/hello-world <login-server>/hello-world:v1
Exemplo:
docker tag mcr.microsoft.com/hello-world mycontainerregistry.azurecr.io/hello-world:v1
Por fim, use docker push para efetuar push da imagem para a instância do registro. Substitua o <login-server> pelo nome do servidor de logon de sua instância do registro. Este exemplo cria o repositório Olá, mundo, que contém a imagem hello-world:v1.
docker push <login-server>/hello-world:v1
Depois de efetuar push da imagem no registro de contêiner, remova a imagem hello-world:v1 de seu ambiente do Docker local. (Observe que esse comando docker rmi não remove a imagem do repositório hello-world no registro de contêiner do Azure.)
docker rmi <login-server>/hello-world:v1
Executar a imagem do Registro
Agora, é possível efetuar pull e executar a imagem de contêiner hello-world:v1 do registro de contêiner usando docker run:
docker run <login-server>/hello-world:v1
Saída de exemplo:
Unable to find image 'mycontainerregistry.azurecr.io/hello-world:v1' locally
v1: Pulling from hello-world
Digest: sha256:662dd8e65ef7ccf13f417962c2f77567d3b132f12c95909de6c85ac3c326a345
Status: Downloaded newer image for mycontainerregistry.azurecr.io/hello-world:v1
Hello from Docker!
This message shows that your installation appears to be working correctly.
[...]
Limpar recursos
Quando terminar de trabalhar com os recursos criados neste guia de início rápido, use o comando Remove-AzResourceGroup para remover o grupo de recursos, o registro de contêiner e as imagens de contêiner armazenadas lá:
Remove-AzResourceGroup -Name myResourceGroup
Próximas etapas
Neste início rápido, você criou um Registro de Contêiner do Azure com o Azure PowerShell, efetuou push de uma imagem de contêiner e extraiu e executou a imagem do Registro. Prossiga para os tutoriais de Registro de Contêiner do Azure para uma análise mais profunda do ACR.