Изменение масштабируемого набора виртуальных машин

Статья
05/31/2023

Примечание.

Многие шаги, перечисленные в этом документе, применяются к Масштабируемые наборы виртуальных машин с помощью режима единой оркестрации. Мы рекомендуем использовать гибкую оркестрацию для новых рабочих нагрузок. Дополнительные сведения см. в режимах Orchesration для Масштабируемые наборы виртуальных машин в Azure.

На протяжении всего жизненного цикла приложений может потребоваться изменить или обновить масштабируемый набор виртуальных машин. Это может быть обновление конфигурации масштабируемого набора или изменение конфигурации приложения. В этой статье описывается, как можно изменить существующий масштабируемый набор с помощью интерфейсов REST API, Azure PowerShell или Azure CLI.

Базовые понятия

Модель масштабируемого набора

Масштабируемый набор содержит модель, которая фиксирует требуемое состояние набора в целом. Для запроса модели масштабируемого набора можно использовать:

REST API с compute/virtualmachinescalesets/get, как показано ниже.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet?api-version={apiVersion}

Командлет Get-AzVmss в Azure PowerShell:

Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

Команду az vmss show в Azure CLI.

az vmss show --resource-group myResourceGroup --name myScaleSet

Можно также использовать resources.azure.com или пакеты SDK Azure для конкретного языка.

Точное представление выходных данных зависит от параметров, введенных в команде. Ниже показан сокращенный пример выходных данных Azure CLI.

az vmss show --resource-group myResourceGroup --name myScaleSet
{
  "location": "westus",
  "overprovision": true,
  "plan": null,
  "singlePlacementGroup": true,
  "sku": {
    "additionalProperties": {},
    "capacity": 1,
    "name": "Standard_D2_v2",
    "tier": "Standard"
  },
}

Эти свойства применяются к масштабируемому набору в целом.

Представление экземпляра масштабируемого набора

Масштабируемый набор также имеет представление экземпляра, которое фиксирует текущее состояние среды выполнения масштабируемого набора в целом. Для запроса представления экземпляра масштабируемого набора можно использовать следующие средства.

REST API с compute/virtualmachinescalesets/getinstanceview, как показано ниже.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/instanceView?api-version={apiVersion}

Командлет Get-AzVmss в Azure PowerShell:

Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet" -InstanceView

Можно использовать команду az vmss get-instance-view в Azure CLI.
```
az vmss get-instance-view --resource-group myResourceGroup --name myScaleSet
```
Можно также использовать resources.azure.com или пакеты SDK Azure для конкретного языка.

$ az vmss get-instance-view --resource-group myResourceGroup --name myScaleSet
{
  "statuses": [
    {
      "additionalProperties": {},
      "code": "ProvisioningState/succeeded",
      "displayStatus": "Provisioning succeeded",
      "level": "Info",
      "message": null,
      "time": "{time}"
    }
  ],
  "virtualMachine": {
    "additionalProperties": {},
    "statusesSummary": [
      {
        "additionalProperties": {},
        "code": "ProvisioningState/succeeded",
        "count": 1
      }
    ]
  }
}

Эти свойства предоставляют сводку текущего состояния среды выполнения виртуальных машин в масштабируемом наборе, включая состояние расширений, применяемых к набору.

Представление модели виртуальной машины масштабируемого набора

Как и масштабируемый набор, каждый экземпляр виртуальной машины в наборе имеет свое представление модели. Для запроса представления модели экземпляра определенной виртуальной машины в масштабируемом наборе можно использовать следующие средства.

REST API с compute/virtualmachinescalesetvms/get, как показано ниже.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/virtualmachines/instanceId?api-version={apiVersion}

Командлет Get-AzVmssVm в Azure PowerShell:

Get-AzVmssVm -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet" -InstanceId instanceId

Команду az vmss show в Azure CLI.

az vmss show --resource-group myResourceGroup --name myScaleSet --instance-id instanceId

Можно также использовать resources.azure.com или пакеты SDK Azure.

$ az vmss show --resource-group myResourceGroup --name myScaleSet
{
  "location": "westus",
  "name": "{name}",
  "sku": {
    "name": "Standard_D2_v2",
    "tier": "Standard"
  },
}

Эти свойства описывают конфигурацию экземпляра виртуальной машины в масштабируемом наборе, а не конфигурацию масштабируемого набора в целом. Например, модель масштабируемого набора имеет свойство overprovision, которого нет у модели экземпляра виртуальной машины в наборе. Это отличие вызвано тем, что избыточная подготовка является свойством масштабируемого набора в целом, а не отдельных экземпляров виртуальных машин в наборе (дополнительные сведения об избыточной подготовке см. в этом разделе).

Представление экземпляра виртуальной машины в масштабируемом наборе

Как и масштабируемый набор, каждый экземпляр виртуальной машины в наборе имеет свое представление. Для запроса представления определенного экземпляра виртуальной машины в масштабируемом наборе можно использовать следующие средства.

REST API с compute/virtualmachinescalesetvms/getinstanceview, как показано ниже.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/virtualmachines/instanceId/instanceView?api-version={apiVersion}

Командлет Get-AzVmssVm в Azure PowerShell:

Get-AzVmssVm -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet" -InstanceId instanceId -InstanceView

Можно использовать команду az vmss get-instance-view в Azure CLI.

az vmss get-instance-view --resource-group myResourceGroup --name myScaleSet --instance-id instanceId

Можно также использовать resources.azure.com или пакеты SDK Azure.

$ az vmss get-instance-view --resource-group myResourceGroup --name myScaleSet --instance-id instanceId
{
  "additionalProperties": {
    "osName": "ubuntu",
    "osVersion": "16.04"
  },
  "disks": [
    {
      "name": "{name}",
      "statuses": [
        {
          "additionalProperties": {},
          "code": "ProvisioningState/succeeded",
          "displayStatus": "Provisioning succeeded",
          "time": "{time}"
        }
      ]
    }
  ],
  "statuses": [
    {
      "additionalProperties": {},
      "code": "ProvisioningState/succeeded",
      "displayStatus": "Provisioning succeeded",
      "time": "{time}"
    },
    {
      "additionalProperties": {},
      "code": "PowerState/running",
      "displayStatus": "VM running"
    }
  ],
  "vmAgent": {
    "statuses": [
      {
        "additionalProperties": {},
        "code": "ProvisioningState/succeeded",
        "displayStatus": "Ready",
        "level": "Info",
        "message": "Guest Agent is running",
        "time": "{time}"
      }
    ],
    "vmAgentVersion": "{version}"
  },
}

Эти свойства описывают текущее состояние среды выполнения экземпляра виртуальной машины в масштабируемом наборе, включая любые расширения, применяемые к масштабируемому набору.

Как обновлять глобальные свойства масштабируемого набора

Для обновления глобального свойства масштабируемого набора необходимо обновить свойство в модели набора. Это можно сделать следующим образом.

Можно использовать REST API с compute/virtualmachinescalesets/createorupdate, как показано ниже.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet?api-version={apiVersion}

Вы можете развернуть шаблон Resource Manager, обновив глобальные свойства масштабируемого набора с помощью свойств REST API.

Командлет Update-AzVmss в Azure PowerShell:

Update-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet" -VirtualMachineScaleSet {scaleSetConfigPowershellObject}

Можно использовать команду az vmss update в Azure CLI.
- Чтобы изменить свойство, выполните следующую команду.
```
az vmss update --set {propertyPath}={value}
```
- Чтобы добавить объект в свойство списка масштабируемого набора, выполните следующую команду.
```
az vmss update --add {propertyPath} {JSONObjectToAdd}
```
- Чтобы удалить объект из свойства списка масштабируемого набора, выполните следующую команду.
```
az vmss update --remove {propertyPath} {indexToRemove}
```
- Если вы ранее развернули масштабируемый набор с помощью команды az vmss create, то вы можете снова выполнить команду az vmss create, чтобы его обновить. Проверьте, совпадают ли все свойства в команде az vmss create с предыдущими, за исключением тех, которые вы хотите изменить.
Можно также использовать resources.azure.com или пакеты SDK Azure.

После обновления модели масштабируемого набора новая конфигурация применяется ко всем новым виртуальным машинам, созданным в наборе. Тем не менее модели для существующих виртуальных машин в наборе все равно должны быть обновлены в соответствии с последней общей моделью масштабируемого набора. В модели каждой виртуальной машины есть логическое свойство latestModelApplied. Оно указывает, актуальна ли виртуальная машина по отношению к последней общей модели масштабируемого набора (true означает, что виртуальная машина обновлена).

Свойства с ограничениями на изменение

Свойства времени создания

Некоторые свойства можно задать только при создании масштабируемого набора. Некоторые примеры включают тип учетной записи хранения управляемого диска ОС и домены сбоя.

Свойства, которые можно изменить только на основе текущего значения

Некоторые свойства можно изменить только в зависимости от текущего значения. Эти свойства включают в себя:

singlePlacementGroup
подсеть
imageReferenceSku
imageReferenceOffererOffer
Зоны доступности (предварительная версия)

Пример 1

Чтобы обновить масштабируемый набор, чтобы использовать другую версию ОС, необходимо задать все обновленные свойства в одном вызове. В этом примере мы переходим с Unbuntu Server 20.04 на 22.04.

az vmss update \
--resource-group myResourceGroup \
--name myScaleSet \
--set virtualMachineProfile.storageProfile.imageReference.offer=0001-com-ubuntu-server-jammy \
--set virtualMachineProfile.storageProfile.imageReference.publisher=Canonical \
--set virtualMachineProfile.storageProfile.imageReference.sku=22_04-lts-gen2 \
--set virtualMachineProfile.storageProfile.imageReference.version=latest

Пример 2

Чтобы обновить масштабируемый набор, чтобы использовать другую версию ОС, необходимо задать все обновленные свойства в одном вызове. В этом примере мы переходим с Windows Server 2016 на Windows Server 2019.

$VMSS = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

Set-AzVmssStorageProfile $vmss `
    -OsDiskCreateOption "FromImage" `
    -ImageReferencePublisher "MicrosoftWindowsServer" `
    -ImageReferenceOffer "WindowsServer" `
    -ImageReferenceSku "2019-datacenter" `
    -ImageReferenceVersion "latest"

Update-AzVmss -ResourceGroupName "myResourceGroup" -Name "myScaleSet" -VirtualMachineScaleSet $VMSS

Свойства, для изменения которых требуется освободить виртуальные машины

Для некоторых свойств можно задать определенные значения, только если виртуальные машины в масштабируемом наборе освобождены. Эти свойства включают в себя:

SKU name. Если SKU новой виртуальной машины не поддерживается на оборудовании используемого масштабируемого набора, необходимо освободить виртуальные машины в масштабируемом наборе и изменить имя SKU. Дополнительные сведения см. в статье Изменение размера виртуальной машины Windows.

Обновления отдельных виртуальных машин

Некоторые изменения можно применить к отдельным виртуальным машинам, а не к глобальным свойствам масштабируемого набора. В настоящее время единственным обновлением отдельных виртуальных машин, которое поддерживается, является подключение или отключение дисков данных виртуальных машин в масштабируемом наборе. Эта функция находится в режиме предварительного просмотра. Дополнительные сведения см. в документации по предварительной версии.

Сценарии

Обновления приложений

Если приложение развертывается в масштабируемом наборе с помощью расширений, то при обновлении конфигурации расширения приложение будет обновлено в соответствии с политикой обновления. Например, если у вас есть новая версия сценария для запуска в расширении пользовательских сценариев, вы можете обновить свойство fileUris, чтобы указать новый сценарий. В некоторых случаях вы можете принудительно выполнить обновление, даже если конфигурация расширения не изменилась (например, вы обновили сценарий без изменения его универсального кода ресурса (URI)). В таких случаях можно изменить forceUpdateTag для принудительного обновления. Это свойство не интерпретируется платформой Azure. Если изменить его значение, это не повлияет работу расширения. Изменение просто приведет к повторному запуску расширения. Дополнительные сведения о forceUpdateTag см. в документации по REST API для расширений. Обратите внимание, что forceUpdateTag может использоваться со всеми расширениями, а не только с расширением пользовательских скриптов.

Приложения также часто развертывают с помощью пользовательского образа. Этот сценарий описан в следующем разделе.

обновления ОС;

При использовании образов платформы Azure их можно обновить, изменив imageReference (дополнительные сведения см. в документации по REST API).

Примечание.

Для образов платформы обычно указывается последняя версия в качестве эталонной версии образа. Во время создания, горизонтального увеличения масштаба и повторного создания образов виртуальные машины создаются на основе последней доступной версии. Тем не менее это не означает, что образ ОС будет автоматически обновляться по мере выпуска новых версий. За автоматическое обновление ОС отвечает отдельная функция. Дополнительные сведения см. в документации по автоматическому обновлению ОС.

При использовании пользовательских образов их можно обновить, изменив идентификатор imageReference (дополнительные сведения см. в документации по REST API).

Примеры

Обновление образа ОС масштабируемого набора

Предположим, что у вас есть масштабируемый набор, который работает под управлением старой версии Ubuntu LTS 16.04. Его нужно обновить до более новой версии Ubuntu LTS 16.04 (например, 16.04.201801090). Свойство эталонной версии образа не входит в список, поэтому можно непосредственно изменить эти свойства с помощью одной из следующих команд.

Командлет Update-AzVmss в Azure PowerShell, как показано ниже.

Update-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet" -ImageReferenceVersion 16.04.201801090

Можно использовать команду az vmss update в Azure CLI.

az vmss update --resource-group myResourceGroup --name myScaleSet --set virtualMachineProfile.storageProfile.imageReference.version=16.04.201801090

Также может потребоваться изменить образ, используемый масштабируемым набором. Например, может потребоваться обновить или изменить пользовательский образ, используемый масштабируемым набором. Чтобы изменить образ, используемый масштабируемым набором, измените свойство идентификатора эталонного изображения. Свойство идентификатора эталонного образа не входит в список, поэтому можно непосредственно изменить это свойство с помощью одной из следующих команд.

Командлет Update-AzVmss в Azure PowerShell, как показано ниже.

Update-AzVmss `
    -ResourceGroupName "myResourceGroup" `
    -VMScaleSetName "myScaleSet" `
    -ImageReferenceId /subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myNewImage

Можно использовать команду az vmss update в Azure CLI.

az vmss update \
    --resource-group myResourceGroup \
    --name myScaleSet \
    --set virtualMachineProfile.storageProfile.imageReference.id=/subscriptions/{subscriptionID}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/images/myNewImage

Обновление подсистемы балансировки нагрузки масштабируемого набора

Предположим, у вас есть масштабируемый набор с Azure Load Balancer и вы хотите заменить Azure Load Balancer на шлюз приложений Azure. Свойства подсистемы балансировки нагрузки и шлюза приложений для масштабируемого набора являются частью списка, поэтому вы можете использовать команды для удаления и добавления элементов списка вместо прямого изменения свойств.

Azure PowerShell:

# Get the current model of the scale set and store it in a local PowerShell object named $vmss
$vmss=Get-AzVmss -ResourceGroupName "myResourceGroup" -Name "myScaleSet"

# Create a local PowerShell object for the new desired IP configuration, which includes the reference to the application gateway
$ipconf = New-AzVmssIPConfig -ApplicationGatewayBackendAddressPoolsId /subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}/backendAddressPools/{applicationGatewayBackendAddressPoolName} -SubnetId $vmss.VirtualMachineProfile.NetworkProfile.NetworkInterfaceConfigurations[0].IpConfigurations[0].Subnet.Id -Name $vmss.VirtualMachineProfile.NetworkProfile.NetworkInterfaceConfigurations[0].IpConfigurations[0].Name

# Replace the existing IP configuration in the local PowerShell object (which contains the references to the current Azure Load Balancer) with the new IP configuration
$vmss.VirtualMachineProfile.NetworkProfile.NetworkInterfaceConfigurations[0].IpConfigurations[0] = $ipconf

# Update the model of the scale set with the new configuration in the local PowerShell object
Update-AzVmss -ResourceGroupName "myResourceGroup" -Name "myScaleSet" -virtualMachineScaleSet $vmss

Azure CLI:

# Remove the load balancer backend pool from the scale set model
az vmss update --resource-group myResourceGroup --name myScaleSet --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 myResourceGroup --name myScaleSet --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 myResourceGroup --name myScaleSet --add virtualMachineProfile.networkProfile.networkInterfaceConfigurations[0].ipConfigurations[0].ApplicationGatewayBackendAddressPools '{"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Network/applicationGateways/{applicationGatewayName}/backendAddressPools/{applicationGatewayBackendPoolName}"}'

Примечание.

Эти команды предполагают наличие только одной конфигурации IP и балансировщика нагрузки в масштабируемом наборе. Если их несколько, может потребоваться использовать индекс списка, отличный от 0.

Следующие шаги

Общие задачи управления масштабируемыми наборами можно также выполнять с помощью Azure CLI или Azure PowerShell.

Изменение масштабируемого набора виртуальных машин

Базовые понятия

Модель масштабируемого набора

Представление экземпляра масштабируемого набора

Представление модели виртуальной машины масштабируемого набора

Представление экземпляра виртуальной машины в масштабируемом наборе

Как обновлять глобальные свойства масштабируемого набора

Свойства с ограничениями на изменение

Свойства времени создания

Свойства, которые можно изменить только на основе текущего значения

Пример 1

Пример 2

Свойства, для изменения которых требуется освободить виртуальные машины

Обновления отдельных виртуальных машин

Сценарии

Обновления приложений

обновления ОС;

Примеры

Обновление образа ОС масштабируемого набора

Обновление подсистемы балансировки нагрузки масштабируемого набора

Следующие шаги

Дополнительные ресурсы