你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

在虚拟机规模集中对扩展预配进行排序

Azure 虚拟机扩展提供部署后配置和管理、监视、安全性等功能。 生产部署通常结合使用为 VM 实例配置的多个扩展来实现所需效果。

在虚拟机上使用多个扩展时,请务必确保需要相同 OS 资源的扩展并未尝试同时获取这些资源。 一些扩展还依赖其他扩展来提供所需配置,如环境设置和机密。 如果排序不正确,依赖扩展部署可能会失败。

本文详细介绍了如何在虚拟机规模集中对要为 VM 实例配置的扩展进行排序。

先决条件

本文假定你熟悉以下内容:

何时使用扩展排序

不强制对规模集执行扩展排序;除非另有指定,否则可以在规模集实例上按任意顺序预配扩展。

例如,如果规模集模型中有两个指定的扩展(扩展 A 和扩展 B),可能会出现以下两种预配顺序之一:

  • 扩展 A -> 扩展 B
  • 扩展 B -> 扩展 A

如果应用程序要求扩展 A 始终先于扩展 B 预配,应使用本文中所述的扩展排序。 使用扩展排序后,现在只会出现以下一种顺序:

  • 扩展 A -> 扩展 B

任何未指定定义的预配顺序的扩展都可以随时预配(包括定义的顺序之前、之后或期间)。 扩展排序仅指定一个特定扩展在另一个特定扩展之后预配。 它不影响模型中定义的其他任何扩展的预配。

例如,如果规模集模型中有三个指定的扩展(扩展 A、扩展 B 和扩展 C),并且扩展 C 设置为在扩展 A 之后预配,可能会出现以下三种预配顺序之一:

  • 扩展 A -> 扩展 C -> 扩展 B
  • 扩展 B -> 扩展 A -> 扩展 C
  • 扩展 A -> 扩展 B -> 扩展 C

如果需要确保在执行定义的扩展顺序时不预配其他任何扩展,建议对规模集模型中的所有扩展进行排序。 在上面的示例中,可以将扩展 B 设置为在扩展 C 之后预配,这样就只能出现以下一种顺序:

  • 扩展 A -> 扩展 C -> 扩展 B

如何使用扩展排序

若要对扩展预配进行排序,必须将规模集模型中的扩展定义更新为,包括接受扩展名数组的属性“provisionAfterExtensions”。 必须在规模集模型中完全定义属性数组值中提到的扩展。

模板部署

下面的示例定义了一个模板,其中规模集有三个扩展(扩展 A、扩展 B 和扩展 C),这样扩展就能按以下顺序预配:

  • 扩展 A -> 扩展 B -> 扩展 C
"virtualMachineProfile": {
  "extensionProfile": {
    "extensions": [
      {
        "name": "ExtensionA",
        "properties": {
          "publisher": "ExtensionA.Publisher",
          "settings": {},
          "typeHandlerVersion": "1.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionA"
        }
      },
      {
        "name": "ExtensionB",
        "properties": {
          "provisionAfterExtensions": [
            "ExtensionA"
          ],
          "publisher": "ExtensionB.Publisher",
          "settings": {},
          "typeHandlerVersion": "2.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionB"
        }
      }, 
      {
        "name": "ExtensionC",
        "properties": {
          "provisionAfterExtensions": [
            "ExtensionB"
          ],
          "publisher": "ExtensionC.Publisher",
          "settings": {},
          "typeHandlerVersion": "3.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionC"                   
        }
      }
    ]
  }
}

由于属性“provisionAfterExtensions”接受扩展名数组,因此可以将上面的示例修改为,扩展 C 在扩展 A 和扩展 B 之后预配,但无需对扩展 A 和扩展 B 进行排序。 以下模板可用于实现此方案:

"virtualMachineProfile": {
  "extensionProfile": {
    "extensions": [
      {
        "name": "ExtensionA",
        "properties": {
          "publisher": "ExtensionA.Publisher",
          "settings": {},
          "typeHandlerVersion": "1.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionA"
        }
      },
      {
        "name": "ExtensionB",
        "properties": {
          "publisher": "ExtensionB.Publisher",
          "settings": {},
          "typeHandlerVersion": "2.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionB"
        }
      }, 
      {
        "name": "ExtensionC",
        "properties": {
          "provisionAfterExtensions": [
            "ExtensionA","ExtensionB"
          ],
          "publisher": "ExtensionC.Publisher",
          "settings": {},
          "typeHandlerVersion": "3.0",
          "autoUpgradeMinorVersion": true,
          "type": "ExtensionC"                   
        }
      }
    ]
  }
}

REST API

下面的示例将名为“扩展 C”的新扩展添加到规模集模型中。 扩展 C 依赖扩展 A 和扩展 B,这些扩展已在规模集模型中定义。

PUT on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/ExtensionC?api-version=2018-10-01`
{ 
  "name": "ExtensionC",
  "properties": {
    "provisionAfterExtensions": [
      "ExtensionA","ExtensionB"
    ],
    "publisher": "ExtensionC.Publisher",
    "settings": {},
    "typeHandlerVersion": "3.0",
    "autoUpgradeMinorVersion": true,
    "type": "ExtensionC" 
  }                  
}

如果规模集模型中之前已定义扩展 C,并且现在要添加它的依赖项,可以执行 PATCH 来编辑已部署的扩展属性。

PATCH on `/subscriptions/subscription_id/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myScaleSet/extensions/ExtensionC?api-version=2018-10-01`
{ 
  "properties": {
    "provisionAfterExtensions": [
      "ExtensionA","ExtensionB"
    ]
  }                  
}

对现有规模集实例的更改在下一次升级时应用。

Azure PowerShell

使用 Add-AzVmssExtension cmdlet 将应用程序运行状况扩展添加到规模集模型定义中。 必须使用 Az PowerShell 1.2.0 或更高版本,才能执行扩展排序。

下面的示例将应用程序运行状况扩展添加到 extensionProfile(位于基于 Windows 的规模集的规模集模型中)。 应用程序运行状况扩展在规模集中已定义的自定义脚本扩展后预配。

# 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" `
  -ProvisionAfterExtension "CustomScriptExtension" `
  -AutoUpgradeMinorVersion $True

# Update the scale set
Update-AzVmss -ResourceGroupName $vmScaleSetResourceGroup `
  -Name $vmScaleSetName `
  -VirtualMachineScaleSet $vmScaleSet

Azure CLI 2.0

使用 az vmss 扩展集将应用程序运行状况扩展添加到规模集模型定义中。 必须使用 Azure CLI 2.0.55 或更高版本,才能执行扩展排序。

下面的示例将应用程序运行状况扩展添加到基于 Windows 的规模集的规模集模型中。 应用程序运行状况扩展在规模集中已定义的自定义脚本扩展后预配。

az vmss extension set \
  --name ApplicationHealthWindows \
  --publisher Microsoft.ManagedServices \
  --version 1.0 \
  --resource-group <myVMScaleSetResourceGroup> \
  --vmss-name <myVMScaleSet> \
  --provision-after-extensions CustomScriptExtension \
  --settings ./extension.json

疑难解答

无法添加有依赖项的扩展?

  1. 请确保 provisionAfterExtensions 中指定的扩展已在规模集模型中定义。
  2. 请确保未引入循环依赖。 例如,禁止使用以下顺序:扩展 A -> 扩展 B -> 扩展 C -> 扩展 A
  3. 请确保所依赖的任何扩展在扩展“属性”下有“设置”属性。 例如,如果需要在扩展 A 之后预配扩展 B,扩展 A 必须在扩展 A“属性”下有“设置”字段。 如果扩展不强制要求任何必需设置,可以指定空的“设置”属性。

无法删除扩展?

请确保要删除的扩展未在其他任何扩展的 provisionAfterExtensions 下列出。

后续步骤

了解如何在虚拟机规模集上部署应用程序