Dela via

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

  • Artikel

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.

Varning

För den delen av kursen krävs PowerShell. Stöd för uppgradering av klusterkörning finns inte i Azure CLI-verktygen ännu. Ett kluster kan också uppgraderas på portalen. Mer information finns i Uppgradera till ett Azure 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 stödda körningar på ett Azure Service Fabric-kluster.

I den här självstudien lär du dig att:

  • läser klusterversionen
  • ställer in klusterversionen.

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

Kommentar

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Information om hur du kommer igång finns i Installera Azure PowerShell. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.

Förutsättningar

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

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örningsversion

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

Notera värdet för ClusterCodeVersion. Det här värdet används i nästa avsnitt.

Uppgradera körningsmiljön

Använd värdet för ClusterCodeVersion från föregående avsnitt tillsammans med cdmlet Get-ServiceFabricRuntimeUpgradeVersion för att identifiera vilka versioner du kan uppgradera till. Denna cmdlet kan endast 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.9494 använder du följande kommando:

Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion "5.7.198.9494"

Med en versionslista kan du instruera Azure Service Fabric-klustret att uppgradera till en nyare körning. Om till exempel version 6.0.219.9494 är tillgänglig använder du följande kommando för att uppgradera klustret.

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

Viktigt!

Uppgraderingen av klusterkörningen kan ta lång tid att slutföra. PowerShell blockeras när uppgraderingen körs. Du kan använda en annan PowerShell-session för att kontrollera uppgraderingens status.

Status för uppgraderingen kan övervakas med antingen PowerShell eller Azure Service Fabrix CLI (sfctl).

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

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

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

Använd sedan Get-ServiceFabricClusterUpgrade 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 självstudiekursen lärde du dig att:

  • Hämta versionen av klusterkörningen
  • Uppgradera körningstiden för kluster
  • Övervaka uppgraderingen

Gå vidare till nästa kurs:

Ta bort ett kluster