dokumentacja punktu końcowego Azure Container Registry

Azure Container Registry uwidacznia kilka typów punktów końcowych w zależności od konfiguracji rejestru. Ten artykuł zawiera informacje dotyczące każdego typu punktu końcowego, sposobu ich wyświetlania oraz flag interfejsu wiersza polecenia, które je kontrolują.

Aby uzyskać informacje na temat replikacji geograficznej i regionalnych punktów końcowych, zobacz Geo-replication in Azure Container Registry (Replikacja geograficzna i regionalna). Aby uzyskać informacje na temat dedykowanych punktów końcowych danych, zobacz Dedicated data endpoints in Azure Container Registry (Punkty końcowe danych Azure Container Registry

Typy punktów końcowych

Typ punktu końcowego Format adresu URL Purpose Przypadek użycia
Globalny punkt końcowy myregistry.azurecr.io Serwer logowania z routingiem zarządzanym Azure do dowolnej repliki geograficznej Domyślny; optymalne dla większości scenariuszy
Regionalny punkt końcowy myregistry.<region-name>.geo.azurecr.io Serwer logowania dla określonej repliki geograficznej Przewidywalny routing, tryb failover po stronie klienta, koligacja regionalna, rozwiązywanie problemów
Dedykowany punkt końcowy danych myregistry.<region-name>.data.azurecr.io Pobieranie obiektów blob warstwowych dla rejestrów z dedykowanymi punktami końcowymi danych lub prywatnymi punktami końcowymi Reguły zapory o określonym zakresie; automatyczne przekierowanie 307 z serwera logowania podczas ściągania
Konto magazynu *.blob.core.windows.net Pobieranie obiektów blob warstwowych dla rejestrów bez dedykowanych punktów końcowych danych lub prywatnych punktów końcowych Automatyczne przekierowywanie z serwera logowania

Wyświetlanie wszystkich punktów końcowych

az acr show-endpoints Użyj polecenia , aby wyświetlić wszystkie punkty końcowe dla rejestru, w tym globalny adres URL, regionalne punkty końcowe (jeśli jest włączone) i dedykowane punkty końcowe danych (jeśli są włączone):

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

Przykładowe dane wyjściowe rejestru z włączonymi regionalnymi punktami końcowymi i dedykowanymi punktami końcowymi danych:

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

Flagi interfejsu wiersza polecenia dla punktów końcowych rejestru

Ważna

Kilka flag interfejsu wiersza polecenia steruje różnymi zachowaniami punktów końcowych. Zrozumienie różnicy jest ważne, aby uniknąć błędnej konfiguracji.

Flaga Scope Purpose
--regional-endpoints Poziom rejestru (w systemie az acr create lub az acr update) Włącza dedykowane regionalne adresy URL punktów końcowych (myregistry.<region>.geo.azurecr.io) dla wszystkich replik geograficznych.
--global-endpoint-routing Na replikę geograficzną (w systemie az acr replication create lub az acr replication update) Określa, czy globalny punkt końcowy (myregistry.azurecr.io) kieruje ruch do określonej repliki geograficznej. Ustaw wartość na , aby false tymczasowo wykluczyć replikę geograficzną z globalnego routingu punktu końcowego (na potrzeby konserwacji lub rozwiązywania problemów). Dane są synchronizowane niezależnie od tego ustawienia. Zobacz Tymczasowe wykluczanie repliki geograficznej z globalnego routingu punktów końcowych.
--data-endpoint-enabled Poziom rejestru (w systemie az acr create lub az acr update) Włącza dedykowane punkty końcowe danych (myregistry.<region>.data.azurecr.io) dla pobierania obiektów blob warstwy. Automatyczne włączanie po skonfigurowaniu co najmniej jednego prywatnego punktu końcowego. Zobacz Dedykowane punkty końcowe danych.
--endpoint-protocol Poziom rejestru (w systemie az acr update) Ustawia protokół punktu końcowego rejestru na IPv4 (wartość domyślna) lub IPv4AndIPv6 (podwójny stos). Ustawienie IPv4AndIPv6 wymaga włączenia dedykowanych punktów końcowych danych (--data-endpoint-enabled true). Wymaga Azure CLI 2.87.0 lub nowszej. Zobacz Punkty końcowe dwóch stosów protokołu IPv6.

Relacja między --regional-endpoints a --global-endpoint-routing

--regional-endpoints i --global-endpoint-routing są niezależne. Ustawienie --global-endpoint-routing false na repliki geograficznej:

  • Wyklucza to replikę geograficzną tylko z globalnego routingu punktów końcowych .
  • Nie wyłącza regionalnego adresu URL punktu końcowego repliki geograficznej. Jeśli --regional-endpoints jest włączona na poziomie rejestru, klienci nadal mogą bezpośrednio uzyskać dostęp do tej repliki geograficznej za pośrednictwem regionalnego adresu URL punktu końcowego.
  • Nie zatrzymuje synchronizacji danych z tej repliki geograficznej.

Krótko mówiąc:

  • Użyj --regional-endpoints na poziomie rejestru, aby włączyć dedykowane regionalne adresy URL na potrzeby bezpośredniego dostępu do określonych replik geograficznych.
  • Użyj --global-endpoint-routing na określonej repliki geograficznej, aby kontrolować globalny routing punktów końcowych do tej repliki geograficznej.
  • Użyj --data-endpoint-enabled na poziomie rejestru, aby włączyć dedykowane punkty końcowe danych na potrzeby pobierania obiektów blob warstwy o określonym zakresie.
  • Użyj --endpoint-protocol na poziomie rejestru, aby ustawić protokół punktu końcowego na IPv4 lub IPv4AndIPv6 (podwójny stos).

Treści powiązane

  • Last updated on