本文详细介绍了如何使用Azure 门户中的 Azure 资源管理器 模板在环境中部署 Azure 本地。 本文还包含开始部署所需的先决条件和准备步骤。
重要
Azure 本地系统的 Azure 资源管理器模板部署旨在实现大规模部署。 此部署的目标受众是具有部署 Azure 本地实例经验的 IT 管理员。 建议先通过 Azure 门户部署系统，然后通过资源管理器模板执行后续部署。
先决条件
- 完成向 Azure Arc 注册计算机并分配部署权限。 确保：
- 所有计算机都运行相同的操作系统版本。
- 所有计算机都具有相同的网络适配器配置。
- 对于 Azure 本地 2411.3 和更低版本，请确保选择 create-cluster-2411.3 模板进行部署。
- 对于 Azure 本地 2503 及更高版本，请确保选择用于部署的 创建群集 模板。
步骤 1：准备 Azure 资源
按照以下步骤准备部署所需的 Azure 资源：
创建服务主体和客户端机密
若要对系统进行身份验证，需要为 Arc 资源桥（ARB）创建服务主体和相应的 客户端机密 。
为 ARB 创建服务主体
按照创建Microsoft Entra 应用程序和服务主体中的步骤操作，该主体可以通过Azure 门户访问资源，以创建服务主体并分配角色。 或者，使用 PowerShell 过程通过 Azure PowerShell 创建 Azure 服务主体。
此处还汇总了这些步骤：
以至少云应用程序管理员身份登录到 Microsoft Entra 管理中心 。 浏览到身份>应用程序>应用注册然后选择“新注册”。
为应用程序提供名称，选择受支持的帐户类型，然后选择“注册”。
创建服务主体后，转到 “企业应用程序 ”页。 搜索并选择你创建的 SPN。
在属性下，复制 此服务主体的应用程序（客户端）ID 和 对象 ID 。
在资源管理器模板中，将应用程序（客户端）ID 用于参数，将对象 ID 用于
arbDeploymentAppID参数。
为 ARB 服务主体创建客户端秘密
转到你创建的应用程序注册并浏览到 证书和机密 > 客户端机密。
选择 + 新客户端密码。
为客户端机密添加说明，并在其过期时提供时间范围。 选择 并添加。
复制客户端机密值，以供稍后使用。
注释
对于应用程序客户端 ID，您将需要它的机密值。 除创建后立即查看外，无法查看客户秘密的值。 在创建后离开页面之前，请务必保存此值。
可以使用客户端秘密值，与资源管理器模板中的
arbDeploymentAppSecret参数相对照。
获取 Azure 本地资源提供程序的对象 ID
Azure 本地资源提供（RP）的此对象 ID 对于每个 Azure 租户是唯一的。
在 Azure 门户中，搜索并选择“Microsoft Entra ID”。
转到 “概述 ”选项卡，搜索 Microsoft.AzureStackHCI 资源提供程序。
选择列出的服务主体名称并复制 对象 ID。
或者，可以使用 PowerShell 获取 Azure 本地 RP 服务主体的对象 ID。 在 PowerShell 中运行以下命令：
Get-AzADServicePrincipal -DisplayName "Microsoft.AzureStackHCI Resource Provider"可以使用 Object ID 与资源管理器模板中的
hciResourceProviderObjectID参数相对照。
步骤 2：使用 Azure 资源管理器 模板进行部署
资源管理器模板创建并分配部署所需的所有资源权限。
完成所有先决条件和准备步骤后，即可使用已知良好且经过测试资源管理器部署模板和相应的参数 JSON 文件进行部署。 使用 JSON 文件中包含的参数填写所有值，包括之前生成的值。
重要
在此版本中，请确保填写 JSON 值中包含的所有参数，包括具有 null 值的参数。 如果存在 null 值，则需要填充这些参数或验证失败。
在Azure 门户中，转到“主页”并选择“+ 创建资源”。
在“模板部署”下选择“创建”（使用自定义模板进行部署）。
在页面底部附近，找到从快速启动模板或模板规格入手部分。 选择 “快速入门模板 ”选项。
从 快速入门模板（免责声明） 下拉列表中，选择 create-cluster-2411.3 模板。
完成后，选择 “选择模板 ”按钮。
在 “基本信息 ”选项卡上，可以看到“ 自定义部署 ”页。 可以通过下拉列表选择各种参数，或选择“ 编辑参数”。
注释
有关显示各种输入格式的示例参数文件，例如
ArcNodeResourceId，请参阅 azuredeploy.parameters.json。
使用快速入门模板（免责声明）字段筛选相应的模板。 为筛选器键入 azurestackhci/create-cluster。
完成后，选择 “选择模板 ”按钮。
在 “基本信息 ”选项卡上，可以看到“ 自定义部署 ”页。 可以通过下拉列表选择各种参数，或选择“ 编辑参数”。
注释
有关显示各种输入格式的示例参数文件，例如
ArcNodeResourceId，请参阅 azuredeploy.parameters.json。
编辑网络意向或存储网络意向等参数。 填写参数后， 保存 参数文件。
为环境选择适当的资源组。
滚动到底部，确认 部署模式 = 验证。
选择查看 + 创建。
在“查看 + 创建”选项卡中，选择“创建”。 这会创建剩余的先决条件资源并验证部署。 验证需要大约 10 分钟才能完成。
验证完成后，选择“ 重新部署”。
在 “自定义部署 ”屏幕上，选择“ 编辑参数”。 加载以前保存的参数，然后选择“ 保存”。
在工作区底部，将 JSON 中的最终值从“验证”更改为“部署”，其中部署模式 = 部署。
验证参数 JSON 是否填充了资源管理器部署模板的所有字段。
为环境选择适当的资源组。
滚动到底部，确认 部署模式 = 部署。
选择查看 + 创建。
选择“创建”。 部署开始，使用在验证步骤中创建的现有先决条件资源。
部署屏幕在部署期间会在群集资源上循环显示。
部署启动后，将先进行有限的环境检查，然后进行完整的环境检查，最后开始云部署。 几分钟后，可以在门户中监视部署。
在新的浏览器窗口中，导航到环境的资源组。 选择群集资源。
选择“部署”。
刷新并观察第一台计算机的部署进度（也称为种子计算机，也是部署群集的第一台计算机）。 部署需要 2.5 到 3 小时。 几个步骤需要 40-50 分钟或更多时间。
部署中花费时间最长的步骤是 部署 Moc 和 ARB Stack。 此步骤需要 40-45 分钟。
完成后，顶部的任务会更新状态和结束时间。
还可以查看此社区源模板，以 使用 Bicep 部署 Azure 本地实例。
排查部署问题
如果部署失败，则应在部署页上看到一条错误消息。
在部署详细信息上，选择错误详细信息。
从 错误 面板中复制错误消息。 你可以提供此错误消息来Microsoft支持以获取进一步的帮助。
ARM 模板部署的已知问题
本部分包含 ARM 模板部署的已知问题和解决方法。
角色分配已存在
问题：在此版本中，你可能会看到 角色分配已存在 错误。 如果首先尝试从门户进行 Azure 本地实例部署，并且同一资源组用于 ARM 模板部署，则会发生此错误。 在适用资源的“概述>部署详细信息”页上看到此错误。 此错误表示同一资源组范围的另一个标识已完成等效的角色分配，ARM 模板部署无法执行角色分配。
解决方法：“部署详细信息”页上失败的资源指定了角色分配名称。 如果资源名称为 AzureStackHCIDeviceManagementRole-RoleAssignment，则 Azure Stack HCI 设备管理角色的分配失败。 请注意此角色名称，并转到 资源组 > 访问控制（IAM） > 角色分配。 搜索相应的名称，并删除该处的现有角色分配。 重新部署模板。
不允许更新租户 ID、应用程序 ID、主体 ID 和范围
问题：角色分配失败， 租户 ID、应用程序 ID、主体 ID 和作用域不允许更新。 在适用资源的“概述>部署详细信息”页上看到此错误。 当同一资源组中存在僵尸角色分配时，可能会显示此错误。 例如，执行之前部署时，删除了与该部署对应的资源，但角色分配资源会保留。
解决方法：若要标识僵尸角色分配，请转到 访问控制（IAM） > 角色分配 > 类型：未知 选项卡。这些分配被列为 找不到标识。找不到标识。 删除此类角色分配，然后重试 ARM 模板部署。
许可证同步问题
问题：在此版本中，使用 ARM 模板部署时可能会遇到许可证同步问题。
解决方法：系统完成验证阶段后，如果系统处于部署失败状态，建议不要在“验证”模式下启动另一个 ARM 模板部署。 启动另一个部署会重置系统属性，这可能会导致许可证同步问题。