使用英语阅读

通过

教程：使用 Azure CLI 修改虚拟机规模集

  • 2025/06/13

部署和浏览

在整个应用程序的生命周期中，可能需要修改或更新虚拟机规模集。 这些更新可能包括如何更新规模集的配置或更改应用程序配置。 本文介绍如何使用 Azure CLI 修改现有规模集。

下面，我们声明将在整个文档中使用的环境变量。 为了使每次部署的资源名称唯一，都会在其后面附加一个随机后缀。 将 REGION 设置为 chinanorth2。

设置资源组

在继续之前，请确保资源组存在。 此步骤创建资源组（如果尚不存在）。

export RANDOM_SUFFIX=$(openssl rand -hex 3)
export MY_RESOURCE_GROUP_NAME="myResourceGroup$RANDOM_SUFFIX"
export REGION="chinanorth2"
az group create --name $MY_RESOURCE_GROUP_NAME --location $REGION

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx",
  "location": "chinanorth2",
  "managedBy": null,
  "name": "myResourceGroupxxx",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

创建虚拟机规模集

若要确保后续的更新和查询命令具有有效的资源来运行，请创建虚拟机规模集。 在此步骤中，使用有效的映像 (Ubuntu2204) 部署一个基本规模集，并将实例计数设置为 5，使特定于实例的更新可以面向现有实例 ID。

export SCALE_SET_NAME="myScaleSet$RANDOM_SUFFIX"
az vmss create \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $SCALE_SET_NAME \
  --image Ubuntu2204 \
  --upgrade-policy-mode manual \
  --instance-count 5 \
  --admin-username azureuser \
  --generate-ssh-keys

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSetxxx",
  "location": "chinanorth2",
  "name": "myScaleSetxxx",
  "provisioningState": "Succeeded"
}

更新规模集模型

规模集有一个“规模集模型”，用于反映整个规模集的期望状态。 若要查询规模集的模型，可以使用 az vmss show：

az vmss show --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME

输出的确切表示取决于提供给命令的选项。 以下示例显示了 Azure CLI 中的精简示例输出：

{
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSetxxx",
  "location": "chinanorth2",
  "name": "myScaleSetxxx",
  "orchestrationMode": "Flexible",
  "platformFaultDomainCount": 1,
  "resourceGroup": "myResourceGroupxxx",
  "sku": {
    "capacity": 5,
    "name": "Standard_DS1_v2",
    "tier": "Standard"
  },
  "timeCreated": "2022-11-29T22:16:43.250912+00:00",
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "networkProfile": {
    "networkApiVersion": "2020-11-01",
    "networkInterfaceConfigurations": [
      {
        "deleteOption": "Delete",
        "disableTcpStateTracking": false,
        "dnsSettings": {
          "dnsServers": []
        },
        "enableIpForwarding": false,
        "ipConfigurations": [
          {
            "applicationGatewayBackendAddressPools": [],
            "applicationSecurityGroups": [],
            "loadBalancerBackendAddressPools": [
              {
                "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Network/loadBalancers/myScaleSetLB/backendAddressPools/myScaleSetLBBEPool",
                "resourceGroup": "myResourceGroupxxx"
              }
            ],
            "name": "mysca2215IPConfig",
            "privateIpAddressVersion": "IPv4",
            "subnet": {
              "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Network/virtualNetworks/myScaleSetVNET/subnets/myScaleSetSubnet",
              "resourceGroup": "myResourceGroupxxx"
            }
          }
        ],
        "name": "mysca2215Nic",
        "networkSecurityGroup": {
          "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Network/networkSecurityGroups/myScaleSetNSG",
          "resourceGroup": "myResourceGroupxxx"
        },
        "primary": true
      }
    ]
  },
  "osProfile": {
    "allowExtensionOperations": true,
    "computerNamePrefix": "myScaleS",
    "linuxConfiguration": {
      "disablePasswordAuthentication": true,
      "enableVmAgentPlatformUpdates": false,
      "patchSettings": {
        "assessmentMode": "ImageDefault",
        "patchMode": "ImageDefault"
      },
      "provisionVmAgent": true
    }
  },
  "storageProfile": {
    "imageReference": {
      "offer": "UbuntuServer",
      "publisher": "Canonical",
      "sku": "22_04-lts",
      "version": "latest"
    },
    "osDisk": {
      "caching": "ReadWrite",
      "createOption": "FromImage",
      "deleteOption": "Delete",
      "diskSizeGb": 30,
      "managedDisk": {
        "storageAccountType": "Premium_LRS"
      },
      "osType": "Linux"
    }
  }
}

可以使用 az vmss update 更新规模集的各种属性。 例如，更新许可证类型或 VM 的实例保护策略。 请注意，允许的许可证类型值 RHEL_BYOS 而不是 Windows_Server。

az vmss update --name $SCALE_SET_NAME --resource-group $MY_RESOURCE_GROUP_NAME --license-type RHEL_BYOS

export INSTANCE_ID=$(az vmss list-instances \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $SCALE_SET_NAME \
  --query "[0].instanceId" \
  -o tsv)

az vmss update \
  --name $SCALE_SET_NAME \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --instance-id "$INSTANCE_ID" \
  --protect-from-scale-set-actions False \
  --protect-from-scale-in

此外，如果以前使用 az vmss create 命令部署了规模集，则可以再次运行该 az vmss create 命令来更新规模集。 请确保命令中的所有 az vmss create 属性都与以前相同，但要修改的属性除外。 例如，下面我们将实例计数增加到 5。

重要

从 2023 年 11 月开始，使用 PowerShell 和 Azure CLI 创建的 VM 规模集将默认为灵活业务流程模式（如果未指定业务流程模式）。 若要详细了解此更改以及需要采取的措施，请访问针对 VMSS PowerShell/CLI 客户的重大变更 - Microsoft 社区中心

az vmss create \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $SCALE_SET_NAME \
  --orchestration-mode flexible \
  --image RHELRaw8LVMGen2 \
  --admin-username azureuser \
  --generate-ssh-keys \
  --instance-count 5 \
  --os-disk-size-gb 64

更新规模集中的各个 VM 实例

与规模集具有模型视图的方式类似，规模集中的每个 VM 实例都有自己的模型视图。 若要查询规模集中特定 VM 实例的模型视图，可以使用 az vm show。

export INSTANCE_NAME=$(az vmss list-instances \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $SCALE_SET_NAME \
  --query "[0].name" \
  -o tsv)

az vm show --resource-group $MY_RESOURCE_GROUP_NAME --name $INSTANCE_NAME

输出的确切表示取决于提供给命令的选项。 以下示例显示了 Azure CLI 中的精简示例输出：

{
  "hardwareProfile": {
    "vmSize": "Standard_DS1_v2"
  },
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/virtualMachines/myScaleSet_Instance1",
  "location": "chinanorth2",
  "name": "myScaleSet_Instance1",
  "networkProfile": {
    "networkInterfaces": [
      {
        "deleteOption": "Delete",
        "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Network/networkInterfaces/mysca2215Nic-5cf164f7",
        "primary": true,
        "resourceGroup": "myResourceGroupxxx"
      }
    ]
  },
  "osProfile": {
    "allowExtensionOperations": true,
    "computerName": "myScaleset_Computer1",
    "linuxConfiguration": {
      "disablePasswordAuthentication": true,
      "enableVmAgentPlatformUpdates": false,
      "patchSettings": {
        "assessmentMode": "ImageDefault",
        "patchMode": "ImageDefault"
      },
      "provisionVmAgent": true
    }
  },
  "provisioningState": "Succeeded",
  "resourceGroup": "myResourceGroupxxx",
  "storageProfile": {
    "dataDisks": [],
    "imageReference": {
      "exactVersion": "22.04.202204200",
      "offer": "0001-com-ubuntu-server-jammy",
      "publisher": "Canonical",
      "sku": "22_04-lts",
      "version": "latest"
    },
    "osDisk": {
      "caching": "ReadWrite",
      "createOption": "FromImage",
      "deleteOption": "Delete",
      "diskSizeGb": 30,
      "managedDisk": {
        "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/disks/myScaleSet_Instance1_disk1_xxx",
        "resourceGroup": "myResourceGroupxxx",
        "storageAccountType": "Premium_LRS"
      },
      "name": "myScaleSet_Instance1_disk1_xxx",
      "osType": "Linux"
    }
  },
  "timeCreated": "2022-11-29T22:16:44.500895+00:00",
  "type": "Microsoft.Compute/virtualMachines",
  "virtualMachineScaleSet": {
    "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSetxxx",
    "resourceGroup": "myResourceGroupxxx"
  }
}

这些属性描述规模集中 VM 实例的配置，而不是整个规模集的配置。

可以像对独立 VM 一样，对规模集内的各个独立 VM 实例执行更新。 例如，将新的数据磁盘附加到实例 1：

az vm disk attach --resource-group $MY_RESOURCE_GROUP_NAME --vm-name $INSTANCE_NAME --name disk_name1 --new

再次运行 az vm show ，现在会看到 VM 实例附加了新的磁盘。

{
  "storageProfile": {
    "dataDisks": [
      {
        "caching": "None",
        "createOption": "Empty",
        "deleteOption": "Detach",
        "diskSizeGb": 1023,
        "lun": 0,
        "managedDisk": {
          "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/disks/disk_name1",
          "resourceGroup": "myResourceGroupxxx",
          "storageAccountType": "Premium_LRS"
        },
        "name": "disk_name1",
        "toBeDetached": false
      }
    ]
  }
}

将实例添加到规模集

有时您可能想向规模集中添加新的虚拟机，但希望这些虚拟机的配置选项不同于规模集模型中列出的选项。 可以在创建期间使用 az vm create 命令将 VM 添加到规模集，并指定要将实例添加到的规模集名称。

export NEW_INSTANCE_NAME="myNewInstance$RANDOM_SUFFIX"
az vm create --name $NEW_INSTANCE_NAME --resource-group $MY_RESOURCE_GROUP_NAME --vmss $SCALE_SET_NAME --image RHELRaw8LVMGen2

{
  "fqdns": "",
  "id": "/subscriptions/xxxxx/resourceGroups/myResourceGroupxxx/providers/Microsoft.Compute/virtualMachines/myNewInstancexxx",
  "location": "chinanorth2",
  "macAddress": "60-45-BD-D7-13-DD",
  "powerState": "VM running",
  "privateIpAddress": "10.0.0.6",
  "publicIpAddress": "20.172.144.96",
  "resourceGroup": "myResourceGroupxxx",
  "zones": ""
}

如果随后检查规模集，将看到添加的新实例。

az vm list --resource-group $MY_RESOURCE_GROUP_NAME --output table

Name                  ResourceGroup      Location
--------------------  ---------------    ----------
myNewInstancexxx      myResourceGroupxxx chinanorth2
myScaleSet_Instance1  myResourceGroupxxx chinanorth2
myScaleSet_Instance1  myResourceGroupxxx chinanorth2

使用最新的规模集模型对 VM 进行更新

备注

使用灵活编排模式的虚拟机规模组目前不支持升级模式。

规模集有一项“升级策略”，该策略决定了如何使用最新的规模集模型对 VM 进行更新。 升级策略的三种模式是：

  • 自动 - 在此模式下，规模集无法保证 VM 的关闭顺序。 规模集可能同时关闭所有 VM。
  • 滚动 - 在此模式下，规模集以批为单位推出更新，并在批之间提供可选的暂停时间。
  • 手动 - 在这种模式下，更新扩展集模型时，现有 VM 不会有任何变化，直到触发手动更新为止。

如果您的规模集设置为手动升级，则可以通过使用 az vmss update 来触发手动升级。

az vmss update --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME

备注

Service Fabric 群集只能使用 自动 模式，但更新的处理方式不同。 有关详细信息，请参阅 Service Fabric 应用程序升级。

对规模集进行重映像

虚拟机规模集将为规模集中的每个 VM 生成独一无二的名称。 命名约定因业务流程模式而异：

  • 灵活业务流程模式：{scale-set-name}_{8-char-guid}
  • 统一业务流程模式：{scale-set-name}_{instance-id}

在需要重置特定实例映像的情况下，请使用 az vmss reimage 并指定实例 ID。另一种方法是使用 az vm 重新部署 直接重置 VM 映像。 如果要重新映像 VM，而无需指定实例 ID，则此命令非常有用。

# Get the VM name first
VM_NAME=$(az vmss list-instances \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $SCALE_SET_NAME \
  --query "[0].name" \
  -o tsv)

# Reimage the VM directly
az vm redeploy \
  --resource-group $MY_RESOURCE_GROUP_NAME \
  --name $VM_NAME

更新规模集的 OS 映像

你可能具有运行旧版 Ubuntu 的规模集。 你想要更新到较新版本的 Ubuntu，例如最新版本。 映像引用版本属性不是列表的一部分，因此可以使用 az vmss update 直接修改这些属性。

az vmss update --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME --set virtualMachineProfile.storageProfile.imageReference.version=latest

或者，你可能想要更改规模集使用的映像。 例如，你可能想要更新或更改规模集使用的自定义映像。 可以通过更新“映像引用 ID”属性来更改规模集使用的映像。 映像引用 ID 属性不是列表的一部分，因此可以使用 az vmss update 直接修改此属性。

如果使用 Azure 平台映像，可以通过修改 imageReference 来更新映像（有关详细信息，请参阅 REST API 文档）。

备注

使用平台映像时，通常指定“latest”作为映像引用版本。 在你执行创建、横向扩展和重置映像操作时，将使用最新发布的脚本创建 VM。 但是， 这并不意味着 随着新的映像版本发布，OS 映像会随着时间推移自动更新。 单独的功能提供自动 OS 升级。 有关详细信息，请参阅 自动 OS 升级文档。

如果使用自定义映像，可以通过更新 imageReference ID 来更新映像（有关详细信息，请参阅 REST API 文档）。

更新规模集的负载均衡器

假设你有一个包含 Azure 负载均衡器的规模集，并且想要将 Azure 负载均衡器替换为 Azure 应用程序网关。 规模集的负载均衡器和应用程序网关属性是列表的一部分，因此可以使用命令来删除或添加列表元素，而不是直接修改属性。

# Remove the load balancer backend pool from the scale set model
az vmss update --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME --remove virtualMachineProfile.networkProfile.networkInterfaceConfigurations[0].ipConfigurations[0].loadBalancerBackendAddressPools 0

# Remove the load balancer backend pool from the scale set model; only necessary if you have NAT pools configured on the scale set
az vmss update --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME --remove virtualMachineProfile.networkProfile.networkInterfaceConfigurations[0].ipConfigurations[0].loadBalancerInboundNatPools 0

# Add the application gateway backend pool to the scale set model
az vmss update --resource-group $MY_RESOURCE_GROUP_NAME --name $SCALE_SET_NAME --add virtualMachineProfile.networkProfile.networkInterfaceConfigurations[0].ipConfigurations[0].ApplicationGatewayBackendAddressPools '{"id": "/subscriptions/xxxxx/resourceGroups/'$MY_RESOURCE_GROUP_NAME'/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}/backendAddressPools/{applicationGatewayBackendPoolName}"}'

备注

这些命令假定规模集上只有一个 IP 配置和负载均衡器。 如果有多个，则可能需要使用非 0 的列表索引。

后续步骤

本教程介绍了如何修改规模集和单个实例的各个方面。

  • 更新规模集模型
  • 更新规模集中的单个 VM 实例
  • 将实例添加到规模集
  • 使用最新的规模集模型对 VM 进行更新
  • 对规模集进行重映像
  • 更新规模集的 OS 映像
  • 更新规模集的负载均衡器

通过规模集使用数据磁盘