Udostępnij za pośrednictwem


Start-ServiceFabricComposeDeploymentUpgrade

PRAPREMIERA. Uaktualnia wdrożenie redagowania usługi Service Fabric przy użyciu nowego pliku redagowania.

Składnia

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>]

Opis

To polecenie cmdlet jest dostępne w wersji zapoznawczej i może ulec zmianie w kolejnych wersjach. Nie ma gwarancji zgodności.

Polecenie cmdlet start-ServiceFabricComposeDeploymentUpgrade uaktualnia wdrożenie redagowania usługi Service Fabric. To polecenie cmdlet uruchamia uaktualnienie w klastrze.

Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster.

Aby uzyskać wskazówki dotyczące wdrażania redagowania usługi Service Fabric, zobacz: Redagowanie wdrożenia w usłudze Service Fabric

Przykłady

Przykład 1. Uaktualnianie wdrożenia redagowania

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

Polecenie wykonuje monitorowane automatyczne uaktualnianie przy wdrażaniu redagowania o nazwie mydeployment z pliku compose docker-compose.yml. Uaktualnienie zostanie wycofane, jeśli monitorowane uaktualnienie zakończy się niepowodzeniem. Nie ma potrzeby wcześniejszego rejestrowania typu aplikacji.

Parametry

-Compose

Określa ścieżkę pliku do docelowego pliku redagowania, który opisuje wdrożenie redagowania usługi Service Fabric.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ConsiderWarningAsError

Wskazuje, czy zdarzenie kondycji ostrzeżenia ma być traktowane jako zdarzenie błędu podczas oceny kondycji.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultServiceTypeHealthPolicy

Określa zasady kondycji domyślnego typu usługi do użycia dla monitorowanego uaktualnienia w formacie MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices. Na przykład 5 10 15 wskazuje następujące wartości:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DeploymentName

Określa nazwę wdrożenia redagowania. Polecenie cmdlet uaktualnia wdrożenie redagowania o tej nazwie.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FailureAction

Określa akcję, która ma być wykonywana, jeśli monitorowane uaktualnienie zakończy się niepowodzeniem. Dopuszczalne wartości tego parametru to:

  • Wycofywanie
  • Ręcznie
Typ:UpgradeFailureAction
Dopuszczalne wartości:Invalid, Rollback, Manual
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wskazuje, że to polecenie cmdlet pomija komunikat ostrzegawczy i wymusza uaktualnienie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ForceRestart

Wskazuje, że wszystkie kontenery w pliku redagowania powinny być ponownie tworzone, nawet jeśli opisy usług nie zmieniły się w nowym pliku redagowania.

Typ:SwitchParameter
Position:5
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckRetryTimeoutSec

Określa czas trwania w sekundach, po którym usługa Service Fabric ponawia próbę sprawdzenia kondycji, jeśli poprzednia kontrola kondycji zakończy się niepowodzeniem.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckStableDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric w celu sprawdzenia, czy aplikacja, która komponuje wdrożone wdrożenie, jest stabilna przed przejściem do następnej domeny uaktualnienia lub ukończeniem uaktualnienia. Ten czas oczekiwania zapobiega niezkrytym zmianom kondycji bezpośrednio po wykonaniu kontroli kondycji.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-HealthCheckWaitDurationSec

Określa czas trwania w sekundach oczekiwania usługi Service Fabric przed wykonaniem początkowej kontroli kondycji po zakończeniu uaktualniania w domenie uaktualnienia.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaxPercentUnhealthyDeployedApplications

Określa maksymalny procent wystąpień aplikacji wdrożonych w węzłach w klastrze, które mają stan kondycji błędu przed wystąpieniem błędu kondycji aplikacji dla klastra jest błędem.

Typ:Byte
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Monitored

Wskazuje, że tryb uaktualniania jest monitorowany. Po zakończeniu uaktualniania domeny uaktualnienia przez polecenie cmdlet, jeśli kondycja domeny uaktualnienia i klastra spełniają zdefiniowane zasady kondycji, usługa Service Fabric uaktualnia następną domenę uaktualnienia. Jeśli domena uaktualnienia lub klaster nie spełniają zasad kondycji, uaktualnienie zakończy się niepowodzeniem, a usługa Service Fabric wycofa uaktualnienie domeny uaktualnienia lub powróci do trybu ręcznego zgodnie z określonymi zasadami. Jest to zalecany tryb tworzenia uaktualnień wdrożenia w środowisku produkcyjnym.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PasswordEncrypted

Wskazuje, czy RegistryPassword jest szyfrowany przez Invoke-ServiceFabricEncryptText.

Typ:SwitchParameter
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RegistryPassword

Wskazuje hasło rejestru kontenerów. Jeśli ten parmametr jest podany, RegistryUserName należy podać razem.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RegistryUserName

Wskazuje nazwę użytkownika rejestru kontenerów. Jeśli ten parmametr jest podany, RegistryPassword musi być dostarczony razem.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServiceTypeHealthPolicyMap

Określa mapę zasad kondycji do użycia dla różnych typów usług jako tabeli skrótów w następującym formacie: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartitions,MaxPercentUnhealthyServices"}. Na przykład:

@{ "ServiceTypeName01" = "5,10,5"; "ServiceTypeName02" = "5,5,5" }

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UnmonitoredAuto

Wskazuje, że tryb uaktualniania jest niemonitorowany automatycznie. Po uaktualnieniu domeny uaktualnienia usługi Service Fabric usługa Service Fabric uaktualnia następną domenę uaktualnienia niezależnie od stanu kondycji aplikacji. Ten tryb nie jest zalecany w środowisku produkcyjnym i jest przydatny tylko podczas opracowywania wdrożenia redagowania.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UnmonitoredManual

Wskazuje, że tryb uaktualniania jest niemonitorowany ręcznie. Po uaktualnieniu domeny uaktualnienia usługi Service Fabric czeka na uaktualnienie następnej domeny uaktualnienia przy użyciu polecenia cmdlet Resume-ServiceFabricApplicationUpgrade.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeDomainTimeoutSec

Określa maksymalny czas (w sekundach), który zajmuje usłudze Service Fabric uaktualnienie pojedynczej domeny uaktualnienia. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeReplicaSetCheckTimeoutSec

Określa maksymalny czas oczekiwania usługi Service Fabric na ponowne skonfigurowanie usługi w bezpiecznym stanie, jeśli nie jest jeszcze w bezpiecznym stanie, zanim usługa Service Fabric przejdzie do uaktualnienia.

Typ:UInt32
Position:6
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UpgradeTimeoutSec

Określa maksymalny czas w sekundach potrzebny na całe uaktualnienie usługi Service Fabric. Po upływie tego okresu uaktualnianie zakończy się niepowodzeniem.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Dane wyjściowe

System.Object