Guida introduttiva: Creare un registro connesso con l'interfaccia della riga di comando di Azure

Articolo
10/31/2023

In questa guida introduttiva si usa l'interfaccia della riga di comando di Azure per creare una risorsa del Registro di sistema connessa in Azure. La funzionalità del Registro di sistema connessa di Registro Azure Container consente di distribuire un registro in remoto o in locale e sincronizzare immagini e altri artefatti con il registro cloud.

Qui vengono create due risorse del Registro di sistema connesse per un registro cloud: un registro connesso consente la funzionalità di lettura e scrittura (pull e push degli artefatti) e una consente la funzionalità di sola lettura.

Dopo aver creato un registro connesso, è possibile seguire altre guide per distribuire e usarlo nell'infrastruttura locale o remota.

Prerequisiti

Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
- Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
- Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
- Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Registro Azure Container: se non si ha già un registro contenitori, crearne uno (livello Premium necessario) in un'area che supporta registri connessi.

Abilitare l'endpoint dati dedicato per il registro cloud

Abilitare l'endpoint dati dedicato per il Registro Azure Container nel cloud usando il comando az acr update . Questo passaggio è necessario per consentire a un registro connesso di comunicare con il registro 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

Importare immagini nel registro cloud

Importare le immagini del contenitore seguenti nel registro cloud usando il comando az acr import . Ignorare questo passaggio se queste immagini sono già state importate.

Immagine del Registro di sistema connessa

Per supportare scenari di IoT Edge annidati, l'immagine del contenitore per il runtime del Registro di sistema connesso deve essere disponibile nel Registro Azure Container privato. Usare il comando az acr import per importare l'immagine del Registro di sistema connessa nel registro privato.

# 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 immagini proxy API

Per supportare il Registro di sistema connesso in IoT Edge annidati, è necessario distribuire moduli per il proxy API e il IoT Edge. Importare queste immagini nel registro privato.

Il modulo proxy API IoT Edge consente a un dispositivo IoT Edge di esporre più servizi usando il protocollo HTTPS sulla stessa porta, ad esempio 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

Immagine Hello-world

Per testare il Registro di sistema connesso, importare l'immagine hello-world . Questo repository verrà sincronizzato con il Registro di sistema connesso ed eseguito il pull dai client del Registro di sistema connessi.

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

Creare una risorsa del Registro di sistema connessa per la funzionalità di lettura e scrittura

Creare un registro connesso usando il comando az acr connected-registry create . Il nome del Registro di sistema connesso deve iniziare con una lettera e contenere solo caratteri alfanumerici. Deve essere lungo da 5 a 40 caratteri e univoco nella gerarchia per questo registro Contenitori di 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"

Questo comando crea una risorsa del Registro di sistema connessa il cui nome è il valore di $CONNECTED_REGISTRY_RW e la collega al registro cloud il cui nome è il valore di $REGISTRY_NAME. Nelle guide di avvio rapido successive vengono fornite informazioni sulle opzioni per distribuire il Registro di sistema connesso.

I repository specificati verranno sincronizzati tra il registro cloud e il Registro di sistema connesso dopo la distribuzione.
Poiché non viene specificata alcuna --mode opzione per il Registro di sistema connesso, viene creata nella modalità ReadWrite predefinita.
Poiché non è stata definita alcuna pianificazione di sincronizzazione per questo registro connesso, i repository verranno sincronizzati tra il Registro di sistema cloud e il Registro di sistema connesso senza interruzioni.

Importante

Per supportare scenari annidati in cui i livelli inferiori non hanno accesso a Internet, è sempre necessario consentire la sincronizzazione del acr/connected-registry repository. Questo repository contiene l'immagine per il runtime del Registro di sistema connesso.

Creare una risorsa del Registro di sistema connessa per la funzionalità di sola lettura

È anche possibile usare il comando az acr connected-registry create per creare un registro connesso con funzionalità di sola lettura.

# 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

Questo comando crea una risorsa del Registro di sistema connessa il cui nome è il valore di $CONNECTED_REGISTRY_RO e la collega al registro cloud denominato con il valore di $REGISTRY_NAME.

I repository specificati verranno sincronizzati tra il Registro di sistema padre denominato con il valore di $CONNECTED_REGISTRY_RW e il Registro di sistema connesso dopo la distribuzione.
Questa risorsa viene creata in modalità ReadOnly, che abilita la funzionalità di sola lettura (pull artefatto) dopo la distribuzione.
Poiché non è stata definita alcuna pianificazione di sincronizzazione per questo Registro di sistema connesso, i repository verranno sincronizzati tra il Registro di sistema padre e il Registro di sistema connesso senza interruzioni.

Verificare che siano state create le risorse

È possibile usare il comando az acr connected-registry list per verificare che le risorse vengano create.

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

Verrà visualizzata una risposta come indicato di seguito. Poiché i registri connessi non sono ancora distribuiti, lo stato di connessione "Offline" indica che sono attualmente disconnessi dal cloud.

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

Passaggi successivi

In questa guida introduttiva è stata usata l'interfaccia della riga di comando di Azure per creare due risorse del Registro di sistema connesse in Azure. Queste nuove risorse del Registro di sistema connesse sono associate al registro cloud e consentono la sincronizzazione degli artefatti con il registro cloud.

Continuare con le guide alla distribuzione del Registro di sistema connesso per informazioni su come distribuire e usare un registro connesso nell'infrastruttura di IoT Edge.

Guida introduttiva: Distribuire il Registro di sistema connesso in IoT Edge

Share via