Start-ServiceFabricApplicationUpgrade

  • Başvuru
Modül:
ServiceFabric

Service Fabric uygulamasını belirtilen ApplicationTypeVersion'a yükseltir.

Sözdizimi

Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredAuto]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <UInt32>]
     [-UnmonitoredManual]
     [-Force]
     [-TimeoutSec <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-ServiceFabricApplicationUpgrade
     [-ApplicationName] <Uri>
     [-ApplicationTypeVersion] <String>
     [[-ApplicationParameter] <Hashtable>]
     [-ForceRestart]
     [[-UpgradeReplicaSetCheckTimeoutSec] <UInt32>]
     [[-SortOrder] <UpgradeSortOrder>]
     [-ReplicaQuorumTimeoutSec <UInt32>]
     [-RestartProcess]
     [-InstanceCloseDelayDurationSec <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

Start-ServiceFabricApplicationUpgrade cmdlet'i bir Service Fabric uygulamasını yükseltir. Bu cmdlet'i kullanmadan önce güncelleştirilmiş uygulama paketini görüntü deposuna kopyalamanız ve güncelleştirilmiş uygulama türünü kaydetmeniz gerekir. Uygulama paketini görüntü deposuna kopyalamak için Copy-ServiceFabricApplicationPackage kullanın. Güncelleştirilmiş uygulama türünü kaydetmek için Register-ServiceFabricApplicationType cmdlet'ini kullanın.

Bu cmdlet, kümede yükseltmeyi başlatır.

ApplicationParameters bir uygulama yükseltmesinde korunmaz. Geçerli uygulama parametrelerini korumak için, aşağıdaki Örnek 1 gösterildiği gibi, kullanıcının önce parametreleri alması ve yükseltme API'si çağrısına geçirmesi gerekir.

Service Fabric uygulama yükseltmeleri hakkında daha fazla bilgi içinkavramsal belgelerine bakın.

Service Fabric kümesinde herhangi bir işlem yapmadan önce, Connect-ServiceFabricCluster cmdlet'ini kullanarak kümeyle bağlantı kurun.

Örnekler

Örnek 1: Yükseltme çağrısına geçirmek için uygulama parametrelerini alma

$myApplication = Get-ServiceFabricApplication -ApplicationName fabric:/myApplication
$appParamCollection = $myApplication.ApplicationParameters
$applicationParameterMap = @{}

foreach ($pair in $appParamCollection)
{ $applicationParameterMap.Add($pair.Name, $pair.Value); }

Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myApplication -ApplicationTypeVersion 2.0.0 -ApplicationParameter $applicationParameterMap -Monitored -FailureAction Rollback

Örnek 2: Uygulamayı yükseltme

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "C:\PersistentToDoListServiceV2" -ImageStoreConnectionString "file:C:\ProgramData\ServiceFabric\ImageStore"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListServiceV2"
PS C:\> Start-ServiceFabricApplicationUpgrade -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeVersion "2.0" -ForceRestart -UnMonitoredManual

İlk komut, güncelleştirilmiş uygulama paketini görüntü deposuna kopyalamak için Copy-ServiceFabricApplicationPackage cmdlet'ini kullanır.

İkinci komut, güncelleştirilmiş uygulama türünü kaydetmek için Register-ServiceFabricApplicationType cmdlet'ini kullanır.

Üçüncü komut uygulamayı yükseltmektedir. Komut, uygulamayı barındıran sunucunun yeniden başlatılmasını içeren izlenmeyen bir el ile yükseltme gerçekleştirir.

Parametreler

-ApplicationName

Service Fabric uygulamasının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. Cmdlet, belirttiğiniz URI'ye sahip uygulamayı yükselter.

Tür:Uri
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationParameter

Uygulama parametrelerinin geçersiz kılmalarını ad/değer çiftleri olarak belirtir.

Tür:Hashtable
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ApplicationTypeVersion

Service Fabric uygulama türünün sürümünü belirtir. cmdlet'i, uygulamayı belirttiğiniz sürüme yükselter.

Tür:String
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ConsiderWarningAsError

Sistem durumu değerlendirmesi sırasında bir uyarı sistem durumu olayının hata olayı olarak ele alıp almayacağını gösterir.

Tür:Boolean
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-DefaultServiceTypeHealthPolicy

İzlenen yükseltme için kullanılacak varsayılan hizmet türünün sistem durumu ilkesini MaxPercentUnhealthyPartitionsPerService, MaxPercentUnhealthyReplicasPerPartition, MaxPercentUnhealthyServices biçiminde belirtir. Örneğin, 5,10,15 aşağıdaki değerleri gösterir:

  • MaxPercentUnhealthyPartitionsPerService = 5
  • MaxPercentUnhealthyReplicasPerPartition = 10
  • MaxPercentUnhealthyServices = 15
Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-FailureAction

İzlenen yükseltme başarısız olursa gerçekleştirecek eylemi belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

  • Geri alma
  • El ile
Tür:UpgradeFailureAction
Kabul edilen değerler:Invalid, Rollback, Manual
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Bu cmdlet'in uyarı iletisini atlayıp yükseltmeye zorlandığını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ForceRestart

Yükseltme yalnızca yapılandırma değişikliği olsa bile hizmet ana bilgisayarının yeniden başlatıldığını gösterir.

Tür:SwitchParameter
Position:3
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckRetryTimeoutSec

Service Fabric'in önceki sistem durumu denetiminin başarısız olup olmadığını yeniden deneme süresini saniye cinsinden belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckStableDurationSec

Service Fabric'in bir sonraki yükseltme etki alanına geçmeden veya yükseltmeyi tamamlamadan önce uygulamanın kararlı olduğunu doğrulamak için bekleyeceği süreyi saniye cinsinden belirtir. Bu bekleme süresi, sistem durumu denetimi gerçekleştirildikten hemen sonra algılanmayan sistem durumu değişikliklerini engeller.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-HealthCheckWaitDurationSec

Service Fabric'in yükseltme etki alanındaki yükseltmeyi tamamladıktan sonra ilk sistem durumu denetimini gerçekleştirmeden önce bekleyeceği süreyi saniye cinsinden belirtir.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InstanceCloseDelayDurationSec

Etkin isteklerin düzgün bir şekilde boşaltılabilmesi için, uygulama yükseltmeden etkilenen durum bilgisi olmayan bir örneğin kapatılması için beklenme süresini saniye cinsinden belirtir. Bu bekleme süresi yalnızca InstanceCloseDelayDuration için sıfır olmayan bir değer yapılandırılmış olan durum bilgisi olmayan hizmetlerin örnekleri için geçerlidir ve önceden yapılandırılmış değeri geçersiz kılar. Ayrıntılar için bkz. InstanceCloseDelayDuration (New-ServiceFabricService) .

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-MaxPercentUnhealthyDeployedApplications

Kümenin uygulama sistem durumu hata olmadan önce sistem durumu hata olan kümedeki düğümlere dağıtılan uygulama örneklerinin en yüksek yüzdesini belirtir.

Tür:Byte
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Monitored

Yükseltme modunun izlendiğini gösterir. Cmdlet bir yükseltme etki alanı için yükseltmeyi tamamladıktan sonra, yükseltme etki alanının ve kümenin sistem durumu tanımladığınız sistem durumu ilkelerini karşılıyorsa, Service Fabric sonraki yükseltme etki alanını yükseltir. Yükseltme etki alanı veya küme sistem durumu ilkelerini karşılayamazsa, yükseltme başarısız olur ve Service Fabric, yükseltme etki alanı için yükseltmeyi geri alır veya belirtilen ilkeye göre el ile moda geri döner. Bu, üretim ortamındaki uygulama yükseltmeleri için önerilen moddur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ReplicaQuorumTimeoutSec

Çoğaltma kümesinin çekirdek olup olmadığını denetlemek için zaman aşımı süresini saniye cinsinden belirtir. Zaman aşımı süresinden sonra yükseltme devam eder.

Bu parametre kullanım dışı bırakıldı. Bunun yerine UpgradeReplicaSetCheckTimeoutSec parametresini belirtin.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RestartProcess

Hizmet ana bilgisayarının yükseltmenin bir parçası olarak yeniden başlatıldığını gösterir.

Bu parametre kullanım dışı bırakıldı. Bunun yerine ForceRestart parametresini belirtin.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ServiceTypeHealthPolicyMap

Farklı hizmet türleri için kullanılacak sistem durumu ilkesinin eşlemesini şu biçimde karma tablo olarak belirtir: @ {"ServiceTypeName" : "MaxPercentUnhealthyPartitionsPerService,MaxPercentUnhealthyReplicasPerPartition,MaxPercentUnhealthyServices"}. Mesela:

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

Tür:Hashtable
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SortOrder

Yükseltmenin kümede devam ettiği sırayı tanımlar.

Olası değerler şunlardır:

  • Invalid - Bu sıralama düzeninin geçerli olmadığını gösterir. Tüm Service Fabric sabit listeleri geçersiz türe sahip.
  • Default - Varsayılan sıralama düzeninin (küme bildiriminde belirtildiği gibi) kullanılacağını gösterir.
  • Numeric - İletilen sayısal sıralama düzeninin (sayı olarak sıralanmış UD adları) kullanılacağını gösterir.
  • Lexicographical - İleri sözcük temelli sıralama düzeninin (dize olarak sıralanmış UD adları) kullanılacağını gösterir.
  • ReverseNumeric - Ters sayısal sıralama düzeninin (sayı olarak sıralanmış UD adları) kullanılacağını gösterir.
  • ReverseLexicographical- Ters sözcük temelli sıralama düzeninin (dize olarak sıralanan UD adları) kullanılacağını gösterir.
Tür:UpgradeSortOrder
Kabul edilen değerler:Invalid, Default, Numeric, Lexicographical, ReverseNumeric, ReverseLexicographical
Position:5
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-TimeoutSec

İşlem için zaman aşımı süresini saniye cinsinden belirtir.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UnmonitoredAuto

Yükseltme modunun izlenmeyen otomatik olduğunu gösterir. Service Fabric bir yükseltme etki alanını yükseltdikten sonra Service Fabric, uygulama sistem durumundan bağımsız olarak bir sonraki yükseltme etki alanını yükseltir. Bu mod üretim için önerilmez ve yalnızca bir uygulamanın geliştirilmesi sırasında kullanışlıdır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UnmonitoredManual

Yükseltme modunun izlenmeyen el ile olduğunu gösterir. Service Fabric bir yükseltme etki alanını yükselttikte, Resume-ServiceFabricApplicationUpgrade cmdlet'ini kullanarak bir sonraki yükseltme etki alanını yükseltmenizi bekler.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeDomainTimeoutSec

Service Fabric'in tek bir yükseltme etki alanını yükseltmesi için gereken en uzun süreyi saniye cinsinden belirtir. Bu süre sonunda yükseltme başarısız olur.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeReplicaSetCheckTimeoutSec

Service Fabric'in, Service Fabric yükseltmeye devam etmeden önce güvenli durumda değilse, hizmetin yeniden yapılandırılmasını bekleyeceği en uzun süreyi belirtir.

Tür:UInt32
Position:4
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UpgradeTimeoutSec

Service Fabric'in tüm yükseltme için gereken en uzun süreyi saniye cinsinden belirtir. Bu süre sonunda yükseltme başarısız olur.

Tür:UInt32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Çıkışlar

System.Object