Azure Container Registry Endpunktreferenz

Azure Container Registry stellt abhängig von der Konfiguration Ihrer Registrierung mehrere Endpunkttypen zur Verfügung. Dieser Artikel enthält eine Referenz für jeden Endpunkttyp, wie sie angezeigt werden, und die CLI-Flags, die sie steuern.

Informationen zur Georeplikation und zu regionalen Endpunkten finden Sie unter Geo-replikation in Azure Container Registry. Informationen zu dedizierten Datenendpunkten finden Sie unter Dedicated data endpoints in Azure Container Registry.

Endpunkttypen

Endpunkttyp URL-Format Purpose Anwendungsfall
Globaler Endpunkt myregistry.azurecr.io Anmeldeserver mit Azure verwaltetem Routing an ein beliebiges Georeplikat Standard; optimal für die meisten Szenarien
Regionaler Endpunkt myregistry.<region-name>.geo.azurecr.io Anmeldeserver für ein bestimmtes Georeplikat Vorhersehbares Routing, clientseitiges Failover, regionale Affinität, Problembehandlung
Dedizierter Datenendpunkt myregistry.<region-name>.data.azurecr.io Layer-BLOB-Downloads für Registrierungen mit dedizierten Datenendpunkten oder privaten Endpunkten Bereichsbezogene Firewallregeln; Automatische 307-Umleitung vom Anmeldeserver während des Pulls
Speicherkonto *.blob.core.windows.net Layer-BLOB-Downloads für Registrierungen ohne dedizierte Datenendpunkte oder private Endpunkte Automatische Umleitung vom Anmeldeserver

Alle Endpunkte anzeigen

Verwenden Sie den az acr show-endpoints Befehl, um alle Endpunkte für Ihre Registrierung anzuzeigen, einschließlich der globalen URL, der regionalen Endpunkte (sofern aktiviert) und dedizierten Datenendpunkten (sofern aktiviert):

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

Beispielausgabe für eine Registrierung mit regionalen Endpunkten und aktivierten dedizierten Datenendpunkten:

{
    "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-Flags für Registrierungsendpunkte

Important

Mehrere CLI-Flags steuern unterschiedliche Endpunktverhalten. Das Verständnis der Unterscheidung ist wichtig, um Fehlkonfigurationen zu vermeiden.

Flag Geltungsbereich Purpose
--regional-endpoints Registrierungsebene (ein az acr create oder az acr update) Aktiviert dedizierte regionale Endpunkt-URLs (myregistry.<region>.geo.azurecr.io) für alle Georeplikate.
--global-endpoint-routing Pro-Geo-Replikat (ein az acr replication create oder az acr replication update) Steuert, ob der globale Endpunkt (myregistry.azurecr.io) Datenverkehr an ein bestimmtes Georeplikat weiter leitet. Legen Sie fest, false dass ein Georeplikat vorübergehend vom globalen Endpunktrouting ausgeschlossen werden soll (für Wartung oder Problembehandlung). Daten werden unabhängig von dieser Einstellung weiterhin synchronisiert. Siehe vorübergehendes Ausschließen eines Georeplikats vom globalen Endpunktrouting.
--data-endpoint-enabled Registrierungsebene (ein az acr create oder az acr update) Aktiviert dedizierte Datenendpunkte (myregistry.<region>.data.azurecr.io) für Layer-BLOB-Downloads. Autoaktiviert, wenn mindestens ein privater Endpunkt konfiguriert ist. Siehe dedizierte Datenendpunkte.
--endpoint-protocol Registrierungsebene (on az acr update) Legt das Endpunktprotokoll der Registrierung auf IPv4 (Standard) oder IPv4AndIPv6 (dualer Stapel) fest. Für die Einstellung IPv4AndIPv6 müssen dedizierte Datenendpunkte aktiviert werden (--data-endpoint-enabled true). Erfordert Azure CLI 2.87.0 oder höher. Siehe IPv6 Dual-Stack-Endpunkte.

Beziehung zwischen --regional-endpoints und --global-endpoint-routing

--regional-endpoints und --global-endpoint-routing sind unabhängig. Einstellung --global-endpoint-routing false für ein Georeplikat:

  • Schließt dieses Georeplikat nur vom globalen Endpunktrouting aus.
  • Deaktiviert dieregionale Endpunkt-URL des Georeplikats nicht. Wenn --regional-endpoints diese Option auf Registrierungsebene aktiviert ist, können Clients über die url des regionalen Endpunkts weiterhin direkt auf dieses Georeplikat zugreifen.
  • Die Synchronisierung von Daten mit diesem Georeplikat wird nicht beendet.

Kurz gesagt:

  • Wird --regional-endpoints auf Registrierungsebene verwendet, um dedizierte regionale URLs für den direkten Zugriff auf bestimmte Georeplikate zu aktivieren.
  • Wird --global-endpoint-routing für ein bestimmtes Georeplikat verwendet, um das globale Endpunktrouting an dieses Georeplikat zu steuern.
  • Verwenden Sie --data-endpoint-enabled diese Option auf Registrierungsebene, um dedizierte Datenendpunkte für blob-Downloads mit Bereichsebene zu aktivieren.
  • Wird --endpoint-protocol auf Registrierungsebene verwendet, um das Endpunktprotokoll auf IPv4 oder IPv4AndIPv6 (dualer Stapel) festzulegen.

Verwandte Inhalte

  • Last updated on