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

  • Artikel
  • 5 minuten om te lezen

In deze quickstart gebruikt u de Azure CLI om een verbonden registerresource te maken in Azure. Met de verbonden registerfunctie 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 registerbronnen voor een cloudregister: één verbonden register staat functionaliteit voor lezen en schrijven (artefact pull en push) toe en één biedt alleen-lezen functionaliteit.

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.

    Cloud Shell starten in een nieuw venster

  • Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.

    • 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 de 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 verbonden registers ondersteunt.

Het toegewezen gegevens-eindpunt voor het cloudregister inschakelen

Schakel het toegewezen gegevens-eindpunt voor het Azure-containerregister in de cloud in 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

Afbeeldingen importeren in uw cloudregister

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

Verbonden registerafbeelding

Ter ondersteuning van geneste IoT Edge scenario's, moet de container-afbeelding voor de verbonden registerruntime beschikbaar zijn in uw persoonlijke Azure-containerregister. Gebruik de opdracht az acr import om de verbonden registerafbeelding in uw persoonlijke register te importeren.

# 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.5.0

IoT Edge en API-proxy-afbeeldingen

Als u het verbonden register wilt ondersteunen op geneste IoT Edge, moet u modules implementeren voor de IoT Edge api-proxy. Importeer deze afbeeldingen in uw privéregister.

Met 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

Hallo wereld-afbeelding

Importeer de -afbeelding om het verbonden register te hello-world testen. Deze opslagplaats wordt gesynchroniseerd met het verbonden register en wordt door de verbonden register-clients binnengehaald.

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 behulp van de opdracht az acr connected-registry create. De verbonden registernaam moet beginnen met een letter en mag 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 deze aan het cloudregister waarvan de naam de waarde van $REGISTRY_NAME is. In latere snelstartgidsen vindt u 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 --mode geen optie is opgegeven voor het verbonden register, wordt deze gemaakt in de standaardmodus LezenSchrijven.

  • Omdat er geen synchronisatieplanning is gedefinieerd voor dit verbonden register, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het cloudregister en het verbonden register.

    Belangrijk

    Als u geneste scenario's wilt ondersteunen waarbij lagere lagen geen toegang tot internet hebben, moet u altijd synchronisatie van de opslagplaats acr/connected-registry toestaan. Deze opslagplaats bevat de -afbeelding 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 u 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 het is geïmplementeerd.
  • Deze resource wordt gemaakt in de modus ReadOnly,waarmee functionaliteit voor alleen-lezen (artefact pull) wordt ingeschakeld nadat deze is geïmplementeerd.
  • Omdat er geen synchronisatieplanning 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 az acr connected-registry list van het verbonden register gebruiken om te controleren of de resources zijn gemaakt.

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

U ziet een antwoord als volgt. Omdat de verbonden registers nog niet zijn geïmplementeerd, geeft de verbindingstoestand 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 registerbronnen zijn gekoppeld aan uw cloudregister en maken synchronisatie van artefacten met het cloudregister mogelijk.

Ga door naar de handleidingen voor verbonden registerimplementaties voor meer informatie over het implementeren en gebruiken van een verbonden register in IoT Edge infrastructuur.

Quickstart: Verbonden register implementeren op IoT Edge