Azure Container Registry slutpunktsreferens

Azure Container Registry exponerar flera slutpunktstyper beroende på registrets konfiguration. Den här artikeln innehåller en referens för varje slutpunktstyp, hur du visar dem och CLI-flaggorna som styr dem.

Information om geo-replikering och regionala slutpunkter finns i Geo-replikering i Azure Container Registry. Information om dedikerade dataslutpunkter finns i Dedicerade dataslutpunkter i Azure Container Registry.

Slutpunktstyper

Typ av slutpunkt URL-format Purpose Användningsfall
Global slutpunkt myregistry.azurecr.io Inloggningsserver med Azure hanterad routning till valfri geo-replik Standard; optimal för de flesta scenarier
Regional slutpunkt myregistry.<region-name>.geo.azurecr.io Inloggningsserver för en specifik geo-replik Förutsägbar routning, redundans på klientsidan, regional tillhörighet, felsökning
Dedikerad dataslutpunkt myregistry.<region-name>.data.azurecr.io Lagringsblobnedladdningar för register med dedikerade dataslutpunkter eller privata slutpunkter Begränsade brandväggsregler; automatisk 307-omdirigering från inloggningsservern under hämtningar
Lagringskonto *.blob.core.windows.net Lagringsblobnedladdningar för register utan dedikerade dataslutpunkter eller privata slutpunkter Automatisk omdirigering från inloggningsservern

Visa alla slutpunkter

az acr show-endpoints Använd kommandot för att visa alla slutpunkter för registret, inklusive den globala URL:en, regionala slutpunkter (om aktiverade) och dedikerade dataslutpunkter (om det är aktiverat):

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

Exempel på utdata för ett register med regionala slutpunkter och dedikerade dataslutpunkter aktiverade:

{
    "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-flaggor för registerslutpunkter

Important

Flera CLI-flaggor styr olika slutpunktsbeteenden. Det är viktigt att förstå skillnaden för att undvika felkonfiguration.

Flag Scope Purpose
--regional-endpoints Registernivå (på az acr create eller az acr update) Aktiverar dedikerade regionala slutpunkts-URL:er (myregistry.<region>.geo.azurecr.io) för alla geo-repliker.
--global-endpoint-routing Per geo-replik (på az acr replication create eller az acr replication update) Styr om den globala slutpunkten (myregistry.azurecr.io) dirigerar trafik till en specifik geo-replik. Ange till för att false tillfälligt exkludera en geo-replik från global slutpunktsroutning (för underhåll eller felsökning). Data fortsätter att synkroniseras oavsett den här inställningen. Se Tillfälligt exkludera en geo-replik från global slutpunktsroutning.
--data-endpoint-enabled Registernivå (på az acr create eller az acr update) Aktiverar dedikerade dataslutpunkter (myregistry.<region>.data.azurecr.io) för lagringsblobnedladdningar. Aktiveras automatiskt när minst en privat slutpunkt har konfigurerats. Se Dedikerade dataslutpunkter.
--endpoint-protocol Registernivå (på az acr update) Anger slutpunktsprotokollet för registret till IPv4 (standard) eller IPv4AndIPv6 (dubbel stack). Inställningen IPv4AndIPv6 kräver att dedikerade dataslutpunkter aktiveras (--data-endpoint-enabled true). Kräver Azure CLI 2.87.0 eller senare. Se IPv6-slutpunkter med dubbla staplar.

Relation mellan --regional-endpoints och --global-endpoint-routing

--regional-endpoints och --global-endpoint-routing är oberoende. Inställning --global-endpoint-routing false på en geo-replik:

  • Utesluter endast geo-replik från global slutpunktsroutning .
  • Inaktiverar inte geo-replikens regionala slutpunkts-URL . Om --regional-endpoints är aktiverat på registernivå kan klienter fortfarande komma åt den geo-repliken direkt via den regionala slutpunkts-URL:en.
  • Stoppar inte datasynkronisering till den geo-repliken.

Kort och kort:

  • Använd --regional-endpoints på registernivå för att aktivera dedikerade regionala URL:er för direkt åtkomst till specifika geo-repliker.
  • Använd --global-endpoint-routing på en specifik geo-replik för att styra global slutpunktsroutning till den geo-repliken.
  • Använd --data-endpoint-enabled på registernivå för att aktivera dedikerade dataslutpunkter för begränsade skiktblobnedladdningar.
  • Använd --endpoint-protocol på registernivå för att ange slutpunktsprotokollet till IPv4 eller IPv4AndIPv6 (dubbel stack).

Relaterat innehåll

  • Last updated on