Dela via

ApplicationUpgradeDescription

  • Artikel

Beskriver parametrarna för en programuppgradering. Observera att uppgraderingsbeskrivningen ersätter den befintliga programbeskrivningen. Det innebär att om parametrarna inte anges skrivs de befintliga parametrarna i programmen över med listan med tomma parametrar. Detta skulle resultera i att programmet använder standardvärdet för parametrarna från programmanifestet. Om du inte vill ändra några befintliga parametervärden hämtar du programparametrarna först med hjälp av GetApplicationInfo-frågan och anger sedan dessa värden som parametrar i den här ApplicationUpgradeDescription.

Egenskaper

Namn Typ Obligatorisk
Name sträng Ja
TargetApplicationTypeVersion sträng Ja
Parameters matris med ApplicationParameter No
UpgradeKind sträng (uppräkning) Yes
RollingUpgradeMode sträng (uppräkning) No
UpgradeReplicaSetCheckTimeoutInSeconds heltal (int64) No
ForceRestart boolean No
SortOrder sträng (uppräkning) No
MonitoringPolicy MonitoringPolicyDescription No
ApplicationHealthPolicy ApplicationHealthPolicy No
InstanceCloseDelayDurationInSeconds heltal (int64) No
ManagedApplicationIdentity ManagedApplicationIdentityDescription No

Name

Typ: sträng
Obligatoriskt: Ja

Namnet på målprogrammet, inklusive URI-schemat "fabric:".

TargetApplicationTypeVersion

Typ: sträng
Obligatoriskt: Ja

Målprogrammets typversion (finns i programmanifestet) för programuppgradering.

Parameters

Typ: matris med ApplicationParameter
Obligatoriskt: Nej

Lista över programparametrar med åsidosatta värden från deras standardvärden som anges i programmanifestet.

UpgradeKind

Typ: sträng (uppräkning)
Obligatoriskt: Ja
Standard: Rolling

Typen av uppgradering av följande möjliga värden.

Möjliga värden:

  • Invalid – Anger att uppgraderingstyp är ogiltig. Alla Service Fabric-uppräkningar har den ogiltiga typen. Värdet är noll.
  • Rolling – Uppgraderingen fortsätter med en uppgraderingsdomän i taget. Värdet är 1

RollingUpgradeMode

Typ: sträng (uppräkning)
Obligatoriskt: Nej
Standard: UnmonitoredAuto

Det läge som används för att övervaka hälsotillståndet under en löpande uppgradering. Värdena är UnmonitoredAuto, UnmonitoredManual, Monitored och UnmonitoredDeferred.

Möjliga värden:

  • Invalid – Anger att uppgraderingsläget är ogiltigt. Alla Service Fabric-uppräkningar har den ogiltiga typen. Värdet är noll.
  • UnmonitoredAuto – Uppgraderingen fortsätter automatiskt utan att utföra någon hälsoövervakning. Värdet är 1
  • UnmonitoredManual – Uppgraderingen stoppas när varje uppgraderingsdomän har slutförts, vilket ger möjlighet att manuellt övervaka hälsotillståndet innan du fortsätter. Värdet är 2
  • Monitored – Uppgraderingen stoppas när du har slutfört varje uppgraderingsdomän och övervakar automatiskt hälsotillståndet innan du fortsätter. Värdet är 3
  • UnmonitoredDeferred – Utför en nod-för-nod-uppgradering. Ingen åtgärd utförs när uppgraderingen startar. uppgraderingen tillämpas på varje nod när den inaktiveras med avsikten startas om eller högre. Värdet är 4

UpgradeReplicaSetCheckTimeoutInSeconds

Typ: heltal (int64)
Obligatoriskt: Nej

Den maximala tiden för att blockera bearbetning av en uppgraderingsdomän och förhindra förlust av tillgänglighet när det uppstår oväntade problem. När tidsgränsen går ut fortsätter bearbetningen av uppgraderingsdomänen oavsett problem med tillgänglighetsförlust. Tidsgränsen återställs i början av varje uppgraderingsdomän. Giltiga värden är mellan 0 och 42949672925 inklusive. (osignerat 32-bitars heltal).

ForceRestart

Typ: booleskt
Obligatoriskt: Nej

Om det är sant startas processerna om kraftfullt under uppgraderingen även om kodversionen inte har ändrats (uppgraderingen ändrar bara konfigurationen eller data).

SortOrder

Typ: sträng (uppräkning)
Obligatoriskt: Nej
Standard: Default

Definierar i vilken ordning en uppgradering fortsätter genom klustret.

Möjliga värden:

  • Invalid – Anger att den här sorteringsordningen inte är giltig. Alla Service Fabric-uppräkningar har den ogiltiga typen. Värdet är 0.
  • Default – Anger att standardsorteringsordningen (som anges i klustermanifestet) kommer att användas. Värdet är 1.
  • Numeric – Anger att vidarebefordran av numerisk sorteringsordning (UD-namn sorterade som tal) kommer att användas. Värdet är 2.
  • Lexicographical – Anger att vidarebefordran av lexikografiska sorteringsordningar (UD-namn sorterade som strängar) kommer att användas. Värdet är 3.
  • ReverseNumeric – Anger att omvänd numerisk sorteringsordning (UD-namn sorterade som tal) kommer att användas. Värdet är 4.
  • ReverseLexicographical – Anger att omvänd lexikografisk sorteringsordning (UD-namn sorterade som strängar) kommer att användas. Värdet är 5.

MonitoringPolicy

Typ: MonitoringPolicyDescription
Krävs: Nej

Beskriver parametrarna för att övervaka en uppgradering i övervakat läge.

ApplicationHealthPolicy

Typ: ApplicationHealthPolicy
Krävs: Nej

Definierar en hälsoprincip som används för att utvärdera hälsotillståndet för ett program eller en av dess underordnade entiteter.

InstanceCloseDelayDurationInSeconds

Typ: heltal (int64)
Krävs: Nej

Varaktighet i sekunder, att vänta innan en tillståndslös instans stängs, så att aktiva begäranden kan tömmas korrekt. Detta skulle vara effektivt när instansen stängs under program-/klusteruppgraderingen, endast för de instanser som har en fördröjningstid som inte är noll och som konfigurerats i tjänstbeskrivningen. Mer information finns i egenskapen InstanceCloseDelayDurationSeconds i $ref: "#/definitions/StatelessServiceDescription.yaml". Observera att standardvärdet för InstanceCloseDelayDurationInSeconds är 4294967295, vilket indikerar att beteendet helt beror på fördröjningen som konfigureras i beskrivningen av den tillståndslösa tjänsten.

ManagedApplicationIdentity

Typ: ManagedApplicationIdentityDescription
Krävs: Nej

Beskrivning av hanterad programidentitet.