Azure Container Registry エンドポイント リファレンス

Azure Container Registryでは、レジストリの構成に応じて、いくつかのエンドポイントの種類が公開されます。 この記事では、エンドポイントの種類ごとのリファレンス、エンドポイントの表示方法、およびエンドポイントを制御する CLI フラグについて説明します。

geo レプリケーションとリージョン エンドポイントの詳細については、「Azure Container Registry での Geo-replication」を参照してください。 専用データ エンドポイントの詳細については、「Azure Container Registry の Dedicated データ エンドポイント」を参照してください。

エンドポイントの種類

エンドポイントの種類 URL 形式 Purpose 利用シーン
グローバル エンドポイント myregistry.azurecr.io 任意の geo レプリカへのAzureマネージド ルーティングを使用するログイン サーバー 既定;ほとんどのシナリオに最適
リージョン エンドポイント myregistry.<region-name>.geo.azurecr.io 特定の geo レプリカのログイン サーバー 予測可能なルーティング、クライアント側フェールオーバー、リージョン アフィニティ、トラブルシューティング
専用データ エンドポイント 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 create または az acr update) myregistry.<region>.geo.azurecr.io geo レプリカに対して専用のリージョン エンドポイント URL () を有効にします。
--global-endpoint-routing geo レプリカごと ( az acr replication create または az acr replication update) グローバル エンドポイント (myregistry.azurecr.io) がトラフィックを特定の geo レプリカにルーティングするかどうかを制御します。 グローバル エンドポイント ルーティングから geo レプリカを一時的に除外するように false に設定します (メンテナンスまたはトラブルシューティング用)。 この設定に関係なく、データの同期は続行されます。 グローバル エンドポイント ルーティングから geo レプリカを一時的に除外するを参照してください。
--data-endpoint-enabled レジストリ レベル ( az acr create または az acr update) レイヤー BLOB のダウンロード用に専用データ エンドポイント (myregistry.<region>.data.azurecr.io) を有効にします。 少なくとも 1 つのプライベート エンドポイントが構成されている場合に自動有効になります。 専用データ エンドポイントを参照してください。
--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 は独立しています。 geo レプリカでの --global-endpoint-routing false の設定:

  • グローバル エンドポイント ルーティングからのみ、その geo レプリカを除外します。
  • geo レプリカのリージョン エンドポイント URL を無効にしません。 --regional-endpointsがレジストリ レベルで有効になっている場合でも、クライアントはリージョン エンドポイント URL を介してその geo レプリカに直接アクセスできます。
  • その geo レプリカへのデータ同期を停止 しません 。

要は：

  • レジストリ レベルで --regional-endpoints を使用して、特定の geo レプリカに直接アクセスするための 専用のリージョン URL を有効にします 。
  • 特定の geo レプリカで --global-endpoint-routing を使用して、その geo レプリカへの グローバル エンドポイント ルーティングを制御 します。
  • レジストリ レベルで --data-endpoint-enabled を使用して、スコープ付きレイヤー BLOB のダウンロード 専用データ エンドポイントを有効にします 。
  • レジストリ レベルで --endpoint-protocol を使用して、 エンドポイント プロトコルをIPv4 または IPv4AndIPv6 (デュアル スタック) に設定します。

関連するコンテンツ

  • Last updated on