Riferimento all'endpoint Registro Azure Container

Registro Azure Container espone diversi tipi di endpoint a seconda della configurazione del Registro di sistema. Questo articolo fornisce un riferimento per ogni tipo di endpoint, come visualizzarli e i flag dell'interfaccia della riga di comando che li controllano.

Per informazioni sulla replica geografica e sugli endpoint a livello di area, vedere Replicageo in Registro Azure Container. Per informazioni sugli endpoint dati dedicati, vedere endpoint dati Dedicated data endpoints in Registro Azure Container.

Tipi di endpoint

Tipo di endpoint Formato di URL Purpose Caso di utilizzo
Endpoint globale myregistry.azurecr.io Server di accesso con routing gestito da Azure a qualsiasi replica geografica Predefinito; ottimale per la maggior parte degli scenari
Endpoint a livello di area myregistry.<region-name>.geo.azurecr.io Server di accesso per una replica geografica specifica Routing stimabile, failover lato client, affinità a livello di area, risoluzione dei problemi
Endpoint dati dedicato myregistry.<region-name>.data.azurecr.io Download di BLOB di livello per i registri con endpoint dati dedicati o endpoint privati Regole del firewall con ambito; reindirizzamento automatico 307 dal server di accesso durante il pull
Account di archiviazione *.blob.core.windows.net Download di BLOB di livello per i registri senza endpoint dati dedicati o endpoint privati Reindirizzamento automatico dal server di accesso

Visualizzare tutti gli endpoint

Usare il az acr show-endpoints comando per visualizzare tutti gli endpoint per il Registro di sistema, inclusi l'URL globale, gli endpoint internazionali (se abilitati) e gli endpoint dati dedicati (se abilitati):

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

Output di esempio per un registro con endpoint a livello di area ed endpoint dati dedicati abilitati:

{
    "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"
        }
    ]
}

Flag dell'interfaccia della riga di comando per gli endpoint del Registro di sistema

Importante

Diversi flag dell'interfaccia della riga di comando controllano diversi comportamenti degli endpoint. Comprendere la distinzione è importante per evitare errori di configurazione.

Flag Ambito Purpose
--regional-endpoints Livello del Registro di sistema (in az acr create o az acr update) Abilita gli URL degli endpoint regionali dedicati (myregistry.<region>.geo.azurecr.io) per tutte le repliche geografiche.
--global-endpoint-routing Per replica geografica (in az acr replication create o az acr replication update) Controlla se l'endpoint globale (myregistry.azurecr.io) instrada il traffico a una replica geografica specifica. Impostare su per false escludere temporaneamente una replica geografica dal routing globale degli endpoint (per la manutenzione o la risoluzione dei problemi). I dati continuano a essere sincronizzati indipendentemente da questa impostazione. Vedere Escludere temporaneamente una replica geografica dal routing endpoint globale.
--data-endpoint-enabled Livello del Registro di sistema (in az acr create o az acr update) Abilita gli endpoint dati dedicati (myregistry.<region>.data.azurecr.io) per i download di BLOB di livello. Abilitata automaticamente quando è configurato almeno un endpoint privato. Vedere Endpoint dati dedicati.
--endpoint-protocol Livello del Registro di sistema (in az acr update) Imposta il protocollo endpoint del Registro di sistema su IPv4 (impostazione predefinita) o IPv4AndIPv6 (doppio stack). L'impostazione IPv4AndIPv6 richiede l'abilitazione degli endpoint dati dedicati (--data-endpoint-enabled true). Richiede interfaccia della riga di comando di Azure 2.87.0 o versione successiva. Vedere Endpoint dual stack IPv6.

Relazione tra --regional-endpoints e --global-endpoint-routing

--regional-endpoints e --global-endpoint-routing sono indipendenti. Impostazione --global-endpoint-routing false in una replica geografica:

  • Esclude tale replica geografica solo dal routing dell'endpoint globale .
  • Non disabilita l'URL dell'endpoint a livello di area della replica geografica. Se --regional-endpoints è abilitato a livello di Registro di sistema, i client possono comunque accedere direttamente a tale replica geografica tramite l'URL dell'endpoint a livello di area.
  • Non arresta la sincronizzazione dei dati con tale replica geografica.

In breve:

  • Usare --regional-endpoints a livello di Registro di sistema per abilitare URL regionali dedicati per l'accesso diretto a repliche geografiche specifiche.
  • Usare --global-endpoint-routing in una replica geografica specifica per controllare il routing globale degli endpoint a tale replica geografica.
  • Usare --data-endpoint-enabled a livello di Registro di sistema per abilitare gli endpoint dati dedicati per i download di BLOB di livello con ambito.
  • Usare --endpoint-protocol a livello di Registro di sistema per impostare il protocollo dell'endpoint su IPv4 o IPv4AndIPv6 (doppio stack).

Contenuti correlati

  • Last updated on