Självstudie: Uppgradera körningen av ett Service Fabric-kluster i Azure

Den här självstudien är del fyra i en serie och visar hur du uppgraderar Service Fabric-körningen i ett Azure Service Fabric-kluster. Den här självstudiedelen är skriven för Service Fabric-kluster som körs i Azure och gäller inte för fristående Service Fabric-kluster.

Om klustret redan kör den senaste Service Fabric-körningen behöver du inte göra det här steget. Den här artikeln kan dock användas för att installera alla körningar som stöds i ett Azure Service Fabric-kluster.

I den här tutorialen lär du dig följande:

I den här självstudieserien får du lära du dig att:

Förutsättningar

Innan du börjar den här självstudien:

• Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto
• Installera Azure PowerShell eller Azure CLI.
• Skapa ett säkert Windows-kluster i Azure
• Konfigurera en Windows-utvecklingsmiljö. Installera Visual Studio 2019 och Azure-utveckling, ASP.NET och webbutveckling samt arbetsbelastningar för .NET Core-plattformsoberoende utveckling . Konfigurera sedan en .NET-utvecklingsmiljö.

Logga in på Azure

Logga in på ditt Azure-konto och välj din prenumeration innan du kör Azure-kommandon.

Connect-AzAccount
Get-AzSubscription
Set-AzContext -SubscriptionId <guid>

Hämta körtidsversionen

När du har anslutit till Azure, valt prenumerationen som innehåller Service Fabric-klustret, kan du hämta körningsversionen av klustret.

Get-AzServiceFabricCluster -ResourceGroupName SFCLUSTERTUTORIALGROUP -Name aztestcluster `
    | Select-Object ClusterCodeVersion

Du kan också hämta en lista över alla kluster i din prenumeration med följande exempel:

Get-AzServiceFabricCluster | Select-Object Name, ClusterCodeVersion

Observera värdet ClusterCodeVersion. Det här värdet används i nästa avsnitt.

Uppgradera körtiden

Använd värdet för ClusterCodeVersion från föregående avsnitt med cmdleten Get-ServiceFabricRuntimeUpgradeVersion för att identifiera vilka versioner som är tillgängliga att uppgradera till. Den här cmdleten kan bara köras från en dator som är ansluten till Internet. Om du till exempel vill se vilka körningsversioner du kan uppgradera till från version 5.7.198.9494använder du följande kommando:

Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion "5.7.198.9494"

Med en lista över versioner kan du instruera Azure Service Fabric-klustret att uppgradera till en nyare körmiljö. Om versionen 6.0.219.9494 till exempel är tillgänglig att uppgradera till använder du följande kommando för att uppgradera klustret.

Set-AzServiceFabricUpgradeType -ResourceGroupName SFCLUSTERTUTORIALGROUP `
                                    -Name aztestcluster `
                                    -UpgradeMode Manual `
                                    -Version "6.0.219.9494"

Uppgraderingens status kan övervakas med antingen PowerShell eller Azure Service Fabric CLI (sfctl).

Anslut först till klustret med TLS/SSL-certifikatet som skapades i den första delen av självstudien. Använd cmdleten Connect-ServiceFabricCluster eller sfctl cluster upgrade-status.

$endpoint = "<mycluster>.southcentralus.cloudapp.azure.com:19000"
$thumbprint = "AA11BB22CC33DD44EE55FF66AA77BB88CC99DD00"

Connect-ServiceFabricCluster -ConnectionEndpoint $endpoint `
                             -KeepAliveIntervalInSec 10 `
                             -X509Credential -ServerCertThumbprint $thumbprint `
                             -FindType FindByThumbprint -FindValue $thumbprint `
                             -StoreLocation CurrentUser -StoreName My

sfctl cluster select --endpoint https://aztestcluster.southcentralus.cloudapp.azure.com:19080 \
--pem ./aztestcluster201709151446.pem --no-verify

Get-ServiceFabricClusterUpgrade Använd sedan eller sfctl cluster upgrade-status för att visa statusen. Något som liknar följande resultat visas.

Get-ServiceFabricClusterUpgrade

TargetCodeVersion                          : 6.0.219.9494
TargetConfigVersion                        : 3
StartTimestampUtc                          : 11/28/2017 3:09:48 AM
UpgradeState                               : RollingForwardPending
UpgradeDuration                            : 00:09:00
CurrentUpgradeDomainDuration               : 00:09:00
NextUpgradeDomain                          : 1
UpgradeDomainsStatus                       : { "0" = "Completed";
                                             "1" = "Pending";
                                             "2" = "Pending";
                                             "3" = "Pending";
                                             "4" = "Pending" }
UpgradeKind                                : Rolling
RollingUpgradeMode                         : Monitored
FailureAction                              : Rollback
ForceRestart                               : False
UpgradeReplicaSetCheckTimeout              : 37201.09:59:01
HealthCheckWaitDuration                    : 00:05:00
HealthCheckStableDuration                  : 00:05:00
HealthCheckRetryTimeout                    : 00:45:00
UpgradeDomainTimeout                       : 02:00:00
UpgradeTimeout                             : 12:00:00
ConsiderWarningAsError                     : False
MaxPercentUnhealthyApplications            : 0
MaxPercentUnhealthyNodes                   : 100
ApplicationTypeHealthPolicyMap             : {}
EnableDeltaHealthEvaluation                : True
MaxPercentDeltaUnhealthyNodes              : 0
MaxPercentUpgradeDomainDeltaUnhealthyNodes : 0
ApplicationHealthPolicyMap                 : {}

sfctl cluster upgrade-status

{
  "codeVersion": "6.0.219.9494",
  "configVersion": "3",

... item cut to save space ...

  },
  "upgradeDomains": [
    {
      "name": "0",
      "state": "Completed"
    },
    {
      "name": "1",
      "state": "Pending"
    },
    {
      "name": "2",
      "state": "Pending"
    },
    {
      "name": "3",
      "state": "Pending"
    },
    {
      "name": "4",
      "state": "Pending"
    }
  ],
  "upgradeDurationInMilliseconds": "PT1H2M4.63889S",
  "upgradeState": "RollingForwardPending"
}

Nästa steg

I den här handledningen lärde du dig att:

Gå vidare till nästa kurs: