Upgraden der in Ihrem Cluster ausgeführten Service Fabric-Version

Artikel
06/01/2023

Für alle modernen Systeme ist die Möglichkeit eines Upgrades der Schlüssel zum langfristigen Erfolg des Produkts. Ein Azure Service Fabric-Cluster ist eine Ressource, die sich in Ihrem Besitz befindet. In diesem Artikel erfahren Sie, wie Sie die in Ihrem eigenständigen Cluster ausgeführte Service Fabric-Version upgraden.

Hinweis

Achten Sie darauf, dass in Ihrem Cluster immer eine unterstützte Service Fabric-Version ausgeführt wird. Wenn Microsoft eine neue Service Fabric-Version ankündigt, beträgt die verbleibende Supportdauer der vorherigen Version noch mindestens 60 Tage ab dem Datum der Ankündigung. Neue Releases werden im Blog des Service Fabric-Teams angekündigt. Ab dann kann das neue Release ausgewählt werden.

Sie können Ihren Cluster nur auf die neue Version upgraden, wenn Sie eine Knotenkonfiguration im Produktionsformat verwenden, bei der jeder Service Fabric-Knoten einem separaten physischen oder virtuellen Computer zugeordnet ist. Wenn Sie einen Entwicklungscluster mit mehreren Service Fabric-Knoten auf einem physischen oder virtuellen Computer haben, müssen Sie Ihren Cluster mit der neuen Version neu erstellen.

Für das Upgrade Ihres Clusters auf die aktuelle oder eine unterstützte Service Fabric-Version gibt es zwei unterschiedliche Workflows. Ein Workflow ist für Cluster vorgesehen, die über Konnektivität verfügen, um die neuesten Versionen automatisch herunterzuladen. Der andere Workflow ist für Cluster vorgesehen, die nicht über Konnektivität verfügen, um die neueste Service Fabric-Version automatisch herunterzuladen.

Aktivieren automatischer Upgrades für die Service Fabric-Version Ihres Clusters

Falls Ihr Cluster Updates von Service Fabric herunterladen soll, wenn Microsoft eine neue Version veröffentlicht, legen Sie die Clusterkonfiguration fabricClusterAutoupgradeEnabled auf true fest. Wenn Sie für Ihren Cluster manuell eine unterstützte Version von Service Fabric auswählen möchten, legen Sie die Clusterkonfiguration fabricClusterAutoupgradeEnabled auf false fest.

Aktualisieren der Cluster mit Konnektivität zum Herunterladen des aktuellen Codes und der Konfiguration

Führen Sie diese Schritte aus, um Ihren Cluster auf eine unterstützte Version upzugraden, wenn Ihre Clusterknoten eine Internetverbindung mit dem Microsoft Download Center haben.

Für Cluster mit Verbindung zum Microsoft Download Center überprüft Microsoft in regelmäßigen Abständen die Verfügbarkeit neuer Service Fabric-Versionen.

Wenn eine neue Service Fabric-Version verfügbar ist, wird das Paket lokal in den Cluster heruntergeladen und für das Upgrade bereitgestellt. Um den Kunden außerdem über diese neue Version zu informieren, zeigt das System eine explizite Clusterintegritätswarnung ähnlich der folgenden an:

„Der Support für die aktuelle Clusterversion [Versionsnummer] endet am [Datum].“

Wenn der Cluster die neueste Version ausführt, wird diese Warnung nicht mehr angezeigt.

Wenn die Clusterintegritätswarnung angezeigt wird, führen Sie ein Upgrade für den Cluster durch:

Stellen Sie auf einem Computer mit Administratorzugriffsrechten auf alle Computer, die als Knoten in der Clusterkonfigurationsdatei aufgeführt sind, eine Verbindung mit dem Cluster her. Der Computer, auf dem dieses Skript ausgeführt wird, muss nicht Teil des Clusters sein.

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

Rufen Sie die Liste der Service Fabric-Versionen ab, auf die Sie ein Upgrade durchführen können.
```
###### Get the list of available Service Fabric versions
Get-ServiceFabricRegisteredClusterCodeVersion
```
Die Ausgabe sollte in etwa wie folgt aussehen:
Starten Sie mithilfe des Windows PowerShell-Befehls Start-ServiceFabricClusterUpgrade ein Clusterupgrade auf eine verfügbare Version.
```
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
```
Um den Fortschritt des Upgrades zu verfolgen, können Sie Service Fabric Explorer nutzen oder den folgenden Windows PowerShell-Befehl ausführen:
```
Get-ServiceFabricClusterUpgrade
```
Wenn die Integritätsrichtlinien des Clusters nicht erfüllt sind, wird für das Upgrade ein Rollback ausgeführt. Wie Sie benutzerdefinierte Integritätsrichtlinien für den Befehl „Start-ServiceFabricClusterUpgrade“ angeben, erfahren Sie in der Dokumentation zu Start-ServiceFabricClusterUpgrade.

Nachdem Sie die Probleme behoben haben, die zu dem Rollback geführt haben, initiieren Sie das Upgrade erneut, indem Sie die gleichen Schritte wie zuvor beschrieben ausführen.

Aktualisieren der Cluster ohne Konnektivität zum Herunterladen des aktuellen Codes und der Konfiguration

Führen Sie diese Schritte aus, um Ihren Cluster auf eine unterstützte Version upzugraden, wenn zwischen Ihrem Clusterknoten und dem Microsoft Download Center keine Internetverbindung besteht.

Hinweis

Wenn Sie einen Cluster ohne Internetverbindung betreiben, prüfen Sie im Service Fabric-Teamblog, ob ein neues Release verfügbar ist. Das System zeigt keine Clusterintegritätswarnung an, um Sie über neue Releases zu unterrichten.

Automatische Bereitstellung im Vergleich zur manuellen Bereitstellung

Richten Sie den Service Fabric-Updatedienst ein, um das automatische Herunterladen und Registrieren für die neueste Codeversion zu aktivieren. Eine Anleitung finden Sie im eigenständigen Paket in der Datei Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt.

Befolgen Sie für die manuelle Vorgehensweise die Anweisungen unten.

Ändern Sie die Clusterkonfiguration, um die folgende Eigenschaft auf false festzulegen, bevor Sie mit dem Konfigurationsupgrade beginnen:

"fabricClusterAutoupgradeEnabled": false,

Nutzungsdetails finden Sie in den Informationen zum PowerShell-Befehl Start-ServiceFabricClusterConfigurationUpgrade. Achten Sie darauf, den Wert für „clusterConfigurationVersion“ in der JSON-Datei zu aktualisieren, bevor Sie das Konfigurationsupgrade starten.

    Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>

Workflow für das Upgrade des Clusters

Führen Sie Get-ServiceFabricClusterUpgrade auf einem der Knoten im Cluster aus, und notieren Sie sich den Wert von TargetCodeVersion.
Führen Sie Folgendes auf einem mit dem Internet verbundenen Computer aus, um alle mit dem Upgrade kompatiblen Versionen mit der aktuellen Version aufzulisten und das entsprechende Paket über die zugehörigen Downloadlinks herunterzuladen:
```
###### 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"

Kopieren Sie das heruntergeladene Paket in den Clusterimagespeicher.

Registrieren Sie das kopierte Paket.

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

Starten Sie ein Clusterupgrade auf eine verfügbare Version.
```
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
```
Sie können den Fortschritt des Upgrades in Service Fabric Explorer oder durch Ausführen des folgenden PowerShell-Befehls verfolgen:
```
Get-ServiceFabricClusterUpgrade
```
Wenn die Integritätsrichtlinien des Clusters nicht erfüllt sind, wird für das Upgrade ein Rollback ausgeführt. Wie Sie benutzerdefinierte Integritätsrichtlinien für den Befehl „Start-ServiceFabricClusterUpgrade“ angeben, erfahren Sie in der Dokumentation zu Start-ServiceFabricClusterUpgrade.

Nachdem Sie die Probleme behoben haben, die zu dem Rollback geführt haben, initiieren Sie das Upgrade erneut, indem Sie die gleichen Schritte wie zuvor beschrieben ausführen.