Início Rápido: Criar um registo ligado com a CLI do Azure

Artigo
10/31/2023

Neste início rápido, vai utilizar a CLI do Azure para criar um recurso de registo ligado no Azure. A funcionalidade de registo ligado do Azure Container Registry permite-lhe implementar um registo remotamente ou no local e sincronizar imagens e outros artefactos com o registo na cloud.

Aqui, cria dois recursos de registo ligados para um registo na cloud: um registo ligado permite a funcionalidade de leitura e escrita (extração e push de artefactos) e outro permite a funcionalidade só de leitura.

Depois de criar um registo ligado, pode seguir outros guias para implementá-lo e utilizá-lo na sua infraestrutura no local ou remota.

Pré-requisitos

Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.
- Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.
- Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.
- Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Azure Container Registry – se ainda não tiver um registo de contentor, crie um (escalão Premium necessário) numa região que suporte registos ligados.

Ativar o ponto final de dados dedicado para o registo na cloud

Ative o ponto final de dados dedicado para o registo de contentor do Azure na cloud com o comando az acr update . Este passo é necessário para que um registo ligado comunique com o registo na cloud.

# 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

Importar imagens para o seu registo na cloud

Importe as seguintes imagens de contentor para o seu registo na cloud com o comando az acr import . Ignore este passo se já tiver importado estas imagens.

Imagem do registo ligado

Para suportar cenários de IoT Edge aninhados, a imagem de contentor do runtime de registo ligado tem de estar disponível no seu registo de contentor privado do Azure. Utilize o comando az acr import para importar a imagem do registo ligado para o seu registo privado.

# Use the REGISTRY_NAME variable in the following Azure CLI commands to identify the registry
REGISTRY_NAME=<container-registry-name>

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/acr/connected-registry:0.8.0

IoT Edge e imagens de proxy de API

Para suportar o registo ligado em IoT Edge aninhadas, tem de implementar módulos para o IoT Edge e o proxy de API. Importe estas imagens para o seu registo privado.

O módulo de proxy da API IoT Edge permite que um dispositivo IoT Edge exponha vários serviços através do protocolo HTTPS na mesma porta, como 443.

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/azureiotedge-agent:1.2.4

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/azureiotedge-hub:1.2.4

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/azureiotedge-api-proxy:1.1.2

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/azureiotedge-diagnostics:1.2.4

Imagem hello-world

Para testar o registo ligado, importe a hello-world imagem. Este repositório será sincronizado com o registo ligado e solicitado pelos clientes de registo ligados.

az acr import \
  --name $REGISTRY_NAME \
  --source mcr.microsoft.com/hello-world:1.1.2

Criar um recurso de registo ligado para a funcionalidade de leitura e escrita

Crie um registo ligado com o comando az acr connected-registry create . O nome do registo ligado tem de começar com uma letra e conter apenas carateres alfanuméricos. Tem de ter 5 a 40 carateres de comprimento e ser exclusivo na hierarquia deste registo de contentor do Azure.

# Set the CONNECTED_REGISTRY_RW environment variable to provide a name for the connected registry with read/write functionality
CONNECTED_REGISTRY_RW=<connnected-registry-name>

az acr connected-registry create --registry $REGISTRY_NAME \
  --name $CONNECTED_REGISTRY_RW \
  --repository "hello-world" "acr/connected-registry" "azureiotedge-agent" "azureiotedge-hub" "azureiotedge-api-proxy"

Este comando cria um recurso de registo ligado cujo nome é o valor de $CONNECTED_REGISTRY_RW e liga-o ao registo na nuvem cujo nome é o valor de $REGISTRY_NAME. Em guias de início rápido posteriores, ficará a saber mais sobre as opções para implementar o registo ligado.

Os repositórios especificados serão sincronizados entre o registo na cloud e o registo ligado assim que for implementado.
Uma vez que não é especificada nenhuma --mode opção para o registo ligado, é criada no modo ReadWrite predefinido.
Uma vez que não existe uma agenda de sincronização definida para este registo ligado, os repositórios serão sincronizados entre o registo na cloud e o registo ligado sem interrupções.

Importante

Para suportar cenários aninhados em que as camadas inferiores não têm acesso à Internet, tem sempre de permitir a sincronização do acr/connected-registry repositório. Este repositório contém a imagem do runtime do registo ligado.

Criar um recurso de registo ligado para funcionalidade só de leitura

Também pode utilizar o comando az acr connected-registry create para criar um registo ligado com funcionalidade só de 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" "azureiotedge-agent" "azureiotedge-hub" "azureiotedge-api-proxy" \
  --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 com o nome com o valor de $REGISTRY_NAME.

Os repositórios especificados serão sincronizados entre o registo principal com o nome com o valor de $CONNECTED_REGISTRY_RW e o registo ligado uma vez implementados.
Este recurso é criado no modo ReadOnly, que ativa a funcionalidade só de leitura (extração de artefactos) uma vez implementado.
Uma vez que não existe uma agenda de sincronização definida para este registo ligado, os repositórios serão sincronizados entre o registo principal e o registo ligado sem interrupções.

Verifique se os recursos foram criados

Pode utilizar o comando az acr connected-registry list do registo ligado do registo ligado para verificar se os recursos foram criados.

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

Deverá ver uma resposta da seguinte forma. Uma vez que os registos ligados ainda não estão implementados, o estado de ligação de "Offline" indica que estão atualmente desligados da cloud.

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

Passos seguintes

Neste início rápido, utilizou a CLI do Azure para criar dois recursos de registo ligados no Azure. Esses novos recursos de registo ligados estão associados ao seu registo na cloud e permitem a sincronização de artefactos com o registo na cloud.

Continue para os guias de implementação do registo ligado para saber como implementar e utilizar um registo ligado na sua infraestrutura de IoT Edge.

Início Rápido: Implementar o registo ligado no IoT Edge

Share via