扩展或缩减集群

警告

在缩放之前阅读此部分

要缩放计算资源来满足你的应用程序工作负载，需要实施有目的性的计划，此操作在生产环境中总是需要几乎一个多小时才能完成，而且你还要对你的工作负载和业务环境了如指掌。事实上，如果从未执行过此操作，建议在继续本文档其余部分之前，首先阅读并理解 Service Fabric 群集容量规划注意事项。该项建议的目的是避免出现意外的LiveSite问题；此外，建议在非生产环境中成功地测试你决定执行的操作。可随时报告生产问题或请求 Azure 付费支持。对于被分配根据适当情况执行这些操作的工程师，请参考本文了解缩放操作。但是，你必须决定并了解哪些操作适合你的情况，例如要缩放哪些资源（CPU、存储、内存）、按哪个方向进行缩放方向（垂直或水平），以及要执行哪些操作（资源模板部署、门户、PowerShell/CLI）。

注意

建议使用 Azure Az PowerShell 模块与 Azure 交互。若要开始，请参阅安装 Azure PowerShell。若要了解如何迁移到 Az PowerShell 模块，请参阅将 Azure PowerShell 从 AzureRM 迁移到 Az。

使用自动缩放规则或手动横向扩展 Service Fabric 群集

虚拟机规模集是一种 Azure 计算资源，可用于将一组虚拟机作为一个集进行部署和管理。在 Service Fabric 群集中定义的每个节点类型将设置为不同的虚拟机规模集。然后，每个节点类型可以独立缩减或扩展、打开不同的端口集，并可以有不同的容量指标。可在 Service Fabric 节点类型文档中了解有关详细信息。由于群集中的 Service Fabric 节点类型由后端的虚拟机规模集组成，需要为每个节点类型/虚拟机规模集设置自动缩放规则。

注意

订阅必须有足够的核心用于添加构成此群集的新 VM。目前没有模型验证，因此如果达到任何配额限制，则会出现部署时间失败。

注意

如果将启用了 Hyper-V 角色的 Windows OS 映像（即 VM 配置为嵌套虚拟化），则可用内存指标将不可用，因为 VM 中的动态内存驱动程序将处于停止状态。

选择要缩放的节点类型/虚拟机规模集

目前，无法使用门户为虚拟机规模集指定自动缩放规则来创建 Service Fabric 群集，因此让我们使用 Azure PowerShell（1.0+）列出节点类型，然后将自动缩放规则添加到它们。

若要获取构成群集的虚拟机规模集的列表，请运行以下 cmdlet：

Get-AzResource -ResourceGroupName <RGname> -ResourceType Microsoft.Compute/VirtualMachineScaleSets

Get-AzVmss -ResourceGroupName <RGname> -VMScaleSetName <virtual machine scale set name>

为节点类型/虚拟机规模集设置自动缩放规则

如果群集具有多个节点类型，请为要缩放（扩展或缩减）的每个节点类型/虚拟机规模集重复此操作。考虑在设置自动缩放之前必须拥有的节点数。对于主节点类型所必须具有的最小节点数受所选择的可靠性级别影响。了解有关可靠性级别的详细信息。

注意

在主节点类型的扩展至低于最小数量时，会使群集不稳定，甚至导致群集停机。这可能会对应用程序和系统服务造成数据丢失。

目前，自动缩放功能不是由应用程序可能向 Service Fabric 报告的负载驱动。因此，此时，你获取的自动缩放完全由每个虚拟机规模集实例发出的性能计数器驱动。

按照以下说明为每个虚拟机规模集设置自动缩放。

注意

在缩容场景中，除非节点类型具有金级或银级持续性级别，否则需要使用相应节点名称来调用 Remove-ServiceFabricNodeState cmdlet。对于铜级耐用性，不建议同时缩减多个节点。

手动将 VM 添加到节点类型/虚拟机规模集

横向扩展时，会添加更多虚拟机实例到规模集。这些实例成为 Service Fabric 使用的节点。 Service Fabric 知道规模集什么时候添加了更多实例（通过扩大实现）并自动做出反应。

注意

添加 VM 需要时间，请不要期待马上就有结果。请提前规划增加容量的时间，在副本/服务实例可以使用 VM 容量之前留出超过 10 分钟的时间让一切就绪。

使用模板添加 VM

根据快速入门模板库中的示例/说明更改每个节点类型的 VM 数目。

使用 PowerShell 或 CLI 命令添加 VM

以下代码通过名称获取指定的规模集，并使该规模集的容量增加 1。

$scaleset = Get-AzVmss -ResourceGroupName SFCLUSTERTUTORIALGROUP -VMScaleSetName nt1vm
$scaleset.Sku.Capacity += 1

Update-AzVmss -ResourceGroupName $scaleset.ResourceGroupName -VMScaleSetName $scaleset.Name -VirtualMachineScaleSet $scaleset

此代码将容量设为 6。

# Get the name of the node with
az vmss list-instances -n nt1vm -g sfclustertutorialgroup --query [*].name

# Use the name to scale
az vmss scale -g sfclustertutorialgroup -n nt1vm --new-capacity 6

手动从节点类型/虚拟机规模集中删除 VM

按节点类型进行缩放时，将从规模集中删除 VM 实例。如果节点类型为“铜”持续性级别，Service Fabric 将不知道发生了什么情况，因此会报告节点已丢失。然后 Service Fabric 将报告群集的不正常状态。若要防止状态错误，必须从群集中显式删除节点并删除节点状态。

Service Fabric 系统服务在群集中以主节点类型运行。缩减主节点类型实例数量时，切勿少于可靠性层所需的数目。

对于有状态服务，需要一些节点始终处于活动状态，以保持可用性，并维持服务的状态。至少需要与分区/服务的目标副本数量相等的节点数目。

删除 Service Fabric 节点

手动删除节点状态的步骤仅适用于具有“青铜”耐久性层级的节点类型。对于“白银”和“黄金”持续性层，平台会自动完成上述步骤。有关持续性的详细信息，请参阅 Service Fabric 群集容量规划。

注意

为任何已启用“黄金”或“白银”耐久性级别的虚拟机规模集保留至少五个节点。如果横向缩减到此阈值以下，群集会进入错误状态，需要手动清除已删除的节点。

为了使群集节点均匀地分布在升级域和容错域中，从而使它们的利用均匀，应该首先删除最近创建的节点。换句话说，应该按照创建节点的相反顺序删除节点。最近创建的节点是具有最大 virtual machine scale set InstanceId 属性值的节点。下面的代码示例返回最近创建的节点。

Get-ServiceFabricNode | Sort-Object NodeInstanceId -Descending | Select-Object -First 1

sfctl node list --query "sort_by(items[*], &name)[-1]"

Service Fabric 群集需要了解此节点将被删除。需要执行以下三个步骤：

禁用节点，使其不再作为数据的复制节点。
PowerShell：Disable-ServiceFabricNode
sfctl：sfctl node disable
停止节点，以便 Service Fabric 运行时能够干净地关闭，并且您的应用程序收到终止请求。
PowerShell：Start-ServiceFabricNodeTransition -Stop
sfctl：sfctl node transition --node-transition-type Stop
从群集移除节点。
PowerShell：Remove-ServiceFabricNodeState
sfctl：sfctl node remove-state

对节点执行这三个步骤后，即可将其从规模集中移除。如果使用铜以外的耐用性层，在移除规模集实例时，这些步骤会被自动完成。

以下代码块获取最近创建的节点，禁用、停止并将节点从群集中移除。

#### After you've connected.....
# Get the node that was created last
$node = Get-ServiceFabricNode | Sort-Object { $_.NodeName.Substring($_.NodeName.LastIndexOf('_') + 1) } -Descending | Select-Object -First 1

# Node details for the disable/stop process
$nodename = $node.NodeName
$nodeid = $node.NodeInstanceId

$loopTimeout = 10

# Run disable logic
Disable-ServiceFabricNode -NodeName $nodename -Intent RemoveNode -TimeoutSec 300 -Force

$state = Get-ServiceFabricNode | Where-Object NodeName -eq $nodename | Select-Object -ExpandProperty NodeStatus

while (($state -ne [System.Fabric.Query.NodeStatus]::Disabled) -and ($loopTimeout -ne 0))
{
    Start-Sleep 5
    $loopTimeout -= 1
    $state = Get-ServiceFabricNode | Where-Object NodeName -eq $nodename | Select-Object -ExpandProperty NodeStatus
    Write-Host "Checking state... $state found"
}

# Exit if the node was unable to be disabled
if ($state -ne [System.Fabric.Query.NodeStatus]::Disabled)
{
    Write-Error "Disable failed with state $state"
}
else
{
    # Stop node
    $stopid = New-Guid
    Start-ServiceFabricNodeTransition -Stop -OperationId $stopid -NodeName $nodename -NodeInstanceId $nodeid -StopDurationInSeconds 300

    $state = (Get-ServiceFabricNodeTransitionProgress -OperationId $stopid).State
    $loopTimeout = 10

    # Watch the transaction
    while (($state -eq [System.Fabric.TestCommandProgressState]::Running) -and ($loopTimeout -ne 0))
    {
        Start-Sleep 5
        $state = (Get-ServiceFabricNodeTransitionProgress -OperationId $stopid).State
        Write-Host "Checking state... $state found"
    }

    if ($state -ne [System.Fabric.TestCommandProgressState]::Completed)
    {
        Write-Error "Stop transaction failed with $state"
    }
    else
    {
        # Remove the node from the cluster
        Remove-ServiceFabricNodeState -NodeName $nodename -TimeoutSec 300 -Force
    }
}

在下面的sfctl代码中，使用以下命令获取最近创建的节点的node-name值：sfctl node list --query "sort_by(items[*], &name)[-1].name"

# Inform the node that it is going to be removed
sfctl node disable --node-name _nt1vm_5 --deactivation-intent 4 -t 300

# Stop the node using a random guid as our operation id
sfctl node transition --node-instance-id 131541348482680775 --node-name _nt1vm_5 --node-transition-type Stop --operation-id c17bb4c5-9f6c-4eef-950f-3d03e1fef6fc --stop-duration-in-seconds 14400 -t 300

# Remove the node from the cluster
sfctl node remove-state --node-name _nt1vm_5

提示

使用以下 sfctl 查询以检查每个步骤的状态。

检查停用状态sfctl node list --query "sort_by(items[*], &name)[-1].nodeDeactivationInfo"

检查停止状态sfctl node list --query "sort_by(items[*], &name)[-1].isStopped"

在规模集中进行缩放

将 Service Fabric 节点从群集中删除后，即可缩小虚拟机规模集。在下面的示例中，规模集容量缩小了 1。

$scaleset = Get-AzVmss -ResourceGroupName SFCLUSTERTUTORIALGROUP -VMScaleSetName nt1vm
$scaleset.Sku.Capacity -= 1

Update-AzVmss -ResourceGroupName SFCLUSTERTUTORIALGROUP -VMScaleSetName nt1vm -VirtualMachineScaleSet $scaleset

此代码将容量设为 5。

# Get the name of the node with
az vmss list-instances -n nt1vm -g sfclustertutorialgroup --query [*].name

# Use the name to scale
az vmss scale -g sfclustertutorialgroup -n nt1vm --new-capacity 5

在 Service Fabric Explorer 中可能观察到的行为

当您扩展群集时，Service Fabric Explorer 将会反映属于群集一部分的节点（虚拟机规模集中的实例）数。但是在缩减群集时，会看到已删除的节点/VM 实例显示为不正常状态，除非使用相应节点名称来调用 Remove-ServiceFabricNodeState cmd。

下面是此行为的说明。

Service Fabric Explorer 中列出的节点反映了 Service Fabric 系统服务（尤其是 FM）对群集过去和现在节点数量的了解。当您收缩虚拟机规模集时，虚拟机已被删除，但 FM 系统服务仍然认为映射到已删除虚拟机的节点仍会恢复。因此 Service Fabric Explorer 会继续显示该节点（尽管运行状况状态可能是错误或未知）。

若要确保在删除虚拟机 (VM) 时也删除节点，有两种选择：

为群集中的节点类型选择金级或银级的可靠性级别，这将为您提供基础结构集成。缩容时，节点将自动从我们的系统服务 (FM) 状态中移除。在此处了解有关持续性级别的详细信息

注意

缩减 VM 实例规模后，需要调用 Remove-ServiceFabricNodeState cmdlet。

注意

Service Fabric 群集需要一定数量的节点一直处于启动运行状态，以保持可用性并保留状态，这称为“维护仲裁”。因此，除非先执行了状态的完整备份，否则，关闭群集中所有计算机通常是不安全的。

后续步骤

参阅以下文章以另外了解如何规划群集容量、升级群集以及对服务进行分区：

Last updated on 2026-04-03

Partager via