Quickstart: Een verbonden register maken met behulp van de Azure CLI

Artikel
10/31/2023

In deze quickstart gebruikt u de Azure CLI om een verbonden registerresource te maken in Azure. Met de functie verbonden register van Azure Container Registry kunt u een register op afstand of op uw locatie implementeren en afbeeldingen en andere artefacten synchroniseren met het cloudregister.

Hier maakt u twee verbonden registerresources voor een cloudregister: met één verbonden register kunt u lezen en schrijven (artefact-pull en push) en één staat alleen-lezenfunctionaliteit toe.

Nadat u een verbonden register hebt gemaakt, kunt u andere handleidingen volgen om het te implementeren en te gebruiken in uw on-premises of externe infrastructuur.

Vereisten

Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Quickstart voor Bash in Azure Cloud Shell voor meer informatie.
Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.
- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.
- Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.
- Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

Azure Container Registry: als u nog geen containerregister hebt, maakt u er een (Premium-laag vereist) in een regio die ondersteuning biedt voor verbonden registers.

Het toegewezen gegevenseindpunt voor het cloudregister inschakelen

Schakel het toegewezen gegevenseindpunt in voor het Azure-containerregister in de cloud met behulp van de opdracht az acr update . Deze stap is nodig om een verbonden register te laten communiceren met het cloudregister.

# 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

Installatiekopieën importeren in uw cloudregister

Importeer de volgende containerinstallatiekopieën in uw cloudregister met behulp van de opdracht az acr import . Sla deze stap over als u deze afbeeldingen al hebt geïmporteerd.

Installatiekopieën van verbonden register

Ter ondersteuning van geneste IoT Edge scenario's moet de containerinstallatiekopie voor de verbonden registerruntime beschikbaar zijn in uw persoonlijke Azure-containerregister. Gebruik de opdracht az acr import om de verbonden registerinstallatiekopieën te importeren in uw privéregister.

# 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- en API-proxy-installatiekopieën

Als u het verbonden register op geneste IoT Edge wilt ondersteunen, moet u modules implementeren voor de IoT Edge en API-proxy. Importeer deze installatiekopieën in uw persoonlijke register.

Met de IoT Edge API-proxymodule kan een IoT Edge apparaat meerdere services beschikbaar maken met behulp van het HTTPS-protocol op dezelfde poort, zoals 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

Hello-world-afbeelding

Importeer de installatiekopieën om het verbonden register te hello-world testen. Deze opslagplaats wordt gesynchroniseerd met het verbonden register en opgehaald door de verbonden registerclients.

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

Een verbonden registerresource maken voor lees- en schrijffunctionaliteit

Maak een verbonden register met de opdracht az acr connected-registry create . De naam van het verbonden register moet beginnen met een letter en alleen alfanumerieke tekens bevatten. Deze moet 5 tot 40 tekens lang zijn en uniek zijn in de hiërarchie voor dit Azure-containerregister.

# 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"

Met deze opdracht maakt u een verbonden registerresource waarvan de naam de waarde van $CONNECTED_REGISTRY_RW is en koppelt u deze aan het cloudregister waarvan de naam de waarde van $REGISTRY_NAME is. In latere quickstartgidsen krijgt u meer informatie over opties voor het implementeren van het verbonden register.

De opgegeven opslagplaatsen worden gesynchroniseerd tussen het cloudregister en het verbonden register zodra het is geïmplementeerd.
Omdat er geen --mode optie is opgegeven voor het verbonden register, wordt het gemaakt in de standaardmodus ReadWrite.
Omdat er geen synchronisatieschema is gedefinieerd voor dit verbonden register, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het cloudregister en het verbonden register.

Belangrijk

Ter ondersteuning van geneste scenario's waarbij lagere lagen geen toegang tot internet hebben, moet u altijd synchronisatie van de acr/connected-registry opslagplaats toestaan. Deze opslagplaats bevat de installatiekopieën voor de verbonden registerruntime.

Een verbonden registerresource maken voor alleen-lezenfunctionaliteit

U kunt ook de opdracht az acr connected-registry create gebruiken om een verbonden register met alleen-lezenfunctionaliteit te maken.

# 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

Met deze opdracht maakt u een verbonden registerresource waarvan de naam de waarde van $CONNECTED_REGISTRY_RO is en koppelt deze aan het cloudregister met de naam met de waarde $REGISTRY_NAME.

De opgegeven opslagplaatsen worden gesynchroniseerd tussen het bovenliggende register met de naam met de waarde $CONNECTED_REGISTRY_RW en het verbonden register zodra deze is geïmplementeerd.
Deze resource wordt gemaakt in de modus ReadOnly, waarmee alleen-lezenfunctionaliteit (artefact pull) mogelijk is zodra deze is geïmplementeerd.
Omdat er geen synchronisatieschema is gedefinieerd voor dit verbonden register, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het bovenliggende register en het verbonden register.

Controleer of de resources zijn gemaakt

U kunt de opdracht verbonden register az acr connected-registry list gebruiken om te controleren of de resources zijn gemaakt.

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

Als het goed is, ziet u als volgt een antwoord. Omdat de verbonden registers nog niet zijn geïmplementeerd, geeft de verbindingsstatus 'Offline' aan dat ze momenteel zijn losgekoppeld van de cloud.

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

Volgende stappen

In deze quickstart hebt u de Azure CLI gebruikt om twee verbonden registerresources te maken in Azure. Deze nieuwe verbonden registerresources zijn gekoppeld aan uw cloudregister en maken synchronisatie van artefacten met het cloudregister mogelijk.

Ga door naar de implementatiehandleidingen voor verbonden registers voor meer informatie over het implementeren en gebruiken van een verbonden register op uw IoT Edge-infrastructuur.

Quickstart: Verbonden register implementeren op IoT Edge