クイックスタート:ARM テンプレートを使用して geo レプリケーションコンテナーレジストリを作成する

[アーティクル]
10/31/2023

このクイックスタートでは、Azure Resource Manager テンプレート (ARM テンプレート) を使用して、Azure Container Registry インスタンスを作成する方法を示します。このテンプレートは、geo レプリケーションレジストリを設定します。このレジストリでは、レジストリの内容が複数の Azure リージョン間で自動的に同期されます。 geo レプリケーションを使用すると、単一の管理エクスペリエンスを提供しつつ、リージョンデプロイからイメージへのネットワーク的に近接するアクセスができます。これは、Premium レジストリサービスレベルの機能です。

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。このテンプレートでは、宣言型の構文が使用されています。デプロイしようとしているものを、デプロイを作成する一連のプログラミングコマンドを記述しなくても記述できます。

レプリケーションを含むレジストリは、ARM/Bicep テンプレートの完全モードデプロイをサポートしていません。

環境が前提条件を満たしていて、ARM テンプレートの使用に慣れている場合は、 [Azure へのデプロイ] ボタンを選択します。 Azure portal でテンプレートが開きます。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

テンプレートを確認する

このクイックスタートで使用されるテンプレートは Azure クイックスタートテンプレートからのものです。テンプレートは、レジストリと追加のリージョンレプリカを設定します。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "12610175857982700190"
    }
  },
  "parameters": {
    "acrName": {
      "type": "string",
      "defaultValue": "[format('acr{0}', uniqueString(resourceGroup().id))]",
      "maxLength": 50,
      "minLength": 5,
      "metadata": {
        "description": "Globally unique name of your Azure Container Registry"
      }
    },
    "acrAdminUserEnabled": {
      "type": "bool",
      "defaultValue": false,
      "metadata": {
        "description": "Enable admin user that has push / pull permission to the registry."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for registry home replica."
      }
    },
    "acrSku": {
      "type": "string",
      "defaultValue": "Premium",
      "allowedValues": [
        "Premium"
      ],
      "metadata": {
        "description": "Tier of your Azure Container Registry. Geo-replication requires Premium SKU."
      }
    },
    "acrReplicaLocation": {
      "type": "string",
      "metadata": {
        "description": "Short name for registry replica location."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerRegistry/registries",
      "apiVersion": "2019-12-01-preview",
      "name": "[parameters('acrName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('acrSku')]"
      },
      "tags": {
        "displayName": "Container Registry",
        "container.registry": "[parameters('acrName')]"
      },
      "properties": {
        "adminUserEnabled": "[parameters('acrAdminUserEnabled')]"
      }
    },
    {
      "type": "Microsoft.ContainerRegistry/registries/replications",
      "apiVersion": "2019-12-01-preview",
      "name": "[format('{0}/{1}', parameters('acrName'), parameters('acrReplicaLocation'))]",
      "location": "[parameters('acrReplicaLocation')]",
      "properties": {},
      "dependsOn": [
        "[resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))]"
      ]
    }
  ],
  "outputs": {
    "acrLoginServer": {
      "type": "string",
      "value": "[reference(resourceId('Microsoft.ContainerRegistry/registries', parameters('acrName'))).loginServer]"
    }
  }
}

このテンプレートでは、次のリソースが定義されています。

Microsoft.ContainerRegistry/registries : Azure コンテナーレジストリを作成します
Microsoft.ContainerRegistry/registries/replications : コンテナーレジストリレプリカを作成します

その他の Azure Container Registry テンプレートのサンプルについては、クイックスタートテンプレートギャラリーを参照してください。

テンプレートのデプロイ

Azure にサインインし、テンプレートを開くには次のイメージを選択します。
次の値を選択または入力します。
- サブスクリプション: Azure サブスクリプションを選択します。
- リソースグループ: [新規作成] を選択し、リソースグループの一意の名前を入力し、 [OK] を選択します。
- [リージョン] : リソースグループの場所を選択します。例:米国中部。
- [Acr Name](Acr 名) : 生成されたレジストリ名を受け入れるか、名前を入力します。名前はグローバルに一意である必要があります。
- [Acr Admin User Enabled](ACR 管理者ユーザーの有効) : 既定値を受け入れます。
- [場所] : レジストリのホームレプリカ用に生成された場所を受け入れるか、米国中部などの場所を入力します。
- [Acr Sku](ACR の SKU) : 既定値を受け入れます。
- [Acr Replica Location](Acr レプリカの場所) : リージョンの短い名前を使用して、レジストリレプリカの場所を入力します。ホームレジストリの場所とは違う場所にする必要があります。例: westeurope。
[Review + Create](確認と作成) を選択し、使用条件を確認します。同意する場合は、 [作成] を選択します。
レジストリが正常に作成されると、次の通知が表示されます。

テンプレートをデプロイするには Azure portal を使用します。 Azure portal だけでなく、Azure PowerShell、Azure CLI、REST API を使用することもできます。他のデプロイ方法については、「テンプレートのデプロイ」を参照してください。

デプロイされているリソースを確認する

Azure portal またはツール (Azure CLI など) を使用して、コンテナーレジストリのプロパティを確認します。

ポータルで Container Registries を検索し、作成したコンテナーレジストリを選択します。
[概要] ページで、レジストリのログインサーバーを書き留めます。 Docker を使用してイメージにタグを付けてレジストリにプッシュするときに、この URI を使用します。情報については、Docker CLI を使用した最初のイメージのプッシュに関するページを参照してください。
[レプリケーション] ページで、ホームレプリカの場所と、テンプレートを通じて追加されたレプリカの場所を確認します。必要に応じて、このページでさらにレプリカを追加します。