Guia de início rápido: criar um registro conectado usando a CLI do Azure ou o portal do Azure

• Registro de contêiner do Azure - Se você ainda não tiver um registro de contêiner, crie um (camada Premium necessária) em uma região que ofereça suporte a registros conectados.

Para importar imagens para o registro de contêiner, use a CLI do Azure

• Utilize o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

• Registro de contêiner do Azure - Se você ainda não tiver um registro de contêiner, crie um (camada Premium necessária) em uma região que ofereça suporte a registros conectados.

• Utilize o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Habilite o ponto de extremidade de dados dedicado para o registro de contêiner do Azure na nuvem. Esta etapa é necessária para que um registro conectado se comunique com o registro na nuvem.

1. No portal do Azure, navegue até o registo do contentor.
2. Selecione > de rede. Marque a caixa de seleção Habilitar ponto de extremidade de dados dedicado.
3. Selecione Guardar.

Habilite o endpoint de dados dedicado para o registo de contentores do Azure na nuvem, usando o comando az acr update. Esta etapa é necessária para que um registro conectado se comunique com o registro na nuvem.

# Set the REGISTRY_NAME environment variable to identify the existing cloud registry
REGISTRY_NAME=<container-registry-name>

az acr update --name $REGISTRY_NAME \
  --data-endpoint-enabled

As etapas a seguir criam um registro conectado no modo ReadWrite vinculado ao registro na nuvem.

1. No portal do Azure, navegue até o registo do contentor.
2. Selecione Registros conectados (Visualização) > + Criar.
3. Insira ou selecione os valores na tabela a seguir e selecione Salvar.

Você também pode usar o comando az acr connected-registry create para criar um registro conectado com funcionalidade somente leitura.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Este comando cria um recurso de registo ligado cujo nome é o valor de $CONNECTED_REGISTRY_RO e liga-o ao registo na nuvem nomeado com o valor de $REGISTRY_NAME.

• Os repositórios especificados são sincronizados entre o registo principal nomeado com o valor de $CONNECTED_REGISTRY_RW e o registo conectado após a implementação.
• O recurso é criado no modo Somente Leitura, que habilita a funcionalidade somente leitura (extração de artefato) uma vez implantada.
• Os repositórios são sincronizados entre o registro pai e o registro conectado sem interrupções porque não há nenhum agendamento de sincronização definido para esse registro conectado.

As etapas a seguir criam um registo conectado em modo Somente Leitura, cujo registo principal é o registo conectado que você criou na seção anterior. Esse registro conectado permite a funcionalidade somente leitura (extração de artefato) uma vez implantada.

1. No portal do Azure, navegue até o registo do contentor.
2. Selecione Registros conectados (Visualização) > + Criar.
3. Insira ou selecione os valores na tabela a seguir e selecione Salvar.

Você também pode usar o comando az acr connected-registry create para criar um registro conectado com funcionalidade somente leitura.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connnected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Este comando cria um recurso de registo ligado cujo nome é o valor de $CONNECTED_REGISTRY_RO e liga-o ao registo na nuvem nomeado com o valor de $REGISTRY_NAME.

• Os repositórios especificados são sincronizados entre o registo principal nomeado com o valor de $CONNECTED_REGISTRY_RW e o registo conectado após a implementação.
• O recurso é criado no modo Somente Leitura, que habilita a funcionalidade somente leitura (extração de artefato) uma vez implantada.
• Os repositórios são sincronizados entre o registro pai e o registro conectado sem interrupções porque não há nenhum agendamento de sincronização definido para esse registro conectado.

Selecione um registo conectado no portal para visualizar as suas propriedades, como o estado da conexão (Offline, Online ou Inativo) e se foi ativado (implantado localmente). No exemplo a seguir, o registro conectado não é implantado. O estado de conexão de "Offline" indica que ele se desconectou da nuvem.

A partir dessa exibição, você também pode gerar uma cadeia de conexão e, opcionalmente, gerar senhas para o token de sincronização. Uma cadeia de conexão contém definições de configuração usadas para implantar um registro conectado e sincronizar conteúdo com um registro pai.

Você pode usar o comando connected registry az acr connected-registry list para verificar se os recursos foram criados.

az acr connected-registry list \
  --registry $REGISTRY_NAME \
  --output table

Você verá uma resposta da seguinte maneira. Como os registros conectados ainda não estão implantados, o estado de conexão de "Offline" indica que eles estão atualmente desconectados da nuvem.

NAME                 MODE        CONNECTION STATE    PARENT               LOGIN SERVER    LAST SYNC (UTC)
-------------------  --------    ------------------  -------------------  --------------  -----------------
myconnectedregrw    ReadWrite    Offline
myconnectedregro    ReadOnly     Offline             myconnectedregrw