Een verbonden register maken voor uw Azure Container Registry

In dit artikel wordt beschreven hoe u de Azure CLI of Azure Portal gebruikt om een verbonden registerresource te maken in Azure. Met de functie voor verbonden registers van Azure Container Registry kunt u op afstand of lokaal een register implementeren en containerafbeeldingen en andere artefacten synchroniseren met een cloudgebaseerd Azure-containerregister.

In dit artikel maakt u twee verbonden registerresources voor een bestaand cloudregister: een die lees- en schrijffunctionaliteit (artefact pull en push) ondersteunt en een die alleen-lezenfunctionaliteit ondersteunt.

Nadat u een verbonden register hebt gemaakt, kunt u dit implementeren en gebruiken in uw on-premises of externe infrastructuur.

Vereiste voorwaarden

U moet een Azure Container Registry hebben in de Premium SKU (prijsplan) om de verbonden registerfunctie te kunnen gebruiken. Als u nog geen containerregister hebt, maakt u er een en selecteert u Premium voor prijsabonnement.

Zelfs als u de Azure portal gebruikt om uw verbonden registerresource te maken, gebruiken deze stappen Azure CLI om images te importeren in het containerregister.

Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.
Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container te draaien. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.
- Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.
- Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.
- Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Het toegewezen gegevenseindpunt voor het cloudregister inschakelen

Schakel het toegewezen gegevenseindpunt in voor het Azure-containerregister in de cloud. Deze stap is nodig om het verbonden register te laten communiceren met het cloudregister.

Azure-portal
Azure-CLI

Ga in Azure Portal naar uw containerregister.
Selecteer Netwerken in het servicemenu onder Instellingen.
Schakel in de sectie Openbare toegang het selectievakje Toegewezen gegevenseindpunt inschakelen in.
Selecteer Opslaan.

Gebruik de opdracht az acr update :

# 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 je cloudregister

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

Verbonden registerafbeelding

Gebruik de az acr import opdracht om de verbonden registerimage naar uw privé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:1.0.0

Hello-world-afbeelding

Importeer de hello-world-afbeelding om het verbonden register te 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

Volg deze stappen om een verbonden register te maken in de ReadWrite-modus die is gekoppeld aan uw cloudregister.

Azure-portal
Azure-CLI

Ga in Azure Portal naar uw containerregister.
Selecteer verbonden registers in het servicemenu onder Services.
Klik op Creëren.

Voer de waarden in de volgende tabel in of selecteer deze en selecteer Opslaan.

Onderdeel	Beschrijving
Ouder	Selecteer Geen bovenliggend voor een aangesloten register dat direct gekoppeld is aan het cloudregister.
Wijze	Selecteer ReadWrite.
Naam	De naam van het verbonden register moet beginnen met een letter en mag alleen alfanumerieke tekens bevatten. Het moet 5 tot 40 tekens lang en uniek zijn in de hiërarchie voor dit Azure-containerregister.
Eigenschappen van logboekregistratie	Behoud de standaardinstellingen.
Synchronisatie-eigenschappen	Behoud de standaardinstellingen. Omdat er standaard geen synchronisatieschema is gedefinieerd, worden de opslagplaatsen zonder onderbrekingen gesynchroniseerd tussen het cloudregister en het verbonden register.
Opslagplaatsen	Selecteer of voer de namen in van de opslagplaatsen die u in de vorige stap hebt geïmporteerd. De opgegeven opslagplaatsen worden gesynchroniseerd tussen het cloudregister en het verbonden register zodra ze zijn geïmplementeerd.

Schermopname van de opties voor het maken van een verbonden register in de ReadWrite-modus.

Gebruik de opdracht az acr connected-registry create om een verbonden register te maken met de lees-/schrijffunctionaliteit.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-write functionality
CONNECTED_REGISTRY_RW=<connected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --name $CONNECTED_REGISTRY_RW \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadWrite

Met deze opdracht maakt u een verbonden registerresource met behulp van de waarde die is opgeslagen in $CONNECTED_REGISTRY_RW en koppelt u deze aan het cloudregister dat u eerder hebt opgegeven voor $REGISTRY_NAME.

De opgegeven opslagplaatsen worden gesynchroniseerd tussen het bovenliggende register en het verbonden register.
De resource wordt gemaakt in de ReadWrite-modus, waardoor push- en pull-functionaliteit mogelijk is.
De opslagplaatsen worden zonder onderbrekingen gesynchroniseerd tussen het bovenliggende register en het verbonden register, omdat er geen synchronisatieschema is gedefinieerd voor dit verbonden register.

Een verbonden registerresource maken voor alleen-lezenfunctionaliteit

Maak vervolgens een verbonden register in de readOnly-modus waarvan het bovenliggende register is dat u in de vorige sectie hebt gemaakt. Dit verbonden register maakt alleen-lezenfunctionaliteit (artefact pull) mogelijk zodra deze is geïmplementeerd.

Azure-portal
Azure-CLI

Selecteer opnieuw maken in verbonden registers.
Herhaal de stappen om een verbonden register te maken, met de volgende wijzigingen in de waarden in de vorige tabel:

Onderdeel Beschrijving

Ouder Selecteer het verbonden register dat u eerder hebt gemaakt.

Wijze Kies ReadOnly.
Selecteer Opslaan.

Onderdeel	Beschrijving
Ouder	Selecteer het verbonden register dat u eerder hebt gemaakt.
Wijze	Kies ReadOnly.

Gebruik de opdracht az acr connected-registry create om een verbonden register te maken met alleen-lezen functionaliteit.

# Set the CONNECTED_REGISTRY_READ environment variable to provide a name for the connected registry with read-only functionality
CONNECTED_REGISTRY_RO=<connected-registry-name>
az acr connected-registry create --registry $REGISTRY_NAME \
  --parent $CONNECTED_REGISTRY_RW \
  --name $CONNECTED_REGISTRY_RO \
  --repository "hello-world" "acr/connected-registry" \
  --mode ReadOnly

Met deze opdracht maakt u een verbonden registerresource met de naam met de waarde die is opgeslagen in $CONNECTED_REGISTRY_RO en koppelt deze aan hetzelfde cloudregister dat u eerder hebt opgegeven voor $REGISTRY_NAME.

De opgegeven opslagplaatsen worden gesynchroniseerd tussen het gekoppelde register $CONNECTED_REGISTRY_RW dat u in de vorige stap hebt gemaakt en het nieuwe verbonden register.
De resource wordt gemaakt in de ReadOnly-modus, waarmee alleen-lezenfunctionaliteit (artefact pull) mogelijk is.
De opslagplaatsen worden zonder onderbrekingen gesynchroniseerd tussen het bovenliggende register en het verbonden register, omdat er geen synchronisatieschema is gedefinieerd voor dit verbonden register.

Controleer of de middelen zijn aangemaakt

Nadat u de verbonden registerbronnen hebt gemaakt, controleert u of deze bestaan en bekijkt u de eigenschappen.

Azure-portal
Azure-CLI

Selecteer een verbonden register in de portal om de eigenschappen ervan weer te geven, zoals de verbindingsstatus (offline, online of beschadigd) en of het is geactiveerd (on-premises geïmplementeerd). In het volgende voorbeeld is het verbonden register nog niet geïmplementeerd, dus de verbindingsstatus is offline.

Schermopname van een verbonden register met de verbindingsstatus en andere eigenschappen.

In deze weergave kunt u verbindingsreeks selecteren om een verbindingsreeks te genereren, die configuratie-instellingen bevat die worden gebruikt voor het implementeren van een verbonden register en het synchroniseren van inhoud met een bovenliggend register. U kunt eventueel ook wachtwoorden genereren voor het synchronisatietoken.

Gebruik het commando az acr connected-registry list om te controleren of de resources zijn aangemaakt.

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

U ziet een antwoord dat lijkt op het onderstaande voorbeeld. Omdat de verbonden registers nog niet zijn geïmplementeerd, geeft de verbindingsstatus Offline aan dat ze momenteel niet zijn verbonden met de cloud.

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

Het synchronisatieschema en het venster voor verbonden registersynchronisatie configureren

Met de stappen in dit artikel maakt u verbonden registers zonder een gedefinieerd synchronisatieschema en -venster. Als u een specifieke planning wilt definiëren nadat u het register hebt gemaakt, gebruikt u de az acr connected-registry update opdracht om een planning in te stellen. Gebruik CRON-expressies om het synchronisatieschema en de ISO 8601-duurindeling voor het synchronisatievenster te definiëren.

Met de volgende opdracht configureert u bijvoorbeeld het verbonden register om een dagelijkse synchronisatie om 12:00 UUR UTC te plannen met een synchronisatievenster van 4 uur (PT4H):

az acr connected-registry update --registry myacrregistry \ 
--name myconnectedregistry \ 
--sync-schedule "0 12 * * *" \
--sync-window PT4H

Met deze voorbeeldopdracht wordt het verbonden register elke minuut gesynchroniseerd met het cloudregister:

az acr connected-registry update --registry myacrregistry \ 
--name myconnectedregistry \ 
--sync-schedule "* * * * *"

U kunt ook waarden invoeren voor het vensterPlanning en synchronisatie in de sectie Synchronisatie-eigenschappen van het verbonden register in Azure Portal.

Volgende stappen

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

Hierna leert u hoe u verbonden register implementeert in een Kubernetes-cluster met Azure Arc.

Feedback

Is deze pagina nuttig?

Last updated on 2026-01-24