Azure Container Registry eindpuntreferentie

Azure Container Registry verschillende eindpunttypen beschikbaar maakt, afhankelijk van de configuratie van uw register. Dit artikel bevat een verwijzing voor elk eindpunttype, hoe u deze kunt weergeven en de CLI-vlaggen die deze beheren.

Zie Geo-replication in Azure Container Registry voor informatie over geo-replicatie en regionale eindpunten. Zie Dedicated data endpoints in Azure Container Registry voor meer informatie over toegewezen gegevenseindpunten.

Eindpunttypen

Eindpunttype URL-indeling Purpose Gebruiksituatie
Globaal eindpunt myregistry.azurecr.io Aanmeldingsserver met door Azure beheerde routering naar een geo-replica Standaard; optimaal voor de meeste scenario's
Regionaal eindpunt myregistry.<region-name>.geo.azurecr.io Aanmeldingsserver voor een specifieke geo-replica Voorspelbare routering, failover aan clientzijde, regionale affiniteit, probleemoplossing
Toegewezen gegevenseindpunt myregistry.<region-name>.data.azurecr.io Laagblobdownloads voor registers met toegewezen gegevenseindpunten of privé-eindpunten Firewallregels met bereik; automatische 307-omleiding vanaf aanmeldingsserver tijdens pulls
opslagaccount *.blob.core.windows.net Laagblobdownloads voor registers zonder toegewezen gegevenseindpunten of privé-eindpunten Automatische omleiding vanaf aanmeldingsserver

Alle eindpunten weergeven

Gebruik de az acr show-endpoints opdracht om alle eindpunten voor uw register weer te geven, inclusief de globale URL, regionale eindpunten (indien ingeschakeld) en toegewezen gegevenseindpunten (indien ingeschakeld):

az acr show-endpoints --name myregistry --resource-group myrg

Voorbeelduitvoer voor een register met regionale eindpunten en toegewezen gegevenseindpunten ingeschakeld:

{
    "loginServer": "myregistry.azurecr.io",
    "dataEndpoints": [
        {
            "region": "eastus",
            "endpoint": "myregistry.eastus.data.azurecr.io"
        },
        {
            "region": "westus",
            "endpoint": "myregistry.westus.data.azurecr.io"
        }
    ],
    "regionalEndpoints": [
        {
            "region": "eastus",
            "endpoint": "myregistry.eastus.geo.azurecr.io"
        },
        {
            "region": "westus",
            "endpoint": "myregistry.westus.geo.azurecr.io"
        }
    ]
}

CLI-vlaggen voor registereindpunten

Important

Verschillende CLI-vlaggen bepalen verschillende eindpuntgedragen. Het onderscheid is belangrijk om onjuiste configuratie te voorkomen.

Flag Scope Purpose
--regional-endpoints Registerniveau (op az acr create of az acr update) Hiermee schakelt u toegewezen regionale eindpunt-URL's (myregistry.<region>.geo.azurecr.io) in voor alle geo-replica's.
--global-endpoint-routing Per geo-replica (aan az acr replication create of az acr replication update) Hiermee bepaalt u of het globale eindpunt (myregistry.azurecr.io) verkeer routeert naar een specifieke geo-replica. Ingesteld om false tijdelijk een geo-replica uit te sluiten van globale eindpuntroutering (voor onderhoud of probleemoplossing). Gegevens worden nog steeds gesynchroniseerd, ongeacht deze instelling. Zie Tijdelijk een geo-replica uitsluiten van globale eindpuntroutering.
--data-endpoint-enabled Registerniveau (op az acr create of az acr update) Hiermee schakelt u toegewezen gegevenseindpunten (myregistry.<region>.data.azurecr.io) in voor laag-blobdownloads. Automatisch ingeschakeld wanneer ten minste één privé-eindpunt is geconfigureerd. Zie Toegewezen gegevenseindpunten.
--endpoint-protocol Registerniveau (op az acr update) Hiermee stelt u het eindpuntprotocol van het register in op IPv4 (standaard) of IPv4AndIPv6 (dubbele stack). Voor de instelling IPv4AndIPv6 moeten toegewezen gegevenseindpunten zijn ingeschakeld (--data-endpoint-enabled true). Vereist Azure CLI 2.87.0 of hoger. Zie IPv6-eindpunten met dubbele stack.

Relatie tussen --regional-endpoints en --global-endpoint-routing

--regional-endpoints en --global-endpoint-routing zijn onafhankelijk. Instellen --global-endpoint-routing false op een geo-replica:

  • Sluit deze geo-replica alleen uit van globale eindpuntroutering .
  • Schakelt de regionale eindpunt-URL van de geo-replica niet uit. Als --regional-endpoints deze optie is ingeschakeld op registerniveau, hebben clients nog steeds rechtstreeks toegang tot die geo-replica via de regionale eindpunt-URL.
  • Stopt niet met het synchroniseren van gegevens naar die geo-replica.

Kortom:

  • Gebruik --regional-endpoints op registerniveau om toegewezen regionale URL's in te schakelen voor directe toegang tot specifieke geo-replica's.
  • Gebruik --global-endpoint-routing op een specifieke geo-replica om globale eindpuntroutering naar die geo-replica te beheren.
  • Gebruik --data-endpoint-enabled dit op registerniveau om toegewezen gegevenseindpunten in te schakelen voor het downloaden van blobs binnen het bereik.
  • Gebruik --endpoint-protocol dit op registerniveau om het eindpuntprotocol in IPv4 te stellen op of IPv4AndIPv6 (dubbele stack).

Verwante inhoud

  • Last updated on