應用程式升級參數
本文說明在 Azure Service Fabric 應用程式升級期間套用的各種參數。 應用程式升級參數會控制升級時套用的逾時與健康情況檢查，並且指定升級失敗時必須套用的原則。 應用程式參數會使用下列各項套用到升級：
- PowerShell
- Visual Studio
- SFCTL
- REST
您可以從三個使用者可選取的升級模式中選一個來起始應用程式升級。 每一種模式都有自己的一組應用程式參數：
- 已監視
- 未受監視的自動升級 (Unmonitored Auto)
- 未受監視的手動升級 (Unmonitored Manual)
以下各節會說明適用的必要和選擇性參數。
Visual Studio 和 PowerShell 參數
使用 PowerShell 升級的 Service Fabric 應用程式會使用 Start-ServiceFabricApplicationUpgrade 命令。 若要選擇升級模式，可將 Monitored、UnmonitoredAuto 或 UnmonitoredManual 參數傳遞給 Start-ServiceFabricApplicationUpgrade。
Visual Studio Service Fabric 應用程式升級參數會透過 [Visual Studio 升級設定] 對話方塊來設定。 若要選取 Visual Studio 升級模式，可使用 [升級模式] 下拉式清單來選取 Monitored、UnmonitoredAuto 或 UnmonitoredManual。 如需詳細資訊，請參閱在 Visual Studio 中設定 Service Fabric 應用程式的升級。
必要參數
| 參數 | 套用至 | 描述 |
|---|---|---|
| ApplicationName | PowerShell | 正在升級的應用程式名稱。 範例：fabric:/VisualObjects、fabric:/ClusterMonitor。 |
| ApplicationTypeVersion | PowerShell | 升級目標的應用程式類型的版本。 |
| FailureAction | PowerShell、Visual Studio | 允許的值為 Rollback、Manual 和 Invalid。 「受監視」的升級遇到監視原則或健康原則違規時，所要執行的補償動作。 Rollback 會指定升級自動復原為升級前的版本。 Manual 表示升級將切換為 UnmonitoredManual 升級模式。 Invalid 表示失敗動作無效。 |
| 已監視 | PowerShell | 表示升級模式受到監視。 當 Cmdlet 完成一個升級網域的升級後，如果升級網域和叢集的健康情況符合您定義的健康情況原則，則 Service Fabric 會升級下一個升級網域。 如果升級網域或叢集不符合健康原則，升級將會失敗，而且 Service Fabric 會根據指定的原則復原該升級網域的升級，或還原為手動模式。 這是在生產環境中升級應用程式的建議模式。 |
| UpgradeMode | Visual Studio | 允許的值為 Monitored (預設值)、UnmonitoredAuto或 UnmonitoredManual。 請在本文中參閱每個模式的 PowerShell 參數，以取得詳細資訊。 |
| UnmonitoredAuto | PowerShell | 表示升級模式為未受監視的自動升級。 當 Service Fabric 升級一個升級網域後，不管應用程式健康狀態為何，Service Fabric 都會升級下一個升級網域。 此模式中不建議用於生產環境中，而且僅適用於應用程式的開發。 |
| UnmonitoredManual | PowerShell | 表示升級模式為未受監視的手動升級。 當 Service Fabric 升級一個升級網域後，它會等候您使用 Resume-servicefabricapplicationupgrade Cmdlet 來升級下一個升級網域。 |
選擇性參數
健康情況評估參數是選擇性的。 如果啟動升級時未指定健康狀態評估準則，則 Service Fabric 會使用應用程式執行個體的 ApplicationManifest.xml 中指定的應用程式健康狀態原則。
| 參數 | 套用至 | 描述 |
|---|---|---|
| ApplicationParameter | PowerShell、Visual Studio | 指定覆寫應用程式參數。 PowerShell 應用程式參數會指定為雜湊表的名稱/值組。 例如，@{ "VotingData_MinReplicaSetSize" = "3"; "VotingData_PartitionCount" = "1" }. 您可以在 [應用程式參數檔案] 欄位中的 [發行 Service Fabric 應用程式] 對話方塊中，指定 Visual Studio 應用程式參數。 |
| 確認 | PowerShell | 允許的值為 True 和 False。 在執行 Cmdlet 前提示您確認。 |
| ConsiderWarningAsError | PowerShell、Visual Studio | 允許的值為 True 和 False。 預設值為 False。 升級期間評估應用程式健康狀態時，將應用程式的警告健康狀態事件視為錯誤。 根據預設，Service Fabric 不會將警告健康狀態事件評估為失敗 (錯誤)，因此，即使有警告事件，升級還是可以繼續執行。 |
| DefaultServiceTypeHealthPolicy | PowerShell、Visual Studio | 以下列格式指定預設服務類型的健康原則，以用於受監視的升級：MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices。 例如，5、10、15 表示下列值：MaxPercentUnhealthyPartitionsPerService = 5、MaxPercentUnhealthyReplicasPerPartition = 10、MaxPercentUnhealthyServices = 15。 |
| Force | PowerShell、Visual Studio | 允許的值為 True 和 False。 表示即使版本號碼未變更，升級程序還是會略過警告訊息並強制升級。 這適用於本機測試，但不建議用於生產環境，因為其需要移除現有的部署，這會導致停機和潛在的資料遺失問題。 |
| ForceRestart | PowerShell、Visual Studio | 如果您更新組態或資料套件而不更新服務程式碼，只有當 ForceRestart 屬性設為 True 時，服務才會重新啟動。 更新完成時，Service Fabric 會通知服務，新的組態封裝或資料封裝已可使用。 服務會負責套用變更。 必要時，服務可以自行重新啟動。 |
| HealthCheckRetryTimeoutSec | PowerShell、Visual Studio | Service Fabric 在將升級宣告為失敗之前，繼續執行健康狀態評估的持續時間 (以秒為單位)。 預設值是 600 秒。 此期間會在達到 HealthCheckWaitDurationSec 之後開始計算。 在此 HealthCheckRetryTimeout 之內，Service Fabric 可能會執行多個應用程式健康情況的健康情況檢查。 預設值為 10 分鐘，您應該針對您的應用程式適當地加以自訂。 |
| HealthCheckStableDurationSec | PowerShell、Visual Studio | 移至下一個升級網域或完成升級之前，要確認應用程式是否穩定的持續時間 (以秒為單位)。 這個等候持續時間是用來在執行健康狀態檢查後，防止未偵測到的健康狀態變更。 預設值為 120 秒鐘，您應該針對您的應用程式適當地加以自訂。 |
| HealthCheckWaitDurationSec | PowerShell、Visual Studio | 在升級網域上完成升級之後，Service Fabric 評估應用程式健康狀態的等待時間 (以秒為單位)。 這段期間也可視為應用程式在被視為健康之前應該執行的時間。 如果健康狀態檢查都通過，則升級程序會繼續進行下一個升級網域。 如果健康情況檢查失敗，Service Fabric 會等候 UpgradeHealthCheckInterval，然後再重試一次健康情況檢查，直到達到 HealthCheckRetryTimeoutSec 為止。 預設值和建議值為 0 秒。 |
| MaxPercentUnhealthyDeployedApplications | PowerShell、Visual Studio | 預設值和建議值為 0。 指定應用程式被視為不健康和更新失敗之前，應用程式不健康之已部署的應用程式數目上限 (請參閱 健康狀態章節)。 這個參數定義節點上的應用程式健康狀態，協助在升級期間偵測問題。 應用程式複本通常會負載平衡至其他節點，讓應用程式健康狀態良好，以便繼續升級。 藉由指定嚴謹的 MaxPercentUnhealthyDeployedApplications 健康情況，Service Fabric 可以快速偵測應用程式封裝的問題，並協助產生快速檢錯升級。 |
| MaxPercentUnhealthyServices | PowerShell、Visual Studio | DefaultServiceTypeHealthPolicy 和 ServiceTypeHealthPolicyMap 的參數。 預設值和建議值為 0。 指定應用程式被視為不健康和升級失敗之前，不健康之應用程式執行個體中服務的數目上限。 |
| MaxPercentUnhealthyPartitionsPerService | PowerShell、Visual Studio | DefaultServiceTypeHealthPolicy 和 ServiceTypeHealthPolicyMap 的參數。 預設值和建議值為 0。 指定服務被視為不健康之前，不健康之服務中分割的數目上限。 |
| MaxPercentUnhealthyReplicasPerPartition | PowerShell、Visual Studio | DefaultServiceTypeHealthPolicy 和 ServiceTypeHealthPolicyMap 的參數。 預設值和建議值為 0。 指定分割被視為不健康之前，不健康之分割中複本的數目上限。 |
| ServiceTypeHealthPolicyMap | PowerShell、Visual Studio | 表示此健康原則用來對某個服務類型的服務評估建康情況。 使用下列格式取用雜湊表的輸入：@ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"} For example: @{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" } |
| TimeoutSec | PowerShell、Visual Studio | 指定作業的逾時期限 (以秒為單位)。 |
| UpgradeDomainTimeoutSec | PowerShell、Visual Studio | 升級單一升級網域的時間上限 (以秒為單位)。 如果達到此逾時，升級會停止，然後根據 FailureAction 的設定繼續。 預設值為永不 (無限)，您應該針對您的應用程式適當地加以自訂。 |
| UpgradeReplicaSetCheckTimeoutSec | PowerShell、Visual Studio | 測量單位：秒。 無狀態服務- 在單一升級網域內，Service Fabric 會嘗試確保服務的額外執行個體可用。 如果目標執行個體計數超過一個，Service Fabric 會等到有一個以上的執行個體可用，最多到逾時值上限。 此逾時會使用 UpgradeReplicaSetCheckTimeoutSec 屬性來指定。 如果逾時已到期，Service Fabric 會繼續進行升級，不論服務執行個體數目。 如果目標執行個體計數是一個，Service Fabric 不會等待，它會立即繼續進行升級。 可設定狀態的服務- 在單一升級網域內，Service Fabric 會嘗試確保複本集有仲裁。 Service Fabric 會等待有仲裁可用，最多到逾時值上限 (由 UpgradeReplicaSetCheckTimeoutSec 屬性指定)。 如果逾時已到期，Service Fabric 會繼續進行升級，不論是否有仲裁。 此設定在向前回復時是設定為永不 (無限)，向後回復時則為 1200 秒。 |
| UpgradeTimeoutSec | PowerShell、Visual Studio | 逾時 (以秒為單位) 適用於整個升級。 如果達到此逾時，升級會停止，並且會觸發 FailureAction。 預設值為永不 (無限)，您應該針對您的應用程式適當地加以自訂。 |
| Whatif | PowerShell | 允許的值為 True 和 False。 顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。 |
可以針對應用程式執行個體的各個服務類型指定 MaxPercentUnhealthyServices、MaxPercentUnhealthyPartitionsPerService 和 MaxPercentUnhealthyReplicasPerPartition 準則。 為每個服務設定這些參數可讓應用程式包含有不同評估原則的不同服務類型。 例如，特定應用程式執行個體的無狀態閘道器服務類型，可以有與可設定狀態的引擎服務類型不同的 MaxPercentUnhealthyPartitionsPerService。
SFCTL 參數
使用 Service Fabric CLI 的 Service Fabric 應用程式升級會使用 sfctl application upgrade 命令搭配下列必要和選擇性參數。
必要參數
| 參數 | 描述 |
|---|---|
| application-id | 正在升級的應用程式識別碼。 這通常是沒有 'fabric:' URI 配置之應用程式的完整名稱。 從 6.0 版開始，階層的名稱會以 '~' 字元分隔。 例如，如果應用程式名稱是 'fabric:/myapp/app1'，則應用程式識別在 6.0+ 中會是 'myapp~app1'，而在舊版中會是 'myapp/app1'。 |
| application-version | 升級目標的應用程式類型的版本。 |
| parameters | 要在升級應用程式時套用的應用程式參數覆寫 JSON 編碼清單。 |
選擇性參數
| 參數 | 描述 |
|---|---|
| default-service-health-policy | 預設用來評估服務類型健康情況的健康原則 JSON 編碼規格。 對應預設是空的。 |
| failure-action | 允許的值為 Rollback、Manual 和 Invalid。 「受監視」的升級遇到監視原則或健康原則違規時，所要執行的補償動作。 Rollback 會指定升級自動復原為升級前的版本。 Manual 表示升級將切換為 UnmonitoredManual 升級模式。 Invalid 表示失敗動作無效。 |
| force-restart | 如果您更新組態或資料套件而不更新服務程式碼，只有當 ForceRestart 屬性設為 True 時，服務才會重新啟動。 更新完成時，Service Fabric 會通知服務，新的組態封裝或資料封裝已可使用。 服務會負責套用變更。 必要時，服務可以自行重新啟動。 |
| health-check-retry-timeout | 當應用程式或叢集狀況不良時，在執行 FailureAction 之前，重試健康情況評估的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 預設值：PT0H10M0S。 |
| health-check-stable-duration | 在升級繼續進入下一個升級網域之前，應用程式或叢集必須維持狀況良好的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 預設值：PT0H2M0S。 |
| health-check-wait-duration | 完成升級網域之後，在套用健康原則之前，要等待的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 預設：0。 |
| max-unhealthy-apps | 預設值和建議值為 0。 指定應用程式被視為不健康和更新失敗之前，應用程式不健康之已部署的應用程式數目上限 (請參閱 健康狀態章節)。 這個參數定義節點上的應用程式健康狀態，協助在升級期間偵測問題。 應用程式複本通常會負載平衡至其他節點，讓應用程式健康狀態良好，以便繼續升級。 藉由指定嚴謹的 max-unhealthy-apps 健康情況，Service Fabric 可以快速偵測應用程式封裝的問題，並協助產生快速檢錯升級。 以介於 0 到 100 之間的數字來表示。 |
| mode | 允許的值為 Monitored、UpgradeMode、UnmonitoredAuto、UnmonitoredManual。 預設值為 UnmonitoredAuto。 如需這些值的說明，請參閱 Visual Studio 和 PowerShell 的「必要參數」一節。 |
| replica-set-check-timeout | 測量單位：秒。 無狀態服務- 在單一升級網域內，Service Fabric 會嘗試確保服務的額外執行個體可用。 如果目標執行個體計數超過一個，Service Fabric 會等到有一個以上的執行個體可用，最多到逾時值上限。 此逾時是使用 replica-set-check-timeout 屬性指定。 如果逾時已到期，Service Fabric 會繼續進行升級，不論服務執行個體數目。 如果目標執行個體計數是一個，Service Fabric 不會等待，它會立即繼續進行升級。 可設定狀態的服務- 在單一升級網域內，Service Fabric 會嘗試確保複本集有仲裁。 Service Fabric 會等待有仲裁可用，最多到逾時值上限 (由 replica-set-check-timeout 屬性指定)。 如果逾時已到期，Service Fabric 會繼續進行升級，不論是否有仲裁。 此設定在向前回復時是設定為永不 (無限)，向後回復時則為 1200 秒。 |
| service-health-policy | 每個服務類型名稱相對於服務類型健康原則的 JSON 編碼對應。 對應預設是空的。 參數 JSON 格式。 「值」部分適用的 JSON 包含 MaxPercentUnhealthyServices、MaxPercentUnhealthyPartitionsPerService 和 MaxPercentUnhealthyReplicasPerPartition。 如需這些參數的說明，請參閱 Visual Studio 和 PowerShell 的「選擇性參數」一節。 |
| timeout | 指定作業的逾時期限 (以秒為單位)。 預設值：60。 |
| upgrade-domain-timeout | 執行 FailureAction 之前，每個升級網域必須完成的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 預設值為永不 (無限)，您應該針對您的應用程式適當地加以自訂。 預設值：P10675199DT02H48M05.4775807S。 |
| upgrade-timeout | 執行 FailureAction 之前，每個升級網域必須完成的時間長度。 它會先解譯為代表 ISO 8601 持續時間的字串。 如果失敗，則會解譯為代表總毫秒數的數字。 預設值為永不 (無限)，您應該針對您的應用程式適當地加以自訂。 預設值：P10675199DT02H48M05.4775807S。 |
| warning-as-error | 允許的值為 True 和 False。 預設值為 False。 可以旗標形式傳入。 升級期間評估應用程式健康狀態時，將應用程式的警告健康狀態事件視為錯誤。 根據預設，Service Fabric 不會將警告健康狀態事件評估為失敗 (錯誤)，因此，即使有警告事件，升級還是可以繼續執行。 |
下一步
使用 Visual Studio 升級您的應用程式 將引導您完成使用 Visual Studio 進行應用程式升級的步驟。
使用 PowerShell 升級您的應用程式將引導您完成使用 PowerShell 進行應用程式升級的步驟。
在 Linux 上使用 Service Fabric CLI 升級應用程式會引導您完成使用 Service Fabric CLI 升級應用程式的步驟。
使用 Service Fabric Eclipse 外掛程式升級應用程式
了解如何使用 資料序列化，以讓您的應用程式升級相容。
參考 進階主題，以了解如何在升級您的應用程式時使用進階功能。
參考 疑難排解應用程式升級中的步驟，以修正應用程式升級中常見的問題。