ApplicationUpgradeDescription interface
アプリケーションのアップグレードのパラメーターについて説明します。 アップグレードの説明は、既存のアプリケーションの説明に置き換わる点に注意してください。 つまり、パラメーターが指定されていない場合、アプリケーションの既存のパラメーターは空のパラメーター リストで上書きされます。 これにより、アプリケーション マニフェストのパラメーターの既定値がアプリケーションで使用されます。 既存のパラメーター値を変更しない場合は、最初に GetApplicationInfo クエリを使用してアプリケーション パラメーターを取得し、その値をこの ApplicationUpgradeDescription のパラメーターとして指定してください。
プロパティ
| application |
アプリケーションまたはその子エンティティの正常性を評価するために使用される正常性ポリシーを定義します。 |
| force |
true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。 |
| instance |
アクティブな要求が正常にドレインできるように、ステートレス インスタンスが閉じられる前に待機する時間 (秒単位)。 これは、アプリケーション/クラスターのアップグレード中にインスタンスが閉じている場合に有効になります。サービスの説明で 0 以外の遅延期間が構成されているインスタンスに対してのみ有効です。 詳細については、「#/definitions/StatelessServiceDescription.yaml」の$refの InstanceCloseDelayDurationSeconds プロパティを参照してください。 InstanceCloseDelayDurationInSeconds の既定値は4294967295。これは、動作がステートレス サービスの説明で構成された遅延に完全に依存することを示します。 |
| monitoring |
監視モードでアップグレードを監視するためのパラメーターについて説明します。 |
| name | 'fabric:' URI スキームを含むターゲット アプリケーションの名前。 |
| parameters | アプリケーション マニフェストで指定された既定値からオーバーライドされた値を持つアプリケーション パラメーターの一覧。 |
| rolling |
ローリング アップグレード中の正常性の監視に使用されるモード。 値は UnmonitoredAuto、UnmonitoredManual、Monitored です。 使用可能な値は、'Invalid'、'UnmonitoredAuto'、'UnmonitoredManual'、'Monitored' です。 既定値: 'UnmonitoredAuto'。 |
| sort |
アップグレードがクラスターを通過する順序を定義します。 使用できる値は、'Invalid'、'Default'、'Numeric'、'Lexicographical'、'ReverseNumeric'、'ReverseLexicographical' です。 既定値: 'Default'。 |
| target |
アプリケーションのアップグレードのターゲット アプリケーションの種類のバージョン (アプリケーション マニフェストにあります)。 |
| upgrade |
次の可能な値からアップグレードの種類。 指定できる値は、'Invalid'、'Rolling' です。 既定値: 'Rolling'。 |
| upgrade |
アップグレード ドメインの処理をブロックし、予期しない問題が発生した場合の可用性の損失を防ぐための最大時間。 このタイムアウトが切れると、可用性の損失の問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 有効な値は 0 ~ 42949672925です。 (符号なし 32 ビット整数)。 |
プロパティの詳細
applicationHealthPolicy
アプリケーションまたはその子エンティティの正常性を評価するために使用される正常性ポリシーを定義します。
applicationHealthPolicy?: ApplicationHealthPolicy
プロパティ値
forceRestart
true の場合、コード バージョンが変更されていない場合でも、アップグレード中にプロセスが強制的に再起動されます (アップグレードによって構成またはデータのみが変更されます)。
forceRestart?: boolean
プロパティ値
boolean
instanceCloseDelayDurationInSeconds
アクティブな要求が正常にドレインできるように、ステートレス インスタンスが閉じられる前に待機する時間 (秒単位)。 これは、アプリケーション/クラスターのアップグレード中にインスタンスが閉じている場合に有効になります。サービスの説明で 0 以外の遅延期間が構成されているインスタンスに対してのみ有効です。 詳細については、「#/definitions/StatelessServiceDescription.yaml」の$refの InstanceCloseDelayDurationSeconds プロパティを参照してください。 InstanceCloseDelayDurationInSeconds の既定値は4294967295。これは、動作がステートレス サービスの説明で構成された遅延に完全に依存することを示します。
instanceCloseDelayDurationInSeconds?: number
プロパティ値
number
monitoringPolicy
監視モードでアップグレードを監視するためのパラメーターについて説明します。
monitoringPolicy?: MonitoringPolicyDescription
プロパティ値
name
'fabric:' URI スキームを含むターゲット アプリケーションの名前。
name: string
プロパティ値
string
parameters
アプリケーション マニフェストで指定された既定値からオーバーライドされた値を持つアプリケーション パラメーターの一覧。
parameters?: ApplicationParameter[]
プロパティ値
rollingUpgradeMode
ローリング アップグレード中の正常性の監視に使用されるモード。 値は UnmonitoredAuto、UnmonitoredManual、Monitored です。 使用可能な値は、'Invalid'、'UnmonitoredAuto'、'UnmonitoredManual'、'Monitored' です。 既定値: 'UnmonitoredAuto'。
rollingUpgradeMode?: UpgradeMode
プロパティ値
sortOrder
アップグレードがクラスターを通過する順序を定義します。 使用できる値は、'Invalid'、'Default'、'Numeric'、'Lexicographical'、'ReverseNumeric'、'ReverseLexicographical' です。 既定値: 'Default'。
sortOrder?: UpgradeSortOrder
プロパティ値
targetApplicationTypeVersion
アプリケーションのアップグレードのターゲット アプリケーションの種類のバージョン (アプリケーション マニフェストにあります)。
targetApplicationTypeVersion: string
プロパティ値
string
upgradeKind
次の可能な値からアップグレードの種類。 指定できる値は、'Invalid'、'Rolling' です。 既定値: 'Rolling'。
upgradeKind: UpgradeKind
プロパティ値
upgradeReplicaSetCheckTimeoutInSeconds
アップグレード ドメインの処理をブロックし、予期しない問題が発生した場合の可用性の損失を防ぐための最大時間。 このタイムアウトが切れると、可用性の損失の問題に関係なく、アップグレード ドメインの処理が続行されます。 タイムアウトは、各アップグレード ドメインの開始時にリセットされます。 有効な値は 0 ~ 42949672925です。 (符号なし 32 ビット整数)。
upgradeReplicaSetCheckTimeoutInSeconds?: number
プロパティ値
number