
未经同意请勿转载TL;DRAzure Local 2606 在Multi-rack多机架、跨交换机域路径下创建 VM完整流程分为两大阶段阶段 1前置条件5 个 H2 章节——Azure / Firewall / Azure Local / VM image / Azure CLINetwork Fabric L3 isolation domain 官方要求Guest Management Proxy 官方要求阶段 2创建 VM3 种部署方式CLI / Portal / ARM--zone--strict-placement两个新增参数Security type 仅 Standard、Memory type 仅 Static、Arc Gateway 不支持本篇按先 prereqs、再 create的叙事主线展开。Hyperconverged 路径见第 1 篇。作者声明本文中所有 Prerequisites 项、命令、参数、限制条件均直接引用自 Microsoft Learn 官方原文Review prerequisites for Azure Local VMs for multi-rack deploymentsCreate Azure Local Virtual Machines Enabled by Azure Arc on Multi-rack Deployments作者解读小节是作者对官方文档中容易踩坑或术语严谨性的整理文中显式标注 [常见误区] 与 [作者解读] 区分官方原文。文档版本azloc-26062026 年 7 月视图。适用于azloc-2512 及以后的 Multi-rack 部署。〇、HC vs MR 路径选型速查5 秒决策业务需求HC 路径MR 路径本篇单集群 / 单机房✅ 典型场景✅ 可用但偏重多机架 / 跨机房❌ 不适用✅ 典型场景Trusted Launchsecure boot vTPM✅ 支持❌ 不支持Dynamic Memory✅ 支持❌ 不支持Availability Zone机架级容灾❌ 不适用✅--zoneStrict Placement❌ 不适用✅--strict-placementArc Gateway✅ 支持❌ 不支持Marketplace 镜像支持直接选择部署时使用 Storage Account 中的镜像镜像通常可由 Marketplace 导入Linux Guest Management Proxy✅ 验证仅 Ubuntu Server✅ 官方要求所有 LinuxGuest Management Proxy建议官方要求一句话选型HC 路径单集群、需要 Trusted Launch / Dynamic Memory / Arc Gateway / 直接 Marketplace 镜像MR 路径本篇多机架、需要机架级容灾、可接受 Standard Static 内存降级如果选 HC 路径请看 第 1 篇 · Hyperconverged 完整实战。第一部分前置条件Prerequisites一、为什么 Multi-rack 的 Prerequisites 是独立页维度Hyperconverged第 1 篇Multi-rack本篇Prerequisites 位置内嵌在综合页独立页章节数1 段含 5 种 tab5 个 H2 章节独有要求无Network Fabric L3 isolation domain L3 external/internal network Guest Management Proxy 官方要求VM image 详规仅列 3 种来源链接明确 Linux 自定义镜像要求cloud-init、Serial Console以及 Windows 镜像注意事项客户端 CLI1 项 prereq5 步流程安装 CLI 重启 az loginaz version 安装stack-hci-vmextension二、Azure requirements订阅要求官方原文To provision Azure Local VMs and VM resources such as network interfaces, VM images, and data disks, you must have access to an Azure subscription with the appropriate Role-based access control (RBAC) role and permissions assigned.Azure Local VM infrastructure is supported in the regions documented in the What is Azure Local for multi-rack deployments?. For Azure Local VMs,all entities must be registered, enabled, or created in the same region.The entities included with your Azure Local for multi-rack deployments includeNetwork Fabric Controller, Cluster Manager, Custom Location, VM resources (disks, NICs, images), and VMs created from Azure Arc. These entities can be in different or same resource groups as long as all resource groups are in the same region.作者解读项要求订阅 RBAC订阅级访问即可详见 multi-rack-assign-vm-rbac-rolesRegion 同一性官方要求相关 Azure 资源位于同一区域范围Network Fabric Controller / Cluster Manager / Custom Location / VM resources / Arc-enabled VMsResource Group跨 RG 可但所有 RG必须同 region作者解读 [常见误区]❌ 常见误区VM 在哪个 RG 都可以反正都是同一 region ✅ 真相相关 Azure 资源必须在同一 region硬要求但 RG可以不同三、Firewall requirements防火墙要求官方原文 Make sure the requirements as listed in Required firewall URLs for Azure Local deployments are satisfied to allow communication between the Arc VMs running on Azure Local and Azure Arc.作者解读官方出站 URL 列表见required-firewall-urls页面包含Arc Connected Machine Agent endpoints*.guestconfiguration.azure.com、*.his.arc.azure.com等 Azure Local 自身 control plane endpoints Azure Stack HCI 注册 endpoint防火墙要求是 VM 与 Azure Arc 通信的前提——Guest Management / VM Extension / Update Management 都依赖作者解读 [常见误区]❌ 常见误区Multi-rack 部署在内网不用配出站 URL ✅ 真相即使 MR 部署Azure Local VM 仍需要与 Azure Arc 控制平面通信——不放行 URL →Guest Management 不会启用四、Azure Local requirements集群要求官方原文4 条 checklistAccess to an Azure Local instance with the following configuration:Deployed with the network fabric.At least one Layer 3 isolation domain is configured.At least one Layer 3 external network and one Layer 3 internal network with sufficiently large IP CIDR.Custom location is configured.Note: Thefirst eight IPs of the address prefix associated with a Layer 3 internal network are reserved for internal use. Plan the size of the IP CIDR based on how many IPs your workloads require.Go to the Overview page in the Azure Local resource. Verify thatDetailed Status shows as Running. You should also see a custom/extended location in the cluster overview page.Details of your proxy server to provide during VM creation.Azure Local VMs dont have external connectivity to enable guest management without proxy details configured at the time of creation.4.1 Network Fabric L3 isolation domainMR 专属Network Fabric是 Multi-rack 部署的网络底座——HC 不需要L3 isolation domainLayer 3 isolation domain是 Network Fabric 内的逻辑隔离单元L3 external network与L3 internal network是 VM 流量出口的两类网络L3 internal network 前 8 个 IP 被保留——规划 IP CIDR 时必须预留不代表必须规划 /24按实际 IP 需求规划即可4.2 Custom Location Detailed Status RunningOverview 页能看到 custom/extended location 是必备验证项Running 是官方要求的部署前提4.3 Guest Management ProxyMulti-rack 官方要求官方原文关键Azure Local VMsdonthave external connectivity to enable guest management without proxy details configured at the time of creation.MR 路径 Guest Management Proxy 是硬性要求——不是建议与 HC 的差异HC 是建议设置 Proxy 以启用 Guest ManagementMR 是没有 Proxy → 没有外部连接 → Guest Management 功能无法启用Proxy 配置时机必须在 VM 创建时传入——不能后修改配置方式CLI 通过--proxy-configuration4 个子参数Portal 通过专门字段详见 §十三4.4 网络要求速查表项要求关键约束Network Fabric必须已部署MR 专属L3 isolation domain至少 1 个网络隔离单元L3 external network至少 1 个出口流量L3 internal network至少 1 个前 8 IP 保留IP CIDRsufficiently large未给具体数字——按 IP 需求规划Custom Location已配置Overview 页可查Detailed StatusRunning官方要求的部署前提Guest Management Proxy官方要求VM 创建时传入五、VM image requirements内容级要求官方原文 For Azure Local VM images to be used on Azure Local, make sure to satisfy the following requirements:Use only English (en-us) language VHDs to create VM images.For Linux VM images:To allow for initial configuration and customization during VM provisioning, you need to ensure that the image containscloud init with nocloud datasource.You need to configure thebootloader, kernel, and init systemin your image to enable bothserial connectivity and text-based console. Use bothGRUB_TERMINALconsole serialand kernel cmdline settings. This configuration is required to enable serial access for troubleshooting deployment issues and console support for your VM after deployment. Make sure the serial port settings on your system and terminal match to establish proper communication.5.1 通用en-us VHDMicrosoft 官方要求使用 en-us VHD以确保镜像能够正确初始化。5.2 Linux VM 镜像2 条项作用cloud-init nocloud datasourcecloud-init 根据提供的 userdata 完成初始化Serial connectivity text-based consoleGRUB kernel initAzure Local 依赖串口控制台进行 VM 启动日志采集和故障诊断5.3 与 HC 路径对比项HyperconvergedMulti-racken-us VHD未明示官方要求Linux cloud-init nocloud未明示官方要求Linux serial console未明示官方要求GRUB kernel init作者解读MR 路径的镜像要求比 HC 更明确——但上述 Linux 配置是所有 Azure Local Linux VM 的最佳实践HC 路径默认 Marketplace 镜像已内置。所以官方要求是相对于自定义 VHDX 上传场景。六、Azure CLI requirements客户端 5 步流程官方原文Skip this section if you arent using Azure CLI to provision and manage Azure Local VMs and VM resources.6.1 CLI 安装 5 步流程安装最新版 Azure CLI——在客户端机器上安装重启终端——确保 PATH 变量生效az login——本地安装用az login其他登录方式见 Sign in with the Azure CLIaz version——查看版本与依赖库升级用az upgrade安装stack-hci-vmextension——见下节6.2 stack-hci-vm extension 安装az extension list --output table az extension remove --name stack-hci-vm az extension add --name stack-hci-vm --version * az extension list --output table作者解读--version *表示安装最新版本——官方推荐stack-hci-vmextension 是 Azure CLI 与 Azure Local VM 交互的命令集建议每次 VM 操作前az extension list检查版本七、Multi-rack Prereqs 全量速查vs HCPrerequisites 项HyperconvergedMulti-rack本篇Azure 订阅 RBAC✅✅Azure 区域同一性未明示✅官方要求出站 URL 防火墙默认通过 Network Fabric 管控✅ 官方明文要求Resource Group建议同 RG跨 RG 可但同 regionNetwork Fabric L3 隔离域不涉及✅官方要求L3 external/internal networklogical network 即可✅官方要求 前 8 IP 保留Custom Location✅✅Detailed Status Running未明示✅官方要求VM image 来源3 种来源1 种来源Storage account详见 §十.4en-us VHD未明示✅官方要求Linux cloud-init nocloud未明示✅官方要求Linux serial console未明示✅官方要求Network Interface✅✅Guest Management Proxy建议✅官方要求Azure CLI 安装1 项5 步流程stack-hci-vm extension隐含✅ 明确安装步骤第二部分创建 VM实战命令八、顶部重要提示官方 Note官方原文页面顶部 Arc gateway isnt supported on Azure Local VMs.作者解读这条 Note位于页面最顶部——意味着它是 MR 路径下的首要限制HC 路径下az stack-hci-vm create ... --gateway-id $gw是支持的MR 不支持九、Multi-rack 创建 VM 与 HC 的 6 大差异速查维度HyperconvergedMulti-rack本篇Arc Gateway✅--gateway-id可用❌不支持Security typeStandard /Trusted Launch仅 StandardMemory typeStatic /Dynamic Memory仅 StaticAvailability Zone❌ 不涉及✅--zone zone-name详见 §十一.3.AStrict Placement❌ 不涉及✅--strict-placement true/false详见 §十一.3.BGuest Management Proxy建议官方要求详见 §四.3Trusted Launch 验证GuestStateIsolationTypecmdlet无不支持VM images3 种来源1 种来源Storage account详见 §十.4十、Prerequisites本页范围内10.1 3 种 tab 通用项订阅 RBAC 角色Resource groupVM imageCustom locationGuest Management Proxy 服务器详情MR 官方要求10.2 CLI tab 额外项网络接口——已创建在 logical network 或 virtual network subnet 上客户端连接——If using a client to connect to your Azure Local, see Connect to Azure Local via Azure CLI client10.3 ARM tab 额外项逻辑网络或虚拟网络子网——Access to a logical network or virtual network subnet that you associate with the VM on your Azure Local instance.10.4 VM image 来源仅 Storage account官方原文These VM images could be created usingVM image starting from an image in Azure Storage account.作者解读 [关键]⚠️MR 路径下 VM image 来源仅 Storage account 一种——不能直接引用 Marketplace ImageMarketplace 镜像通常先导入到 Storage Account 再使用详见 multi-rack-virtual-machine-image-storage-account十一、Azure CLI 路径11.1 必填参数速查表参数说明--nameVM 名称--resource-groupVM 所在 RG--admin-username/--admin-passwordVM 管理员--imageVM 镜像 ARM resource IDStorage account 镜像--locationAzure 区域--custom-locationCustom Location ARM resource ID--nicsNIC 名称或 ID至少 1 个--authentication-typeall/password/ssh--memory-mbCLI 参数1024 倍数如 1024 / 2048 / 4096 / 8192--processorsvCPU 数--proxy-configuration官方要求详见 §四.3--zone新增Availability Zone 名称--strict-placement新增true / false--enable-agentWS 2012/2012 R2 设为 false--enable-vm-config-agentWS 2012/2012 R2 设为 false11.2 完整命令Multi-rack 全参数az stack-hci-vm create \ --subscription $subscription \ --name $vmName \ --resource-group $resourceGroup \ --admin-username $userName \ --admin-password $password \ --computer-name $computerName \ --image $imageName \ --location $location \ --authentication-type all \ --nics $nicName \ --custom-location $customLocationID \ --hardware-profile memory-mb8192 processors4 \ --zone $zone \ --strict-placement true \ --enable-agent true \ --enable-vm-config-agent true \ --proxy-configuration \ http_proxy$httpProxy \ https_proxy$httpsProxy \ no_proxylocalhost,127.0.0.1,.svc,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,100.0.0.0/8 \ cert_file_path$certPath11.3 关键参数详解A.--zoneAvailability Zone官方原文zone(Optional) Name of the availability zone (rack) where you want the VM to be placed.在 Multi-rack 中Availability Zone 表示 Network Fabric 中定义的 Zone通常对应一个 Rack跨机架 VM 调度可实现机架级容灾必须先配置 Network Fabric 至少 1 个 rack 才能使用--zone不传--zone时VM 由 Azure Local 自动选择 zonebest-effortB.--strict-placement官方原文strict-placement(Optional) Choose strict placement if you have specified a zone and want the VM to only be scheduled on the specified availability zone. If the specified zone doesnt have capacity or is unavailable,VM creation will fail. If you specify no for this parameter, the VM will be scheduled on the specified zone on abest-effort basis.作者解读 [常见误区]❌ 常见误区strict-placement 是默认行为 ✅ 真相CLI 参数默认 false——指定的 zone 没容量时VM 会尝试其他 zone❌ 常见误区strict-placement true 后 VM 一定在该 zone ✅ 真相strict-placement true 时如果 zone 没容量或不可用VM 创建直接失败不会 fallbackC.--memory-mbCLI 参数1024 倍数官方原文The value must be a multiple of 1024 (that is, specified in whole GB increments such as 1024, 2048, 4096, 8192).HC 路径没此限制仅是建议MR 路径是硬要求传memory-mb3000非 1024 倍数命令会失败十二、Linux VM官方原文To create a Linux VM, use the same command that you used to create the Windows VM.For SSH keys, you need to pass thessh-key-valuesparameters along withauthentication-type ssh. If you are using an existing key, ensure that the public key is inOpenSSH format.官方原文Linux VM ImportantThe VM created has guest management enabled by default.It is required to provide HTTP proxy to enable guest management properly.作者解读MR 路径下 Linux Proxy 也是官方要求——与 HC 路径的差异HC 仅 Ubuntu Server 验证过MR 全部 Linux 官方要求SSH key 格式必须是OpenSSH——其他格式PEM、RSA 私钥等需先转换十三、Azure Portal 路径13.1 5 步流程Azure Arc cluster view→Virtual machines顶部命令栏 → Create VMBasics tab→Project detailsInstance detailsVM extensions→ 启用 Guest ManagementVM proxy configuration→ 填 4 个字段http_proxy / https_proxy / no_proxy / cert_file_path详见 §四.313.2 关键参数MR 专属字段说明Security type仅 StandardHC 有 Trusted Launch 选项MR 没有Memory type仅 StaticHC 有 Dynamic 选项MR 没有Availability Zone新增选择机架名见 §十一.3.AStrict placement新增Yes / No见 §十一.3.B13.3 NIC 限制关键官方原文Portal VM extensions NoteAdd at least one network interface through theNetworkingtab to complete guest management setup.The network interface that you enable, must have a valid IP address and internet access by setting VM proxy.作者解读Guest Management 功能依赖 NIC Proxy——没有 NIC 或没有 ProxyGuest Management 都无法启用十四、ARM template 路径ARM template 通过az deployment group create或 Portal 触发参数与 CLI 路径对齐但需要 Logical NetworkHC 路径是 NICMR 路径是 Logical Network关键参数image/custom-location/logicalNetwork/proxy-configuration十五、Use managed identity自动启用官方原文When the VMs are created on your Azure Local via Azure CLI or Azure portal, a system-assigned managed identity is also created that lasts for the lifetime of the VMs.The VMs on Azure Local are extended from Arc-enabled servers and can use system-assigned managed identity to access other Azure resources that support Microsoft Entra ID-based authentication. For example, the VMs can use a system-assigned managed identity to access the Azure Key Vault.作者解读与 HC 路径完全一致——system-assigned managed identity 自动创建用于访问支持Microsoft Entra ID-based authentication的 Azure 资源典型用例Azure Key Vault官方明文示例不需要az identity assign——全自动第三部分重点结论 附录十六、重点结论[作者总结]网络与集群MR 部署的硬性前提是 Network Fabric 已部署——现有 ToR / BGP 不替代。官方要求相关 Azure 资源位于同一区域RG 可不同。L3 internal network 前 8 个 IP 被保留——IP 规划时扣掉不代表官方推荐 /24按工作负载需求规划。Detailed Status Running 是官方要求的部署前提——不是不 Running 就一定失败。镜像要求MR 路径 VM image 仅 Storage account 一种——不能直接引用 Marketplace ImageMarketplace 镜像通常先导入到 Storage Account 再使用。Linux 自定义镜像官方要求en-us VHD cloud-init nocloud Serial ConsoleGRUB kernel init。Windows 镜像在 Marketplace 已有标准配置。创建 VM 差异MR 比 HC 多 9 项官方要求——本质是网络底座更复杂 跨机架可靠性更高。MR 有 6 大功能差异其中 4 项是降级不支持 Trusted Launch / Dynamic Memory / Arc Gateway / 直接 Marketplace 引用。新增两个 Multi-rack 专属参数--zone指定目标 Availability Zone与--strict-placementfalsebest-efforttrue严格调度。CLI 参数--memory-mb强制 1024 倍数——HC 是建议MR 是硬要求Portal 用户不受此限制。Arc Gateway 不支持——页面顶部 Note 明示。MR 路径不能用 Trusted Launch 或 Dynamic Memory——业务需要时必须选 HC 路径。Guest Management Proxy 是 MR 官方要求——不配 → Guest Management 功能无法启用VM Extension / Update Manager / Run Command 失效。Guest Management 功能依赖 NIC Proxy——没有 NIC 或没有 ProxyGuest Management 都无法启用。Availability Zone 不是 Azure 公有云 Region——MR 路径下是 Network Fabric 中定义的 Zone通常对应一个 Rack。完整误区与各章详细说明参见上文 §一~§十五各小节。附录 A术语约定术语含义Multi-rackAzure Local 2606 的多机架、跨交换机域部署形态Network FabricMR 部署的网络编排底座L3 isolation domainLayer 3 隔离域——Network Fabric 内的逻辑隔离单元L3 external networkVM 流量的出口网络L3 internal networkVM 流量的内部网络前 8 IP 保留Custom LocationAzure Local 集群定位符cloud-init nocloudcloud-init 读取本地配置的 datasourceGRUB_TERMINALconsole serialGRUB 通过串口输出启动菜单stack-hci-vm extensionAzure CLI 与 Azure Local VM 交互的命令扩展Detailed StatusAzure Local 集群 Overview 页的状态字段Running是 VM 创建的前置条件Availability ZoneMR 专属Network Fabric 中定义的 Zone通常对应一个 RackStrict Placementstrict-placementtrue 时严格按 zone 调度false 时 best-effort1024 倍数限制CLI 参数--memory-mb必须 1024 倍数Guest Management ProxyAzure Local VM 启用 Guest Management 所必需的 HTTP/HTTPS Proxysystem-assigned managed identityAzure 自动给 VM 分配的托管标识附录 B参考链接Prereqs 主文档Review prerequisites for Azure Local VMs for multi-rack deploymentsCreate VM 主文档Create Azure Local Virtual Machines Enabled by Azure Arc on Multi-rack DeploymentsRBAC 角色multi-rack-assign-vm-rbac-rolesVM image 创建multi-rack-virtual-machine-image-storage-account防火墙要求Required firewall URLs for Azure Local deploymentsAzure CLI 安装Install Azure CLICLI 登录Sign in with the Azure CLIManage VMMRmulti-rack-manage-arc-virtual-machinesVM operationsMRmulti-rack-virtual-machine-operationsManaged IdentitySystem-assigned managed identities第 1 篇HC 完整路径Azure-Local-VM-Deploy-01-Hyperconverged.md文档维护本篇对应 azloc-26062026 年 7 月视图适用于 azloc-2512 及以后的 Multi-rack 部署。如官方在更高版本拆分 Create VM 章节如按 Trusted Launch 或 GPU 类型拆子页面本篇将随之更新。