使用 Azure 资源管理器开发 Azure Stack Hub 的模板

项目
10/30/2024

开发应用时，请务必确保模板可在 Azure 和 Azure Stack Hub 之间移植。本文提供了有关开发 Azure 资源管理器模板的注意事项。使用这些模板，可以在 Azure 中创建应用原型并测试部署，而无需访问 Azure Stack Hub 环境。

资源提供程序可用性

计划部署的模板只能使用 Azure Stack Hub 中已经可用或处于预览状态的 Microsoft Azure 服务。

公共命名空间

由于 Azure Stack Hub 托管在数据中心中，它的服务终结点命名空间与 Azure 公有云不同。因此，如果尝试将 Azure 资源管理器模板部署到 Azure Stack Hub，这些模板中的硬编码公共终结点会失败。可以使用 reference 和 concatenate 函数动态构建服务终结点，以便在部署期间从资源提供程序检索值。例如，不需要在模板中硬编码 blob.core.windows.net，检索 primaryEndpoints.blob 即可动态设置 osDisk.URI 终结点：

"osDisk": {"name": "osdisk","vhd": {"uri":
"[concat(reference(concat('Microsoft.Storage/storageAccounts/', variables('storageAccountName')), '2015-06-15').primaryEndpoints.blob, variables('vmStorageAccountContainerName'),
 '/',variables('OSDiskName'),'.vhd')]"}}

API 版本控制

Azure 服务版本在 Azure 和 Azure Stack Hub 之间可能有所不同。每个资源都需要有 apiVersion 属性，用于定义所提供的功能。为了确保 API 版本在 Azure Stack Hub 中兼容，以下 API 版本对于每个资源提供程序有效：

资源提供程序	apiVersion
计算	2015-06-15
网络	2015-06-15、2015-05-01-preview
存储	2016-01-01、2015-06-15、2015-05-01-preview
KeyVault	2015-06-01
应用服务	2015-08-01

模板函数

Azure 资源管理器函数提供生成动态模板所需的功能。例如，可以对如下任务使用函数：

连接或修整字符串。
引用其他资源的值。
对资源进行迭代以部署多个实例。

以下函数在 Azure Stack Hub 中不可用：

跳过
Take

资源位置

在部署过程中，Azure 资源管理器模板使用 location 属性来放置资源。在 Azure 中，位置是指美国西部或南美洲等区域。在 Azure Stack Hub 中，位置有所不同，因为 Azure Stack Hub 在数据中心内。若要确保模板可在 Azure 和 Azure Stack Hub 之间转移，在部署单个资源时应引用资源组位置。可以使用 [resourceGroup().Location] 执行此操作，以确保所有资源均继承资源组位置。以下代码是在部署存储帐户时使用此函数的示例：

"resources": [
{
  "name": "[variables('storageAccountName')]",
  "type": "Microsoft.Storage/storageAccounts",
  "apiVersion": "[variables('apiVersionStorage')]",
  "location": "[resourceGroup().location]",
  "comments": "This storage account is used to store the VM disks",
  "properties": {
  "accountType": "Standard_LRS"
  }
}
]

通过