ClusterUpgradeDescriptionObject

Represents a ServiceFabric cluster upgrade

Properties

Name Type Required
ConfigVersion string No
CodeVersion string No
UpgradeKind string (enum) No
RollingUpgradeMode string (enum) No
UpgradeReplicaSetCheckTimeoutInSeconds integer (int64) No
ForceRestart boolean No
EnableDeltaHealthEvaluation boolean No
MonitoringPolicy MonitoringPolicyDescription No
ClusterHealthPolicy ClusterHealthPolicy No
ClusterUpgradeHealthPolicy ClusterUpgradeHealthPolicyObject No
ApplicationHealthPolicyMap array of ApplicationHealthPolicyMapItem No

ConfigVersion

Type: string
Required: No

The cluster configuration version (specified in the cluster manifest).


CodeVersion

Type: string
Required: No

The ServiceFabric code version of the cluster.


UpgradeKind

Type: string (enum)
Required: No
Default: Rolling

The kind of upgrade out of the following possible values.

Possible values are:

  • Invalid - Indicates the upgrade kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero.
  • Rolling - The upgrade progresses one upgrade domain at a time. The value is 1

RollingUpgradeMode

Type: string (enum)
Required: No
Default: UnmonitoredAuto

The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored.

Possible values are:

  • Invalid - Indicates the upgrade mode is invalid. All Service Fabric enumerations have the invalid type. The value is zero.
  • UnmonitoredAuto - The upgrade will proceed automatically without performing any health monitoring. The value is 1
  • UnmonitoredManual - The upgrade will stop after completing each upgrade domain, giving the opportunity to manually monitor health before proceeding. The value is 2
  • Monitored - The upgrade will stop after completing each upgrade domain and automatically monitor health before proceeding. The value is 3

UpgradeReplicaSetCheckTimeoutInSeconds

Type: integer (int64)
Required: No

The maximum amount of time to block processing of an upgrade domain and prevent loss of availability when there are unexpected issues. When this timeout expires, processing of the upgrade domain will proceed regardless of availability loss issues. The timeout is reset at the start of each upgrade domain. Valid values are between 0 and 42949672925 inclusive. (unsigned 32-bit integer).


ForceRestart

Type: boolean
Required: No

If true, then processes are forcefully restarted during upgrade even when the code version has not changed (the upgrade only changes configuration or data).


EnableDeltaHealthEvaluation

Type: boolean
Required: No

When true, enables delta health evaluation rather than absolute health evaluation after completion of each upgrade domain.


MonitoringPolicy

Type: MonitoringPolicyDescription
Required: No

Describes the parameters for monitoring an upgrade in Monitored mode.


ClusterHealthPolicy

Type: ClusterHealthPolicy
Required: No

Defines a health policy used to evaluate the health of the cluster or of a cluster node.


ClusterUpgradeHealthPolicy

Type: ClusterUpgradeHealthPolicyObject
Required: No

Defines a health policy used to evaluate the health of the cluster during a cluster upgrade.


ApplicationHealthPolicyMap

Type: array of ApplicationHealthPolicyMapItem
Required: No

Defines a map that contains specific application health policies for different applications. Each entry specifies as key the application name and as value an ApplicationHealthPolicy used to evaluate the application health. If an application is not specified in the map, the application health evaluation uses the ApplicationHealthPolicy found in its application manifest or the default application health policy (if no health policy is defined in the manifest). The map is empty by default.