Start-ServiceFabricComposeDeploymentUpgrade

NÁHLED. Upgraduje nasazení vytváření service fabric pomocí nového souboru pro psaní zpráv.

Syntax

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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsiderWarningAsError

Označuje, jestli se má událost stavu upozornění považovat za událost chyby během vyhodnocení stavu.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentName

Určuje název nasazení pro psaní zpráv. Rutina upgraduje nasazení vytváření pomocí tohoto názvu.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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í
Type:UpgradeFailureAction
Accepted values:Invalid, Rollback, Manual
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Force

Označuje, že tato rutina přeskočí zprávu upozornění a vynutí upgrade.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:5
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HealthCheckRetryTimeoutSec

Určuje dobu trvání v sekundách, po které Service Fabric opakuje kontrolu stavu, pokud předchozí kontrola stavu selže.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PasswordEncrypted

Označuje, jestli je RegistryPassword šifrovaný invoke-ServiceFabricEncryptText.

Type:SwitchParameter
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistryPassword

Označuje heslo registru kontejneru. Pokud je tento parmametr k dispozici, musí být registryUserName k dispozici společně.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RegistryUserName

Označuje uživatelské jméno registru kontejneru. Pokud je tento parmametr k dispozici, musí být RegistryPassword k dispozici společně.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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" }

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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ří.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UInt32
Position:6
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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ří.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Výstupy

System.Object