Start-ServiceFabricComposeDeploymentUpgrade

參考

模組:: ServiceFabric

預覽。使用新的撰寫檔案升級 Service Fabric 撰寫部署。

語法

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-ServiceFabricComposeDeploymentUpgrade
     [-DeploymentName] <String>
     [-Compose] <String>
     [[-RegistryUserName] <String>]
     [[-RegistryPassword] <String>]
     [-PasswordEncrypted]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [-Monitored]
     -FailureAction <UpgradeFailureAction>
     [-HealthCheckRetryTimeoutSec <UInt32>]
     [-HealthCheckWaitDurationSec <UInt32>]
     [-HealthCheckStableDurationSec <UInt32>]
     [-UpgradeDomainTimeoutSec <UInt32>]
     [-UpgradeTimeoutSec <UInt32>]
     [-ConsiderWarningAsError <Boolean>]
     [-DefaultServiceTypeHealthPolicy <String>]
     [-MaxPercentUnhealthyDeployedApplications <Byte>]
     [-ServiceTypeHealthPolicyMap <Hashtable>]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

此 Cmdlet 處於預覽狀態，且下一個版本可能會變更。沒有相容性保證。

Start-ServiceFabricComposeDeploymentUpgrade Cmdlet 會升級 Service Fabric 撰寫部署。此 Cmdlet 會在叢集上啟動升級。

在 Service Fabric 叢集上執行任何作業之前，請使用 Connect-ServiceFabricCluster Cmdlet 來建立叢集的連線。

如需 Service Fabric 撰寫部署的指引，請參閱：在 Service Fabric 中撰寫部署

範例

範例 1：升級撰寫部署

PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback

此命令會在名為 mydeployment 的 compose 部署上執行受監視的自動升級，從 compose 檔案docker-compose.yml。如果受監視的升級失敗，升級將會復原。不需要事先註冊應用程式類型。

參數

-Compose

指定描述 Service Fabric 撰寫部署之目標撰寫檔案的檔案路徑。

類型:	String
Position:	1
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ConsiderWarningAsError

指出是否要在健康情況評估期間將警告健康情況事件視為錯誤事件。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DefaultServiceTypeHealthPolicy

以 MaxPercentUnhealthyPartitionsPerService、MaxPercentUnhealthyReplicasPerPartitionsPerPartition、MaxPercentUnhealthyReplicasPerPartition、MaxPercentUnhealthyServices 格式指定要用於受監視升級的默認服務類型健康情況原則。例如，5,10,15 表示下列值：

MaxPercentUnhealthyPartitionsPerService = 5
MaxPercentUnhealthyReplicasPerPartition = 10
MaxPercentUnhealthyServices = 15

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeploymentName

指定撰寫部署的名稱。 Cmdlet 會使用此名稱升級撰寫部署。

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-FailureAction

指定受監視升級失敗時要採取的動作。此參數可接受的值為：

反轉
手動

類型:	UpgradeFailureAction
接受的值:	Invalid, Rollback, Manual
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Force

表示此 Cmdlet 會略過警告訊息並強制升級。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceRestart

表示即使新撰寫檔案中的服務描述未變更，也應該重新建立撰寫檔案中的所有容器。

類型:	SwitchParameter
Position:	5
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HealthCheckRetryTimeoutSec

指定持續時間，以秒為單位，之後 Service Fabric 會在先前的健康情況檢查失敗時重試健康情況檢查。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HealthCheckStableDurationSec

指定 Service Fabric 等候的持續時間，以秒為單位，以確認部署部署所部署的應用程式在移至下一個升級網域或完成升級之前是穩定的。此等候持續時間可防止在執行健康狀態檢查之後立即偵測到健康情況變更。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HealthCheckWaitDurationSec

指定 Service Fabric 在升級網域完成升級之後，在執行初始健康狀態檢查之前等候的持續時間，以秒為單位。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MaxPercentUnhealthyDeployedApplications

指定在叢集中節點上部署之應用程式實例的最大百分比，這些實例在叢集的應用程式健康情況狀態發生錯誤之前，其健康情況狀態為錯誤。

類型:	Byte
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Monitored

表示監視升級模式。 Cmdlet 完成升級網域的升級之後，如果升級網域和叢集的健康情況符合您定義的健全狀況原則，Service Fabric 就會升級下一個升級網域。如果升級網域或叢集無法符合健康情況原則，升級會失敗，Service Fabric 會回復升級網域的升級，或根據指定的原則還原為手動模式。這是在生產環境中撰寫部署升級的建議模式。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PasswordEncrypted

指出 Invoke-ServiceFabricEncryptText會加密 RegistryPassword。

類型:	SwitchParameter
Position:	4
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RegistryPassword

指出容器登錄的密碼。如果提供這個剖析器，RegistryUserName 必須一起提供。

類型:	String
Position:	3
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RegistryUserName

指出容器登錄的用戶名稱。如果提供這個剖析器，RegistryPassword 必須一起提供。

類型:	String
Position:	2
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServiceTypeHealthPolicyMap

以下列格式指定用於不同服務類型的健康情況原則對應：@ {“ServiceTypeName” ： “MaxPercentUnhealthyPartitionsPerService，MaxPercentUnhealthyReplicasPerPartition，MaxPercentUnhealthyServices”}。例如：

@{ “ServiceTypeName01” = “5,10,5”;“ServiceTypeName02” = “5,5,5” }

類型:	Hashtable
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TimeoutSec

指定作業的逾時期間，以秒為單位。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UnmonitoredAuto

表示升級模式為未受監視的自動模式。 Service Fabric 升級升級網域之後，不論應用程式健康狀態為何，Service Fabric 會升級下一個升級網域。不建議將此模式用於生產環境，而且只有在開發撰寫部署時才有用。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UnmonitoredManual

表示升級模式為未受監視的手動。 Service Fabric 升級升級網域之後，它會等候您使用 Resume-ServiceFabricApplicationUpgrade Cmdlet 升級下一個升級網域。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-UpgradeDomainTimeoutSec

指定 Service Fabric 升級單一升級網域所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UpgradeReplicaSetCheckTimeoutSec

指定 Service Fabric 等候服務重新設定為安全狀態的最長時間，如果尚未處於安全狀態，Service Fabric 繼續進行升級。

類型:	UInt32
Position:	6
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UpgradeTimeoutSec

指定 Service Fabric 針對整個升級所花費的時間上限，以秒為單位。在此期間之後，升級會失敗。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Object

共用方式為

Start-ServiceFabricComposeDeploymentUpgrade

語法

Description

範例

範例 1：升級撰寫部署

參數

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

輸入

輸出

其他資源

共用方式為

Start-ServiceFabricComposeDeploymentUpgrade

語法

Description

範例

範例 1：升級撰寫部署

參數

-Compose

-Confirm

-ConsiderWarningAsError

-DefaultServiceTypeHealthPolicy

-DeploymentName

-FailureAction

-Force

-ForceRestart

-HealthCheckRetryTimeoutSec

-HealthCheckStableDurationSec

-HealthCheckWaitDurationSec

-MaxPercentUnhealthyDeployedApplications

-Monitored

-PasswordEncrypted

-RegistryPassword

-RegistryUserName

-ServiceTypeHealthPolicyMap

-TimeoutSec

-UnmonitoredAuto

-UnmonitoredManual

-UpgradeDomainTimeoutSec

-UpgradeReplicaSetCheckTimeoutSec

-UpgradeTimeoutSec

-WhatIf

輸入

輸出

相關連結

其他資源