Start-ServiceFabricComposeDeploymentUpgrade
NÁHLED. Upgraduje nasazení vytváření service fabric pomocí nového souboru pro psaní zpráv.
Syntaxe
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
Tato rutina je ve verzi PREVIEW a v dalších verzích se může změnit. Neexistuje žádná záruka kompatibility.
Rutina Start-ServiceFabricComposeDeploymentUpgrade upgraduje nasazení sestavení Service Fabric. Tato rutina spustí upgrade v clusteru.
Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .
Pokyny k nasazení service Fabric pro vytváření sestav najdete v tématu: Vytvoření nasazení ve službě Service Fabric.
Příklady
Příklad 1: Upgrade nasazení pro psaní zpráv
PS C:\> Start-ServiceFabricComposeDeploymentUpgrade -DeploymentName mydeployment -Compose docker-compose.yml -Monitored -FailureAction Rollback
Příkaz provede monitorovaný automatický upgrade nasazení compose s názvem mydeployment ze souboru docker-compose.yml. Upgrade se vrátí zpět, pokud se monitorovaný upgrade nezdaří. Není nutné předem registrovat typ aplikace.
Parametry
-Compose
Určuje cestu k cílovému souboru pro psaní zpráv, který popisuje nasazení sestavení Service Fabric.
Typ: | String |
Position: | 1 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ConsiderWarningAsError
Označuje, jestli se má událost stavu upozornění považovat za událost chyby během vyhodnocení stavu.
Typ: | Boolean |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultServiceTypeHealthPolicy
Určuje zásadu stavu pro výchozí typ služby, která se má použít pro monitorovaný upgrade ve formátu MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Například 5 10 15 označuje následující hodnoty:
- MaxPercentUnhealthyPartitionsPerService = 5
- MaxPercentUnhealthyReplicasPerPartition = 10
- MaxPercentUnhealthyServices = 15
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DeploymentName
Určuje název nasazení pro psaní zpráv. Rutina upgraduje nasazení vytváření pomocí tohoto názvu.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-FailureAction
Určuje akci, která se má provést, pokud monitorovaný upgrade selže. Tento parametr přijímá tyto hodnoty:
- Vrácení zpět
- Ruční
Typ: | UpgradeFailureAction |
Přípustné hodnoty: | Invalid, Rollback, Manual |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Force
Označuje, že tato rutina přeskočí zprávu upozornění a vynutí upgrade.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ForceRestart
Označuje, že všechny kontejnery v souboru pro psaní zpráv by se měly znovu vytvořit, i když se popisy služby v novém souboru pro psaní zpráv nezměnily.
Typ: | SwitchParameter |
Position: | 5 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-HealthCheckRetryTimeoutSec
Určuje dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-HealthCheckStableDurationSec
Určuje dobu trvání v sekundách, po které Service Fabric čeká, aby ověřila, že aplikace, která vytváří nasazené nasazení, je stabilní před přechodem na další doménu upgradu nebo dokončením upgradu. Tato doba čekání zabraňuje nedetekovaným změnám stavu hned po provedení kontroly stavu.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-HealthCheckWaitDurationSec
Určuje dobu trvání v sekundách, po které Service Fabric čeká, než provede počáteční kontrolu stavu po dokončení upgradu v doméně upgradu.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-MaxPercentUnhealthyDeployedApplications
Určuje maximální procento instancí aplikace nasazených na uzlech v clusteru, které mají stav chyby před chybou stavu aplikace pro cluster.
Typ: | Byte |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Monitored
Označuje, že je monitorovaný režim upgradu. Jakmile rutina dokončí upgrade domény, pokud stav domény upgradu a cluster splňují zásady stavu, které definujete, Service Fabric upgraduje další upgradovanou doménu. Pokud doména nebo cluster upgradu nesplňuje zásady stavu, upgrade selže a Service Fabric vrátí upgrade pro doménu upgradu zpět nebo se vrátí do ručního režimu podle zadané zásady. Toto je doporučený režim pro vytváření upgradů nasazení v produkčním prostředí.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PasswordEncrypted
Označuje, jestli je RegistryPassword šifrovaný invoke-ServiceFabricEncryptText.
Typ: | SwitchParameter |
Position: | 4 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RegistryPassword
Označuje heslo registru kontejneru. Pokud je tento parmametr k dispozici, musí být registryUserName k dispozici společně.
Typ: | String |
Position: | 3 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-RegistryUserName
Označuje uživatelské jméno registru kontejneru. Pokud je tento parmametr k dispozici, musí být RegistryPassword k dispozici společně.
Typ: | String |
Position: | 2 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-ServiceTypeHealthPolicyMap
Určuje mapu zásad stavu, která se má použít pro různé typy služeb jako tabulka hash v následujícím formátu: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Příklad:
@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }
Typ: | Hashtable |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Typ: | Int32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UnmonitoredAuto
Označuje, že režim upgradu není monitorovaný automaticky. Jakmile Service Fabric upgraduje doménu upgradu, Service Fabric upgraduje další doménu upgradu bez ohledu na stav aplikace. Tento režim se nedoporučuje pro produkční prostředí a je užitečný pouze při vývoji nasazení pro psaní zpráv.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UnmonitoredManual
Označuje, že režim upgradu není monitorovaný ručně. Po upgradu domény upgradu Service Fabric počká na upgrade další upgradované domény pomocí rutiny Resume-ServiceFabricApplicationUpgrade .
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UpgradeDomainTimeoutSec
Určuje maximální dobu v sekundách, kterou Service Fabric trvá upgrade jedné upgradové domény. Po uplynutí této doby se upgrade nezdaří.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UpgradeReplicaSetCheckTimeoutSec
Určuje maximální dobu, po kterou Service Fabric čeká na překonfigurování služby do bezpečného stavu, pokud ještě není v bezpečném stavu, před tím, než Service Fabric pokračuje s upgradem.
Typ: | UInt32 |
Position: | 6 |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-UpgradeTimeoutSec
Určuje maximální dobu v sekundách, kterou služba Service Fabric trvá pro celý upgrade. Po uplynutí této doby se upgrade nezdaří.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None
Výstupy
System.Object