Guida introduttiva: Creare un registro connesso usando il portale di Azure
In questa guida introduttiva si userà il portale 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
- Registro Azure Container: se non si ha già un registro contenitori, crearne uno (livello Premium necessario) in un'area che supporta 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 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.
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.
- Selezionare Salva.
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
La procedura seguente consente di creare un registro connesso in modalità ReadWrite collegato al Registro di sistema 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.
| Elemento | Descrizione |
|---|---|
| Padre | Selezionare Nessun elemento padre per un registro connesso collegato al registro cloud. |
| Modalità | Selezionare ReadWrite. |
| Nome | 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. |
| 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 di sistema cloud e il Registro di sistema 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 di sistema 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 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
La procedura seguente consente di creare un Registro di sistema connesso in modalità ReadOnly il cui padre è il Registro di sistema 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.
| Elemento | Descrizione |
|---|---|
| Padre | Selezionare il Registro di sistema connesso creato in precedenza. |
| Modalità | Selezionare ReadOnly. |
| Nome | 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. |
| 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 di sistema cloud e il Registro di sistema connesso senza interruzioni. |
| Repository | Selezionare o immettere i nomi dei repository importati nel passaggio precedente. I repository specificati verranno sincronizzati tra il Registro di sistema padre e il Registro di sistema connesso dopo la distribuzione. |
Visualizzare le proprietà del Registro di sistema connesse
Selezionare un Registro di sistema 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 di sistema connesso non viene 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 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 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 di sistema cloud.
Continuare con le guide alla distribuzione del Registro di sistema connesse per informazioni su come distribuire e usare un Registro di sistema connesso nell'infrastruttura di IoT Edge.