Справочник по конечной точке Реестр контейнеров Azure

Реестр контейнеров Azure предоставляет несколько типов конечных точек в зависимости от конфигурации реестра. В этой статье приведена ссылка для каждого типа конечной точки, их просмотр и флаги ИНТЕРФЕЙСА командной строки, которые управляют ими.

Сведения о георепликации и региональных конечных точках см. в разделе Geo-replication in Реестр контейнеров Azure. Сведения о выделенных конечных точках данных см. в разделе Dedicated data endpoints in Реестр контейнеров Azure.

Типы конечных точек

Тип конечной точки Формат URL-адреса Purpose Сценарий использования
Глобальная конечная точка myregistry.azurecr.io Сервер входа с Azure управляемой маршрутизацией на любую геореплику По умолчанию; оптимальный для большинства сценариев
Региональная конечная точка myregistry.<region-name>.geo.azurecr.io Сервер входа для конкретной геореплики Прогнозируемая маршрутизация, отработка отказа на стороне клиента, региональное сходство, устранение неполадок
Выделенная конечная точка данных myregistry.<region-name>.data.azurecr.io Скачивание BLOB-объектов уровня для реестров с выделенными конечными точками данных или частными конечными точками Правила брандмауэра с областью действия; автоматическое перенаправление 307 с сервера входа во время извлечения
учетная запись хранения *.blob.core.windows.net Скачивание BLOB-объектов уровня для реестров без выделенных конечных точек данных или частных конечных точек Автоматическое перенаправление с сервера входа

Просмотр всех конечных точек

az acr show-endpoints Используйте команду для просмотра всех конечных точек для реестра, включая глобальный URL-адрес, региональные конечные точки (при включении), а также выделенные конечные точки данных (если это включено):

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

Пример выходных данных для реестра с включенными региональными конечными точками и выделенными конечными точками данных:

{
    "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 для конечных точек реестра

Important

Несколько флагов CLI управляют различными поведением конечных точек. Понимание различия важно, чтобы избежать неправильной настройки.

Flag Scope Purpose
--regional-endpoints Уровень реестра (или az acr createaz acr update) Включает URL-адреса выделенных региональных конечных точек (myregistry.<region>.geo.azurecr.io) для всех геореплик.
--global-endpoint-routing Для каждой геореплики (включено az acr replication create или az acr replication update) Определяет, направляет ли глобальная конечная точкаmyregistry.azurecr.io () трафик в определенную геореплику. Установите для false временного исключения геореплики из глобальной маршрутизации конечных точек (для обслуживания или устранения неполадок). Данные продолжают синхронизироваться независимо от этого параметра. См. временное исключение геореплики из глобальной маршрутизации конечных точек.
--data-endpoint-enabled Уровень реестра (или az acr createaz acr update) Включает выделенные конечные точки данных (myregistry.<region>.data.azurecr.io) для загрузки BLOB-объектов уровня. Автоматическое включение при настройке по крайней мере одной частной конечной точки. См. раздел "Выделенные конечные точки данных".
--endpoint-protocol Уровень реестра (в az acr update) Задает протокол конечной точки реестра IPv4 (по умолчанию) или IPv4AndIPv6 (двойной стек). Для параметра IPv4AndIPv6 требуется включить выделенные конечные точки данных (--data-endpoint-enabled true). Требуется Azure CLI 2.87.0 или более поздней версии. Ознакомьтесь с конечными точками с двойным стеком IPv6.

Связь между --regional-endpoints и --global-endpoint-routing

--regional-endpoints и --global-endpoint-routing являются независимыми. Настройка --global-endpoint-routing false геореплики:

  • Исключает только геореплику из глобальной маршрутизации конечных точек .
  • Не отключает URL-адрес региональной конечной точки геореплики. Если --regional-endpoints этот параметр включен на уровне реестра, клиенты по-прежнему могут напрямую получить доступ к этой геореплике через URL-адрес региональной конечной точки.
  • Не останавливает синхронизацию данных с этой георепликой.

Короче говоря:

  • Используйте --regional-endpoints на уровне реестра, чтобы включить выделенные региональные URL-адреса для прямого доступа к определенным георепликам.
  • Используйте --global-endpoint-routing для конкретной геореплики для управления глобальной маршрутизацией конечных точек в этой геореплике.
  • Используйте --data-endpoint-enabled на уровне реестра, чтобы включить выделенные конечные точки данных для загрузки больших двоичных объектов с областью действия.
  • Используйте --endpoint-protocol на уровне реестра, чтобы задать протокол IPv4конечной точки или IPv4AndIPv6 (двойной стек).

Связанный контент

  • Last updated on