Virtual Machine Scale Sets에 애플리케이션 상태 확장 사용

다음 예제에서는 Windows 기반 확장 집합의 확장 집합 모델에서 myHealthExtension이라는 애플리케이션 상태 확장을 extensionProfile에 추가합니다.

이 예를 사용하면 PUT 대신 PATCH 호출을 수행하여 기존 확장을 리치 성능 상태에서 이진 성능 상태로 변경할 수도 있습니다.

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/myHealthExtension?api-version=2018-10-01`

{
  "name": "myHealthExtension",
  "location": "<location>", 
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "1.0",
    "settings": {
      "protocol": "<protocol>",
      "port": <port>,
      "requestPath": "</requestPath>"
    }
  }
}

이미 배포된 확장을 편집하려면 PATCH를 사용합니다.

VM을 업그레이드하여 확장을 설치합니다.

POST on `/subscriptions/<subscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/< myScaleSet >/manualupgrade?api-version=2022-08-01`

{
  "instanceIds": ["*"]
}

Add-AzVmssExtension cmdlet을 사용하여 애플리케이션 상태 확장을 확장 집합 모델 정의에 추가합니다.

업데이트 확장 기능은 현재 PowerShell에서 사용할 수 없습니다. 이진 성능 상태와 리치 성능 상태 간에 전환하려면 Azure CLI 또는 REST API 명령을 사용하여 확장 버전을 업데이트할 수 있습니다.

다음 예제에서는 Windows 기반 확장 집합의 확장 집합 모델에서 애플리케이션 상태 확장을 extensionProfile에 추가합니다. 이 예제에서는 새 Az PowerShell 모듈을 사용합니다.

# Define the scale set variables
$vmScaleSetName = "myVMScaleSet"
$vmScaleSetResourceGroup = "myVMScaleSetResourceGroup"

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"};
$extensionName = "myHealthExtension"
$extensionType = "ApplicationHealthWindows"
$publisher = "Microsoft.ManagedServices"

# Get the scale set object
$vmScaleSet = Get-AzVmss `
  -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName

# Add the Application Health extension to the scale set model
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet `
  -Name $extensionName `
  -Publisher $publisher `
  -Setting $publicConfig `
  -Type $extensionType `
  -TypeHandlerVersion "1.0" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet
  
# Upgrade instances to install the extension
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName `
  -InstanceId '*'

az vmss extension set를 사용하여 애플리케이션 상태 확장을 확장 집합 모델 정의에 추가합니다.

다음 예제에서는 Linux 기반 확장 집합의 확장 집합 모델에 애플리케이션 상태 확장을 추가합니다.

이 예를 사용하여 기존 확장을 리치 성능 상태에서 이진 성능 상태로 변경할 수도 있습니다.

az vmss extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 1.0 \
  --resource-group <myVMScaleSetResourceGroup> \
  --vmss-name <myVMScaleSet> \
  --settings ./extension.json

extension.json 파일의 콘텐츠입니다.

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>"
}

VM을 업그레이드하여 확장을 설치합니다.

az vmss update-instances \
  --resource-group <myVMScaleSetResourceGroup> \
  --name <myVMScaleSet> \
  --instance-ids "*"

다음 예에서는 Windows 기반 확장 집합의 확장 집합 모델에 있는 extensionProfile에 애플리케이션 상태 - 리치 상태 확장(myHealthExtension으로 이름 지정)을 추가합니다.

이 예를 사용하면 PUT 대신 PATCH 호출을 수행하여 기존 확장을 이진에서 리치 성능 상태로 업그레이드할 수도 있습니다.

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/myHealthExtension?api-version=2018-10-01`

{
  "name": "myHealthExtension",
  "location": "<location>",
  "properties": {
    "publisher": "Microsoft.ManagedServices",
    "type": "ApplicationHealthWindows",
    "autoUpgradeMinorVersion": true,
    "typeHandlerVersion": "2.0",
    "settings": {
      "protocol": "<protocol>",
      "port": <port>,
      "requestPath": "</requestPath>",
      "intervalInSeconds": <intervalInSeconds>,
      "numberOfProbes": <numberOfProbes>,
      "gracePeriod": <gracePeriod>
    }
  }
}

이미 배포된 확장을 편집하려면 PATCH를 사용합니다.

VM을 업그레이드하여 확장을 설치합니다.

POST on `/subscriptions/<subscriptionId>/resourceGroups/<myResourceGroup>/providers/Microsoft.Compute/virtualMachineScaleSets/< myScaleSet >/manualupgrade?api-version=2022-08-01`

{
  "instanceIds": ["*"]
}

Add-AzVmssExtension cmdlet을 사용하여 애플리케이션 상태 확장을 확장 집합 모델 정의에 추가합니다.

업데이트 확장 기능은 현재 PowerShell에서 사용할 수 없습니다. 이진 성능 상태와 리치 성능 상태 간에 전환하려면 Azure CLI 또는 REST API 명령을 사용하여 확장 버전을 업데이트할 수 있습니다.

다음 예에서는 Windows 기반 확장 집합의 확장 집합 모델에 있는 extensionProfile에 애플리케이션 상태 - 리치 상태 확장을 추가합니다. 이 예제에서는 새 Az PowerShell 모듈을 사용합니다.

# Define the scale set variables
$vmScaleSetName = "myVMScaleSet"
$vmScaleSetResourceGroup = "myVMScaleSetResourceGroup"

# Define the Application Health extension properties
$publicConfig = @{"protocol" = "http"; "port" = 80; "requestPath" = "/healthEndpoint"; "gracePeriod" = 600};
$extensionName = "myHealthExtension"
$extensionType = "ApplicationHealthWindows"
$publisher = "Microsoft.ManagedServices"

# Get the scale set object
$vmScaleSet = Get-AzVmss `
  -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName

# Add the Application Health extension to the scale set model
Add-AzVmssExtension -VirtualMachineScaleSet $vmScaleSet `
  -Name $extensionName `
  -Publisher $publisher `
  -Setting $publicConfig `
  -Type $extensionType `
  -TypeHandlerVersion "2.0" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet
  
# Upgrade instances to install the extension
Update-AzVmssInstance -ResourceGroupName $vmScaleSetResourceGroup `
  -VMScaleSetName $vmScaleSetName `
  -InstanceId '*'

az vmss extension set를 사용하여 애플리케이션 상태 확장을 확장 집합 모델 정의에 추가합니다.

다음 예에서는 Linux 기반 확장 집합의 확장 집합 모델에 애플리케이션 상태 - 리치 상태 확장을 추가합니다.

이 예를 사용하여 기존 확장을 이진에서 리치 성능 상태로 업그레이드할 수도 있습니다.

az vmss extension set \
  --name ApplicationHealthLinux \
  --publisher Microsoft.ManagedServices \
  --version 2.0 \
  --resource-group <myVMScaleSetResourceGroup> \
  --vmss-name <myVMScaleSet> \
  --settings ./extension.json

extension.json 파일의 콘텐츠입니다.

{
  "protocol": "<protocol>",
  "port": <port>,
  "requestPath": "</requestPath>",
  "gracePeriod": <healthExtensionGracePeriod>
}

VM을 업그레이드하여 확장을 설치합니다.

az vmss update-instances \
  --resource-group <myVMScaleSetResourceGroup> \
  --name <myVMScaleSet> \
  --instance-ids "*"