Service Fabric 应用程序升级:高级主题

在升级应用程序期间添加或删除服务类型

如果在升级过程中向已发布的应用程序添加新的服务类型,则该新的服务类型将添加到已部署的应用程序。 这样的升级不会影响已经是应用程序一部分的任何服务实例,但是,必须创建所添加的服务类型的实例,新的服务类型才会处于活动状态(请参阅 New-ServiceFabricService)。

类似地,在升级过程中还可以从应用程序中删除服务类型。 但是,必须删除待删除服务类型的所有服务实例,然后才能继续进行升级(请参阅 Remove-ServiceFabricService)。

避免在无状态服务计划内停机期间断开连接

对于计划内无状态实例停机(例如,应用程序/群集升级或节点停用),由于实例关闭后公开的终结点被删除,因此连接可能会断开,从而导致强制关闭连接。

为了避免这种情况,请通过在服务配置中添加“实例关闭延迟持续时间”来配置 RequestDrain 功能,以允许来自群集内部的现有请求在公开的终结点上排出 。 这是通过在延迟开始之前删除无状态实例播发的终结点,然后再关闭实例实现的。 此延迟可使现有请求在实例实际关闭之前正常排空。 在开始延迟时,客户端通过回调函数获取有关终结点发生更改的通知,因此它们可以重新解析终结点,并避免向正在停止的实例发送新请求。 这些请求可能源自使用反向代理的客户端,或使用服务终结点解析 API 和通知模型 (ServiceNotificationFilterDescription) 来更新终结点的客户端。

服务配置

可通过多种方式在服务端配置延迟。

  • 创建新服务时指定 -InstanceCloseDelayDuration

    New-ServiceFabricService -Stateless [-ServiceName] <Uri> -InstanceCloseDelayDuration <TimeSpan>
    
  • 在应用程序清单的 defaults 节中定义服务时分配 InstanceCloseDelayDurationSeconds 属性:

          <StatelessService ServiceTypeName="Web1Type" InstanceCount="[Web1_InstanceCount]" InstanceCloseDelayDurationSeconds="15">
              <SingletonPartition />
          </StatelessService>
    
  • 更新现有服务时指定 -InstanceCloseDelayDuration

    Update-ServiceFabricService [-Stateless] [-ServiceName] <Uri> [-InstanceCloseDelayDuration <TimeSpan>]`
    
  • 通过 ARM 模板创建或更新现有服务时,请指定 值(支持的 API 最低版本:2020-03-01):

    {
      "apiVersion": "2020-03-01",
      "type": "Microsoft.ServiceFabric/clusters/applications/services",
      "name": "[concat(parameters('clusterName'), '/', parameters('applicationName'), '/', parameters('serviceName'))]",
      "location": "[variables('clusterLocation')]",
      "dependsOn": [
        "[concat('Microsoft.ServiceFabric/clusters/', parameters('clusterName'), '/applications/', parameters('applicationName'))]"
      ],
      "properties": {
        "provisioningState": "Default",
        "serviceKind": "Stateless",
        "serviceTypeName": "[parameters('serviceTypeName')]",
        "instanceCount": "-1",
        "partitionDescription": {
          "partitionScheme": "Singleton"
        },
        "serviceLoadMetrics": [],
        "servicePlacementPolicies": [],
        "defaultMoveCost": "",
        "instanceCloseDelayDuration": "00:00:30.0"
      }
    }
    

客户端配置

若要在终结点更改后收到通知,客户端应注册回调,请参阅 示例 ServiceNotificationFilterDescription。 如果收到更改通知,则表明终结点已更改,客户端应重新解析终结点,而不要使用不再播发的终结点,因为这些终结点即将关闭。

可选的升级替代方法

除了为每个服务设置默认延迟持续时间以外,还可以使用相同的 (InstanceCloseDelayDurationSec) 选项替代应用程序/群集升级期间的延迟:

Start-ServiceFabricApplicationUpgrade [-ApplicationName] <Uri> [-ApplicationTypeVersion] <String> [-InstanceCloseDelayDurationSec <UInt32>]

Start-ServiceFabricClusterUpgrade [-CodePackageVersion] <String> [-ClusterManifestVersion] <String> [-InstanceCloseDelayDurationSec <UInt32>]

重写的延迟持续时间仅应用于调用的升级实例,而不会更改单个服务延迟配置。 例如,可以使用此方法指定 0 延迟,以跳过任何预配置的升级延迟。

注意

  • 用于排出请求的设置将无法阻止 Azure 负载均衡器将新请求发送到正在进行排出操作的终结点。
  • 基于投诉的解决机制不会导致请求的正常排出,因为它会在发生故障后触发服务解析。 如前所述,应该对其进行增强,以使用 ServiceNotificationFilterDescription 订阅终结点更改通知。
  • 如果升级是无影响升级,即在升级过程中不会关闭副本,则不会遵循这些设置。
  • 可在服务说明中配置的 InstanceCloseDelayDuration 或可在升级说明中配置的 InstanceCloseDelayDurationSec 的最大值不能大于群集配置 FailoverManager MaxInstanceCloseDelayDurationInSeconds,其默认值为 1800 秒。 若要更新最大值,应更新群集级别配置。 此配置仅适用于运行时版本 9.0 或更高版本。

注意

当群集代码版本为 7.1.XXX 或更高版本时,可以如上所述使用 Update-ServiceFabricService cmdlet 或 ARM 模板在现有服务中配置此功能。

手动升级模式

注意

对于所有 Service Fabric 升级,建议使用 Monitored 升级模式。 只有对于失败或暂停的升级,才应考虑使用 UnmonitoredManual 升级模式。

Monitored 模式下,Service Fabric 应用运行状况策略来确保应用程序在升级过程中正常运行。 如果违反了运行状况策略,则升级将暂停或自动回滚,具体取决于指定的 FailureAction

UnmonitoredManual 模式下,应用程序管理员对升级进度具有完全控制权。 当应用自定义运行状况评估策略或执行非常规升级来完全绕过运行状况监视时(例如,当应用程序已经丢失数据时),此模式非常有用。 在此模式下运行的升级在完成每个 UD 后会将其自己暂停,并且必须使用 Resume-ServiceFabricApplicationUpgrade 显式使其继续执行。 当升级暂停并且就绪可供用户继续执行时,其升级状态将显示 RollforwardPending(请参阅 UpgradeState)。

最后,UnmonitoredAuto 模式非常适用于在开发或或测试服务期间执行快速升级迭代,因为不需要提供用户输入并且不会评估应用程序运行状况策略。

使用差异包升级

还可以通过预配仅包含更新后的代码/配置/数据包以及完整的应用程序清单和完整的服务清单的差异包(不需要预配完整的应用程序包)来执行升级。 只有首次将应用程序安装到群集时,才需要完整的应用程序包。 后续升级可以使用完整的应用程序包或差异包执行。

如果差异包的应用程序清单或服务清单中的任何引用无法在应用程序包中找到,则会自动将该引用替换为当前预配的版本。

使用差异包的方案有:

  • 拥有一个引用了多个服务清单文件和/或多个代码包、配置包或数据包的大型应用程序包时。
  • 当部署系统直接在应用程序生成过程中产生生成布局时。 在这种情况下,即使代码未发生任何更改,新生成的程序集也会获得不同的校验和。 使用完整的应用程序包要求更新所有代码包上的版本。 使用差异包时,只需提供更改的文件和其中的版本已更改的清单文件。

如果应用程序是使用 Visual Studio 升级的,则会自动发布差异包。 若要手动创建差异包,必须更新应用程序清单和服务清单,只在最终应用程序包中包含更改的包。

例如,让我们从以下应用程序开始(为便于理解,这里提供了版本号):

app1           1.0.0
  service1     1.0.0
    code       1.0.0
    config     1.0.0
  service2     1.0.0
    code       1.0.0
    config     1.0.0

假设你想要使用差异包仅更新 service1 的代码包。 更新后的应用程序有以下版本更改:

app1           2.0.0      <-- new version
  service1     2.0.0      <-- new version
    code       2.0.0      <-- new version
    config     1.0.0
  service2     1.0.0
    code       1.0.0
    config     1.0.0

在本例中,你将应用程序清单更新为 2.0.0,并更新了 service1 的服务清单来反映代码包更新。 应用程序包的文件夹具有以下结构:

app1/
  service1/
    code/

换句话说,就是照常创建完整的应用程序包,然后删除其版本未更改的任何代码/配置/数据包文件夹。

独立于版本升级应用程序参数

有时,需要更改 Service Fabric 应用程序的参数,而无需更改清单版本。 可以通过将 -ApplicationParameter 标志与 Start-ServiceFabricApplicationUpgrade 一起使用来方便地完成此操作。 假设 Service Fabric 应用程序具有以下属性:

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/Application1

ApplicationName        : fabric:/Application1
ApplicationTypeName    : Application1Type
ApplicationTypeVersion : 1.0.0
ApplicationStatus      : Ready
HealthState            : Ok
ApplicationParameters  : { "ImportantParameter" = "1"; "NewParameter" = "testBefore" }

现在使用 Start-ServiceFabricApplicationUpgrade cmdlet 升级该应用程序。 此示例显示了受监视的升级,但也可以使用不受监视的升级。 若要查看此 cmdlet 接受的标志的完整说明,请参阅 Azure Service Fabric PowerShell 模块参考

PS C:\> $appParams = @{ "ImportantParameter" = "2"; "NewParameter" = "testAfter"}

PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/Application1 -ApplicationTypeVers
ion 1.0.0 -ApplicationParameter $appParams -Monitored

升级后,确认应用程序具有已更新的参数和相同的版本:

PS C:\> Get-ServiceFabricApplication -ApplicationName fabric:/Application1

ApplicationName        : fabric:/Application1
ApplicationTypeName    : Application1Type
ApplicationTypeVersion : 1.0.0
ApplicationStatus      : Ready
HealthState            : Ok
ApplicationParameters  : { "ImportantParameter" = "2"; "NewParameter" = "testAfter" }

回滚应用程序升级

虽然升级可以通过三种模式之一(MonitoredUnmonitoredAutoUnmonitoredManual)进行前滚,但它们只能在 UnmonitoredAutoUnmonitoredManual 模式下进行回滚。 在 UnmonitoredAuto 模式下进行回滚与进行前滚时行为相同,唯一的例外是 UpgradeReplicaSetCheckTimeout 的默认值不同 - 请参阅应用程序升级参数。 在 UnmonitoredManual 模式下进行回滚与进行前滚时行为相同 - 回滚在完成每个 UD 后会将其自己暂停,并且必须使用 Resume-ServiceFabricApplicationUpgrade 显式继续执行回滚。

当违反了在 Monitored 模式下进行的升级的运行状况策略并且 FailureActionRollback 时,可以自动触发回滚(请参阅应用程序升级参数);也可以使用 Start-ServiceFabricApplicationRollback 显式触发回滚。

在回滚期间,可以随时使用 Update-ServiceFabricApplicationUpgrade 更改 UpgradeReplicaSetCheckTimeout 的值和模式。

后续步骤

Upgrading your Application Using Visual Studio (使用 Visual Studio 升级应用程序)逐步讲解了如何使用 Visual Studio 进行应用程序升级。

使用 PowerShell 升级应用程序逐步讲解了如何使用 PowerShell 进行应用程序升级。

使用升级参数来控制应用程序的升级方式。

了解如何使用数据序列化,使应用程序在升级后保持兼容。

参考对应用程序升级进行故障排除中的步骤来解决应用程序升级时的常见问题。