Sdílet prostřednictvím


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