快速入門：使用ARM範本建立異地複寫的容器登錄

發行項
03/14/2024

本快速入門說明如何使用 Azure Resource Manager 範本（ARM 範本）建立 Azure Container Registry 實例。範本會設定異地復寫的登錄，以自動跨多個 Azure 區域同步處理登錄內容。異地復寫可讓您從區域部署存取映像的網路存取，同時提供單一管理體驗。這是進階版登錄服務層級的功能。

Azure Resource Manager 範本是 JavaScript 物件表示法（JSON）檔案，可定義專案的基礎結構和組態。範本使用宣告式語法。您不需要撰寫程式設計命令順序來建立部署，即可描述預定的部署。

具有複寫的登錄不支援ARM/Bicep 範本完成模式部署。

如果您的環境符合必要條件，而且您很熟悉 ARM 範本，請選取 [部署至 Azure] 按鈕。範本會在 Azure 入口網站中開啟。

必要條件

如果您沒有 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 Container Registry
Microsoft.ContainerRegistry/registries/replications：建立容器登錄複本

如需更多 Azure Container Registry 範例，請參閱快速入門範本資源庫。

部署範本

選取以下影像來登入 Azure 並開啟範本。
選取或輸入下列值。
- 訂用帳戶：選取 Azure 訂用帳戶。
- 資源群組：選取 [ 新建]，輸入資源群組的唯一名稱，然後選取 [ 確定]。
- 區域：選取資源群組的位置。範例：美國中部。
- Acr 名稱：接受登錄產生的名稱，或輸入名稱。它必須是全域唯一的。
- Acr 管理員用戶啟用：接受預設值。
- 位置：接受登錄主複本所產生的位置，或輸入美國中部等位置。
- Acr Sku：接受預設值。
- Acr 複本位置：使用區域的簡短名稱輸入登錄複本的位置。它必須與主登錄位置不同。範例： westeurope。
選取 [ 檢閱 + 建立]，然後檢閱條款和條件。如果您同意，請選取 [ 建立]。
成功建立登錄之後，您會收到通知：

Azure 入口網站用於部署範本。除了 Azure 入口網站之外，您還可以使用 Azure PowerShell、Azure CLI 和 REST API。若要了解其他部署方法，請參閱＜部署範本＞。

檢閱已部署的資源

使用 Azure 入口網站或 Azure CLI 之類的工具來檢閱容器登錄的屬性。

在入口網站中，搜尋容器登錄，然後選取您所建立的容器登錄。
在 [概觀] 頁面上，記下 登錄的登入伺服器 。當您使用 Docker 標記映射並將映像推送至登錄時，請使用此 URI。如需詳細資訊，請參閱使用 Docker CLI 推送您的第一個映像。
在 [ 複寫] 頁面上，確認透過範本新增的主複本和複本的位置。如有需要，請在此頁面新增更多複本。