チュートリアル: Azure CLI を使用して仮想マシンスケールセットを変更する

2025-04-06

アプリケーションのライフサイクルを通して、仮想マシンスケールセットを変更したり更新したりすることが必要になる場合があります。スケールセットの構成を更新したりアプリケーションの構成を変更したりする際の方法が、こうした更新の対象になることもあります。この記事では、Azure CLI を使用して既存のスケールセットを変更する方法について説明します。

以下では、このドキュメント全体で使用される環境変数を宣言します。デプロイごとに一意である必要があるリソース名には、ランダムなサフィックスが追加されます。 REGIONは WestUS2 に設定されています。

リソースグループのセットアップ

先に進む前に、リソースグループが存在することを確認します。この手順では、リソースグループがまだ存在しない場合は作成します。

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

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

仮想マシンスケールセットを作成する

後続の更新コマンドとクエリコマンドに有効なリソースを使用できるようにするには、仮想マシンスケールセットを作成します。この手順では、有効なイメージ (Ubuntu2204) を使用して基本的なスケールセットをデプロイし、インスタンス固有の更新プログラムが既存のインスタンス ID をターゲットにできるように、インスタンス数を 5 に設定します。

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": "WestUS2",
  "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": "WestUS2",
  "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 のインスタンス保護ポリシーの更新などです。許可されているライセンスの種類の値は 、Windows_ServerではなくRHEL_BYOS されることに注意 してください。

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 Community Hub」を参照してください

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": "WestUS2",
  "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
      }
    ]
  }
}

スケールセットにインスタンスを追加する

スケールセットに新しい VM を追加したいが、スケールセットモデルに記載されているものとは異なる構成オプションが必要な場合があります。 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": "WestUS2",
  "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 WestUS2
myScaleSet_Instance1  myResourceGroupxxx WestUS2
myScaleSet_Instance1  myResourceGroupxxx WestUS2

スケールセットを再イメージ化する

Virtual Machine Scale Sets では、スケールセット内の各 VM に対して一意の名前が生成されます。名前付け規則は、オーケストレーションモードによって異なります。

フレキシブルオーケストレーションモード: {scale-set-name}_{8-char-guid}
均一オーケストレーションモード: {scale-set-name}_{instance-id}

特定のインスタンスを再イメージ化する必要がある場合は、 az vmss reimage を使用してインスタンス ID を指定します。もう 1 つのオプションは、 az vm redeploy を使用して VM を直接再イメージ化することです。このコマンドは、インスタンス ID を指定せずに VM を再イメージ化する場合に便利です。

# 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 のドキュメントをご覧ください)。

注意

プラットフォームイメージでは、イメージ参照バージョンに "最新" を指定することが一般的です。作成、スケールアウト、再イメージ化を行うと、VM が使用可能な最新バージョンで作成されます。ただし、新しいイメージバージョンがリリースされたときに OS イメージが自動的に更新されることは意味しません。別の機能によって、OS の自動更新が提供されます。詳しくは、OS アップグレードのドキュメントをご覧ください。

カスタムイメージを使用している場合は、imageReference ID を更新してイメージを更新することができます (詳しくは、REST API のドキュメントをご覧ください)。

スケールセットのロードバランサーの更新

Azure Load Balancer を使用するスケールセットがあり、Azure Load Balancer を Azure Application Gateway で置換するとします。スケールセットのロードバランサーと Application Gateway のプロパティは一覧に含まれるため、プロパティを直接変更する代わりに一覧の要素を削除または追加するコマンドを使用できます。

# 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 構成とロードバランサーが 1 つだけであると想定されます。複数ある場合は、0 以外のリストインデックスを使用する必要があります。

次のステップ

このチュートリアルでは、スケールセットと個々のインスタンスのさまざまな側面を変更する方法について学習しました。

スケールセットモデルを更新する
スケールセット内の個々の VM インスタンスを更新する
スケールセットにインスタンスを追加する
最新のスケールセットモデルで VM を最新の状態にする
スケールセットを再イメージ化する
スケールセットの OS イメージの更新
スケールセットのロードバランサーの更新

スケールセットでデータディスクを使用する

次の方法で共有

チュートリアル: Azure CLI を使用して仮想マシン スケール セットを変更する

リソース グループのセットアップ

仮想マシン スケール セットを作成する

スケール セット モデルを更新する

スケール セット内の個々の VM インスタンスを更新する

スケール セットにインスタンスを追加する

最新のスケール セット モデルで VM を最新の状態にする

スケール セットを再イメージ化する

スケール セットの OS イメージの更新

スケール セットのロード バランサーの更新