Início rápido: Criar um registro conectado usando o portal do Azure (a ser preterido)
Neste guia de início rápido, você vai usar o portal 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 seu local e sincronizar imagens e outros artefatos com o registro de nuvem.
Aqui, você cria dois recursos de registro conectados para um registro de nuvem: um registro conectado permite a funcionalidade de leitura e gravação (pull e push de artefato) 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
- Registro de Contêiner do Azure – Se ainda não tiver um registro de contêiner, crie um (precisa da camada Premium) em uma região que dê suporte a registros conectados.
Para importar imagens para o registro de contêiner, use a CLI do Azure:
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções 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 estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com 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 extensões com a CLI do Azure.
Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.
Habilitar o ponto de extremidade de dados dedicado para o registro de nuvem
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.
- No Portal do Azure, navegue até o registro de contêiner.
- Selecione Rede > Acesso público. Marque a caixa de seleção Habilitar ponto de extremidade de dados dedicados.
- Clique em Salvar.
Importar imagens para o registro na nuvem
Importe as seguintes imagens de contêiner para o registro na nuvem usando o comando az acr import. Ignore esta etapa se você já importou essas imagens.
Imagem do registro conectado
Para dar suporte a cenários de IoT Edge aninhados, a imagem de contêiner para o runtime do registro conectado deve estar disponível no registro de contêiner privado do Azure. Use o comando az acr import para importar a imagem de registro conectado para o 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 do proxy de API e IoT Edge
Para dar suporte ao registro conectado no IoT Edge aninhado, é necessário implantar módulos para o proxy de API e IoT Edge. Importe essas imagens para o registro privado.
O módulo de proxy de API do IoT Edge permite que um dispositivo de 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 de olá, mundo
Para testar o registro conectado, importe a imagem hello-world. Esse repositório será sincronizado com o registro conectado e enviado para os clientes do registro conectado.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Criar um recurso de registro conectado para a funcionalidade de leitura e gravação
As etapas a seguir criam um registro conectado no modo ReadWrite que está vinculado ao registro de nuvem.
- No Portal do Azure, navegue até o registro de contêiner.
- Selecione Registros conectados (Versão prévia) > + Criar.
- Insira ou selecione os valores na tabela a seguir e selecione Salvar.
| Item | Descrição |
|---|---|
| Pai | Selecione Nenhum pai para um registro conectado vinculado ao registro de nuvem. |
| Modo | Selecione ReadWrite. |
| Name | O nome do registro conectado precisa começar com uma letra e conter somente caracteres alfanuméricos. Ele deve ter de 5 a 40 caracteres e ser exclusivo na hierarquia para esse registro de contêiner do Azure. |
| Propriedades de log | Você pode aceitar as configurações padrão. |
| Propriedades de sincronização | Você pode aceitar as configurações padrão. Como não há nenhum agendamento de sincronização definido por padrão, os repositórios serão sincronizados entre o registro de nuvem e o registro conectado sem interrupções. |
| Repositórios | Selecione ou insira os nomes dos repositórios importados na etapa anterior. Os repositórios especificados serão sincronizados entre o registro de nuvem e o registro conectado depois que ele for implantado. |
Importante
Para dar suporte a cenários aninhados em que camadas inferiores não têm acesso à Internet, você sempre deve permitir a sincronização do repositório acr/connected-registry. Esse repositório contém a imagem do runtime do registro conectado.
Criar um recurso de registro conectado para a funcionalidade de somente leitura
As etapas a seguir criam um registro conectado no modo ReadOnly cujo pai é o registro conectado criado na seção anterior. Quando implantado, esse registro conectado habilita a funcionalidade somente leitura (pull de artefato).
- No Portal do Azure, navegue até o registro de contêiner.
- Selecione Registros conectados (Versão prévia) > + Criar.
- Insira ou selecione os valores na tabela a seguir e selecione Salvar.
| Item | Descrição |
|---|---|
| Pai | Selecione o registro conectado que você criou anteriormente. |
| Modo | Selecione ReadOnly. |
| Name | O nome do registro conectado precisa começar com uma letra e conter somente caracteres alfanuméricos. Ele deve ter de 5 a 40 caracteres e ser exclusivo na hierarquia para esse registro de contêiner do Azure. |
| Propriedades de log | Você pode aceitar as configurações padrão. |
| Propriedades de sincronização | Você pode aceitar as configurações padrão. Como não há nenhum agendamento de sincronização definido por padrão, os repositórios serão sincronizados entre o registro de nuvem e o registro conectado sem interrupções. |
| Repositórios | Selecione ou insira os nomes dos repositórios importados na etapa anterior. Os repositórios especificados serão sincronizados entre o registro pai e o registro conectado depois que ele for implantado. |
Exibir propriedades do 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 "Offline" indica que ele está desconectado da nuvem no momento.
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 definições de configuração usadas para implantar um registro conectado e sincronizar o conteúdo com um registro pai.
Próximas etapas
Neste início rápido, você usou o portal do Azure para criar dois recursos de registro conectado no Azure. Esses novos recursos de registro conectados estão vinculados ao registro de nuvem e permitem a sincronização de artefatos com o registro de nuvem.
Continue nos guias de implantação do registro conectado para saber como implantar e usar um registro conectado em sua infraestrutura de IoT Edge.