Kümenizde çalışan Service Fabric sürümünü yükseltme

Makale
06/01/2023

Herhangi bir modern sistem için yükseltme yeteneği, ürününüzün uzun vadeli başarısının anahtarıdır. Azure Service Fabric kümesi, sahip olduğunuz bir kaynaktır. Bu makalede, tek başına kümenizde çalışan Service Fabric sürümünü yükseltme açıklanır.

Not

Kümenizin her zaman desteklenen bir Service Fabric sürümü çalıştırdığından emin olun. Microsoft, Service Fabric'in yeni bir sürümünün yayınlanmasını duyurduğunda, önceki sürüm duyuru tarihinden itibaren en az 60 gün sonra destek sonu olarak işaretlenir. Yeni sürümler Service Fabric ekip blogundan duyurulur. Yeni sürüm bu noktada seçilebilir.

Kümenizi yeni sürüme yükseltebilmeniz için her Service Fabric düğümünü ayrı bir fiziksel veya sanal makinede ayırdığınız üretim stilinde bir düğüm yapılandırması kullanmanız gerekir. Tek bir fiziksel veya sanal makinede birden fazla Service Fabric düğümü bulunan bir geliştirme kümeniz varsa, kümeyi yeni sürümle yeniden oluşturmanız gerekir.

İki farklı iş akışı kümenizi en son sürüme veya desteklenen bir Service Fabric sürümüne yükseltebilir. İş akışlarından biri, bağlantısı olan kümelerin en son sürümü otomatik olarak indirmesidir. Diğer iş akışı, en son Service Fabric sürümünü indirmek için bağlantısı olmayan kümelere yöneliktir.

Kümenizin Service Fabric sürümünün otomatik yükseltmesini etkinleştirme

Microsoft yeni bir sürüm yayımladığında kümenizi Service Fabric güncelleştirmelerini indirecek şekilde ayarlamak için küme yapılandırmasını true olarak ayarlayınfabricClusterAutoupgradeEnabled. Kümenizin açık olmasını istediğiniz desteklenen bir Service Fabric sürümünü el ile seçmek için küme yapılandırmasını false olarak ayarlayınfabricClusterAutoupgradeEnabled.

En son kodu ve yapılandırmayı indirmek için bağlantısı olan kümeleri yükseltme

Küme düğümlerinizin Microsoft İndirme Merkezi'ne İnternet bağlantısı varsa kümenizi desteklenen bir sürüme yükseltmek için bu adımları kullanın.

Microsoft İndirme Merkezi bağlantısı olan kümeler için, Microsoft düzenli aralıklarla yeni Service Fabric sürümlerinin kullanılabilirliğini denetler.

Yeni bir Service Fabric sürümü kullanılabilir olduğunda, paket kümeye yerel olarak indirilir ve yükseltme için sağlanır. Ayrıca, müşteriyi bu yeni sürüm hakkında bilgilendirmek için sistem aşağıdakine benzer açık bir küme durumu uyarısı gösterir:

"Geçerli küme sürümü [sürüm #] desteği [date] sona eriyor."

Küme en son sürümü çalıştırdıktan sonra uyarı kaybolur.

Küme durumu uyarısını gördüğünüzde kümeyi yükseltin:

Kümede düğüm olarak listelenen tüm makinelere yönetici erişimi olan herhangi bir makineden kümeye bağlanın. Bu betiğin üzerinde çalıştırdığı makinenin kümenin parçası olması gerekmez.

###### connect to the secure cluster using certs
$ClusterName= "mysecurecluster.something.com:19000"
$CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7FG2D630F8F3"
Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 `
    -X509Credential `
    -ServerCertThumbprint $CertThumbprint  `
    -FindType FindByThumbprint `
    -FindValue $CertThumbprint `
    -StoreLocation CurrentUser `
    -StoreName My

Yükseltebileceğiniz Service Fabric sürümlerinin listesini alın.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Şuna benzer bir çıkış almanız gerekir:
Start-ServiceFabricClusterUpgrade Windows PowerShell komutunu kullanarak kullanılabilir bir sürüme küme yükseltmesi başlatın.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example

Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Yükseltmenin ilerleme durumunu izlemek için Service Fabric Explorer kullanabilir veya aşağıdaki PowerShell komutunu çalıştırabilirsiniz:
```
Get-ServiceFabricClusterUpgrade
```
Küme sistem durumu ilkeleri karşılanmazsa yükseltme geri alınır. Start-ServiceFabricClusterUpgrade komutu için özel sistem durumu ilkeleri belirtmek için Start-ServiceFabricClusterUpgrade belgelerine bakın.

Geri alma işlemiyle sonuçlanan sorunları düzeltdikten sonra, daha önce açıklanan adımları izleyerek yükseltmeyi yeniden başlatın.

En son kodu ve yapılandırmayı indirmek için bağlantısı olmayan kümeleri yükseltme

Küme düğümlerinizin Microsoft İndirme Merkezi'ne İnternet bağlantısı yoksa kümenizi desteklenen bir sürüme yükseltmek için bu adımları kullanın.

Not

İnternet'e bağlı olmayan bir küme çalıştırıyorsanız, yeni sürümler hakkında bilgi edinmek için Service Fabric ekip blogunu izlemeniz gerekir. Sistem, sizi yeni sürümler konusunda uyarmak için küme durumu uyarısı göstermez.

Otomatik sağlama ve el ile sağlama karşılaştırması

En son kod sürümü için otomatik indirmeyi ve kaydı etkinleştirmek için Service Fabric Güncelleştirme Hizmeti'ni ayarlayın. Yönergeler için bkz. tek başına pakettekiTools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt.

El ile gerçekleştirilen işlem için bu yönergeleri izleyin.

Yapılandırma yükseltmesini başlatmadan önce aşağıdaki özelliği false olarak ayarlamak için küme yapılandırmanızı değiştirin:

"fabricClusterAutoupgradeEnabled": false,

Kullanım ayrıntıları için bkz. Start-ServiceFabricClusterConfigurationUpgrade PowerShell komutu. Yapılandırma yükseltmesini başlatmadan önce JSON'unuzda 'clusterConfigurationVersion' öğesini güncelleştirdiğinizden emin olun.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Küme yükseltme iş akışı

Kümedeki düğümlerden birinden Get-ServiceFabricClusterUpgrade komutunu çalıştırın ve TargetCodeVersion'a dikkat edin.
Geçerli sürümle tüm yükseltme uyumlu sürümleri listelemek ve ilişkili indirme bağlantılarından ilgili paketi indirmek için İnternet'e bağlı bir makineden aşağıdakileri çalıştırın:
```
###### Get list of all upgrade compatible packages  
Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
```

###### Get the list of available Service Fabric versions
Copy-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file including the path to it> -ImageStoreConnectionString "fabric:ImageStore"

###### Here is a filled-out example
Copy-ServiceFabricClusterPackage -Code -CodePackagePath .\MicrosoftAzureServiceFabric.5.3.301.9590.cab -ImageStoreConnectionString "fabric:ImageStore"

İndirilen paketi küme görüntü deposuna kopyalayın.

Kopyalanan paketi kaydedin.

###### Get the list of available Service Fabric versions
Register-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file>

###### Here is a filled-out example
Register-ServiceFabricClusterPackage -Code -CodePackagePath MicrosoftAzureServiceFabric.5.3.301.9590.cab

Kullanılabilir bir sürüme küme yükseltmesi başlatın.
```
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback

###### Here is a filled-out example
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
```
Yükseltmenin ilerleme durumunu Service Fabric Explorer izleyebilir veya aşağıdaki PowerShell komutunu çalıştırabilirsiniz:
```
Get-ServiceFabricClusterUpgrade
```
Küme sistem durumu ilkeleri karşılanmazsa yükseltme geri alınır. Start-ServiceFabricClusterUpgrade komutu için özel sistem durumu ilkeleri belirtmek için Start-ServiceFabricClusterUpgrade belgelerine bakın.

Geri alma işlemiyle sonuçlanan sorunları düzeltdikten sonra, daha önce açıklanan adımları izleyerek yükseltmeyi yeniden başlatın.

Share via