Guia de início rápido: criar um registro conectado usando a CLI do Azure (a ser preterido)
Neste início rápido, você usa a CLI do Azure para criar um recurso de registro conectado no Azure. O recurso de registro conectado do Registro de Contêiner do Azure permite implantar um registro remotamente ou em suas instalações e sincronizar imagens e outros artefatos com o registro na nuvem.
Aqui você cria dois recursos de registro conectados para um registro em nuvem: um registro conectado permite a funcionalidade de leitura e gravação (extração e envio de artefatos) e outro permite a funcionalidade somente leitura.
Depois de criar um registro conectado, você pode seguir outros guias para implantá-lo e usá-lo em sua infraestrutura local ou remota.
Pré-requisitos
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para 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, consulte Como executar a CLI do Azure em um contêiner 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 entrada, consulte Entrar com a CLI do Azure.
Quando solicitado, 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.
- 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.
Habilite o ponto de extremidade de dados dedicado para o registro na nuvem
Habilite o ponto de extremidade de dados dedicado para o registro de contêiner 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
Importar imagens para o seu registo na nuvem
Importe as seguintes imagens de contêiner para seu registro na nuvem usando o comando az acr import . Ignore esta etapa se você já importou essas imagens.
Imagem de registo ligada
Para dar suporte a cenários aninhados do IoT Edge, a imagem do contêiner para o tempo de execução do Registro conectado deve estar disponível em seu registro de contêiner privado do Azure. Use o comando az acr import para importar a imagem do registro conectado para seu registro 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
Imagens de proxy do IoT Edge e da API
Para dar suporte ao registro conectado no IoT Edge aninhado, você precisa implantar 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 do IoT Edge permite que um dispositivo IoT Edge exponha vários serviços usando o 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 registro conectado, importe a hello-world imagem. Este repositório será sincronizado com o registro conectado e puxado pelos clientes de registro conectados.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Criar um recurso do Registro conectado para funcionalidade de leitura e gravação
Crie um registro conectado usando o comando az acr connected-registry create . O nome do Registro conectado deve começar com uma letra e conter apenas caracteres alfanuméricos. Ele deve ter de 5 a 40 caracteres e ser exclusivo na hierarquia para este registro de contêiner 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, você aprenderá sobre as opções para implantar o registro conectado.
Os repositórios especificados serão sincronizados entre o registro na nuvem e o registro conectado assim que ele for implantado.
Como nenhuma
--modeopção é especificada para o registro conectado, ela é criada no modo ReadWrite padrão.Como não há nenhum agendamento de sincronização definido para esse registro conectado, os repositórios serão sincronizados entre o registro na nuvem e o registro conectado sem interrupções.
Importante
Para suportar cenários aninhados em que as camadas inferiores não têm acesso à Internet, você deve sempre permitir a
acr/connected-registrysincronização do repositório. Este repositório contém a imagem para o tempo de execução do registro conectado.
Criar um recurso do Registro conectado para funcionalidade somente leitura
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" "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 nomeado com o valor de $REGISTRY_NAME.
- Os repositórios especificados serão sincronizados entre o registro pai nomeado com o valor de $CONNECTED_REGISTRY_RW e o registro conectado uma vez implantado.
- Esse recurso é criado no modo Somente leitura, que habilita a funcionalidade somente leitura (extração de artefato) depois de implantada.
- Como não há nenhum agendamento de sincronização definido para esse registro conectado, os repositórios serão sincronizados entre o registro pai e o registro conectado sem interrupções.
Verifique se os recursos foram criados
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
Próximos passos
Neste início rápido, você usou a CLI do Azure para criar dois recursos de registro conectados no Azure. Esses novos recursos de registro conectados estão vinculados ao seu registro de nuvem e permitem a sincronização de artefatos com o registro de nuvem.
Continue para os guias de implantação do Registro conectado para saber como implantar e usar um Registro conectado em sua infraestrutura do IoT Edge.