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 dê 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 obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira 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 as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute o comando az version para localizar 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 dê suporte a registros conectados.

• Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira 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 as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute o comando az version para localizar 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. Essa etapa é necessária para que um registro conectado se comunique com o registro de nuvem.

1. No portal do Azure, navegue até o registro de contêiner.
2. Selecione Acesso público de rede>. Selecione Habilitar ponto de extremidade de dados dedicado na caixa de seleção.
3. Clique em Salvar.

Habilita o ponto de extremidade de dados dedicado para o registro de contêiner do Azure na nuvem usando o comando az acr update. Essa etapa é necessária para que um registro conectado se comunique com o registro de 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 que está vinculado ao registro de nuvem.

1. No portal do Azure, navegue até o registro de contêiner.
2. Selecione Registros Conectados (Versão Prévia) > + 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

Esse comando cria um recurso de registro conectado cujo nome é o valor de $CONNECTED_REGISTRY_RO e o vincula ao registro de nuvem nomeado com o valor de $REGISTRY_NAME.

• Os repositórios especificados são sincronizados entre o registro pai cujo nome é o valor de $CONNECTED_REGISTRY_RW e o registro conectado após a implantação.
• O recurso é criado no modo ReadOnly, que habilita a funcionalidade somente leitura (pull de artefato) depois de implantado.
• 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 registro conectado no modo ReadOnly cujo pai é o registro conectado que você criou na seção anterior. Quando implantado, esse registro conectado habilita a funcionalidade somente leitura (pull de artefato).

1. No portal do Azure, navegue até o registro de contêiner.
2. Selecione Registros Conectados (Versão Prévia) > + 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

Esse comando cria um recurso de registro conectado cujo nome é o valor de $CONNECTED_REGISTRY_RO e o vincula ao registro de nuvem nomeado com o valor de $REGISTRY_NAME.

• Os repositórios especificados são sincronizados entre o registro pai cujo nome é o valor de $CONNECTED_REGISTRY_RW e o registro conectado após a implantação.
• O recurso é criado no modo ReadOnly, que habilita a funcionalidade somente leitura (pull de artefato) depois de implantado.
• 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 registro conectado no portal para exibir as propriedades desse registro, como status de conexão (Offline, Online ou Não Íntegro) e se ele foi ativado (implantado localmente). No exemplo a seguir, o registro conectado não está implantado. O estado de conexão de "Offline" indica que ele se desconectou da nuvem.

Nessa 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 as configurações usadas para implantar um registro conectado e sincronizar conteúdo com um registro pai.

Você pode usar o comando de registro conectado 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 conforme a seguir. Como os registros conectados ainda não foram implantados, o estado de conexão de "Offline" indica que eles estão desconectados da nuvem no momento.

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