Guida introduttiva: Creare un registro connesso usando il portale di Azure (deprecazione imminente)
In questa guida introduttiva si usa il portale di Azure per creare una risorsa registro connesso in Azure. La funzionalità registro connesso in Registro Azure Container consente di distribuire un registro in modalità remota o in locale e sincronizzare immagini e altri artefatti con il registro cloud.
Qui si creano due risorse registro 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 distribuirlo e usarlo nell'infrastruttura locale o remota.
Prerequisiti
- Registro Azure Container: se non si ha già un registro contenitori, crearne uno (livello Premium obbligatorio) in un'area che supporta i registri connessi.
Per importare immagini nel registro contenitori, usare l'interfaccia della riga di comando di Azure:
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su 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 tramite l'interfaccia della riga di comando di Azure.
Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. 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.
Abilitare l'endpoint dati dedicato per il registro cloud
Abilitare l'endpoint dati dedicato per il Registro Azure Container nel cloud. Questo passaggio è necessario per consentire a un registro connesso di comunicare con il registro cloud.
- Nel portale di Azure passare al registro contenitori.
- Selezionare Rete > Accesso pubblico. Selezionare la casella di controllo Abilita endpoint dati dedicato.
- Seleziona Salva.
Importare immagini nel registro cloud
Importare le seguenti immagini del contenitore nel registro cloud usando il comando az acr import. Ignorare questo passaggio se queste immagini sono già state importate.
Immagine del registro connesso
Per supportare scenari IoT Edge annidati, l'immagine del contenitore per il runtime del registro connesso deve essere disponibile nel Registro Azure Container privato. Usare il comando az acr import per importare l'immagine del registro 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
Immagini proxy dell'API e di IoT Edge
Per supportare il registro connesso in IoT Edge annidato, è necessario implementare moduli per il proxy dell'API e IoT Edge. Importare queste immagini nel registro privato.
Il modulo proxy dell'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 connesso, importare l'immagine hello-world. Questo repository verrà sincronizzato con il registro connesso per il pull dai client del registro connesso.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Creare una risorsa registro connesso per la funzionalità di lettura e scrittura
La procedura seguente consente di creare un registro connesso in modalità ReadWrite collegato al registro cloud.
- Nel portale di Azure passare al registro contenitori.
- Selezionare Registri connessi (anteprima) > + Crea.
- Immettere o selezionare i valori nella tabella seguente e selezionare Salva.
| Articolo | Descrizione |
|---|---|
| Parent | Selezionare Nessun elemento padre per un registro connesso collegato al registro cloud. |
| Modalità | Selezionare ReadWrite. |
| Nome | Il nome del registro connesso deve iniziare con una lettera e contenere solo caratteri alfanumerici. Deve avere una lunghezza compresa tra 5 e 40 caratteri e deve essere univoco nella gerarchia per questo registro Azure Container. |
| Proprietà della registrazione | Accettare le impostazioni predefinite. |
| Proprietà di sincronizzazione | Accettare le impostazioni predefinite. Poiché non esiste alcuna pianificazione di sincronizzazione definita per impostazione predefinita, i repository verranno sincronizzati tra il registro cloud e il registro connesso senza interruzioni. |
| Repository | Selezionare o immettere i nomi dei repository importati nel passaggio precedente. I repository specificati verranno sincronizzati tra il registro cloud e il registro connesso dopo la distribuzione. |
Importante
Per supportare scenari annidati in cui i livelli inferiori non hanno accesso a Internet, è sempre necessario consentire la sincronizzazione del repository acr/connected-registry. Questo repository contiene l'immagine per il runtime del registro connesso.
Creare una risorsa registro connesso per la funzionalità di sola lettura
La procedura seguente consente di creare un registro connesso in modalità ReadOnly il cui elemento padre è il registro connesso creato nella sezione precedente. Questo registro connesso abilita la funzionalità di sola lettura (pull degli artefatti) dopo la distribuzione.
- Nel portale di Azure passare al registro contenitori.
- Selezionare Registri connessi (anteprima) > + Crea.
- Immettere o selezionare i valori nella tabella seguente e selezionare Salva.
| Articolo | Descrizione |
|---|---|
| Parent | Selezionare il registro connesso creato in precedenza. |
| Modalità | Selezionare ReadOnly. |
| Nome | Il nome del registro connesso deve iniziare con una lettera e contenere solo caratteri alfanumerici. Deve avere una lunghezza compresa tra 5 e 40 caratteri e deve essere univoco nella gerarchia per questo registro Azure Container. |
| Proprietà della registrazione | Accettare le impostazioni predefinite. |
| Proprietà di sincronizzazione | Accettare le impostazioni predefinite. Poiché non esiste alcuna pianificazione di sincronizzazione definita per impostazione predefinita, i repository verranno sincronizzati tra il registro cloud e il registro connesso senza interruzioni. |
| Repository | Selezionare o immettere i nomi dei repository importati nel passaggio precedente. I repository specificati verranno sincronizzati tra il registro padre e il registro connesso dopo la distribuzione. |
Visualizzare le proprietà del registro connesso
Selezionare un registro connesso nel portale per visualizzarne le proprietà, ad esempio lo stato della connessione (offline, online o non integro) e se è stato attivato (distribuito in locale). Nell'esempio seguente il registro connesso non è distribuito. Lo stato di connessione "Offline" indica che è attualmente disconnesso dal cloud.
Da questa visualizzazione è anche possibile generare una stringa di connessione e, facoltativamente, generare le password per il token di sincronizzazione. Una stringa di connessione contiene le impostazioni di configurazione usate per la distribuzione di un registro connesso e la sincronizzazione del contenuto con un registro padre.
Passaggi successivi
In questa guida introduttiva è stato usato il portale di Azure per creare due risorse registro connesso in Azure. Queste nuove risorse registro connesso sono associate al registro cloud e consentono la sincronizzazione degli artefatti con il registro cloud.
Continuare con le guide alla distribuzione del registro connesso per informazioni su come distribuire e usare un registro connesso nell'infrastruttura IoT Edge.