Hantera service fabric-hanterade klusteruppgraderingar

Ett Azure Service Fabric-kluster är en resurs som du äger, men det hanteras delvis av Microsoft. Så här hanterar du när och hur Microsoft uppdaterar din Azure Service Fabric-hanterade klusterkörning.

Ange uppgraderingsläge

Azure Service Fabric-hanterade kluster är som standard inställda på att ta emot automatiska Service Fabric-uppgraderingar när de släpps av Microsoft med hjälp av en strategi för vågdistribution . Alternativt kan du konfigurera uppgraderingar i manuellt läge där du väljer från en lista över versioner som stöds för närvarande. Du kan konfigurera de här inställningarna antingen via kontrollen Infrastrukturuppgraderingar i Azure-portalen eller inställningen i mallen ClusterUpgradeMode för klusterdistribution.

Vågdistribution för automatiska uppgraderingar

Med vågdistribution kan du skapa en pipeline för att uppgradera dina test-, fas- och produktionskluster i följd, avgränsade med inbyggd "bake time" för att verifiera kommande Service Fabric-versioner innan dina produktionskluster uppdateras.

Kommentar

Som standard anges kluster till Våg 0.

Om du vill välja en vågdistribution för automatisk uppgradering ska du först avgöra vilken våg som ska tilldela klustret:

  • Våg 0 (Wave0): Kluster uppdateras så snart en ny Service Fabric-version släpps.
  • Våg 1 (Wave1): Kluster uppdateras efter Våg 0 för att möjliggöra bakningstid. Våg 1 inträffar efter minst 7 dagar efter våg 0.
  • Våg 2 (Wave2): Kluster uppdateras senast för att möjliggöra ytterligare bakningstid. Våg 2 inträffar efter minst 14 dagar efter våg 0.

Ange Wave för klustret

Du kan ställa in klustret på en av de tillgängliga vågarna antingen via kontrollen Infrastrukturuppgraderingar i Azure-portalen eller ClusterUpgradeMode inställningen i klusterdistributionsmallen.

Azure Portal

Med Hjälp av Azure-portalen väljer du mellan tillgängliga automatiska vågor när du skapar ett nytt Service Fabric-kluster.

Välj mellan olika tillgängliga vågor när du skapar ett nytt kluster i Azure-portalen från alternativen

Du kan också växla mellan tillgängliga automatiska vågor från avsnittet Infrastrukturuppgraderingar i en befintlig klusterresurs.

Välj mellan olika automatiska vågor i avsnittet Infrastrukturuppgraderingar i klusterresursen i Azure-portalen

Resource Manager-mall

Om du vill ändra läget för klusteruppgradering med hjälp av en Resource Manager-mall anger du antingen Automatisk eller Manuell för egenskapen för ClusterUpgradeMode resursdefinitionen Microsoft.ServiceFabric/clusters . Om du väljer manuella uppgraderingar anger du clusterCodeVersion även till en infrastrukturresursversion som stöds för närvarande.

Manuell uppgradering

{
  "apiVersion": "2021-05-01",
  "type": "Microsoft.ServiceFabric/managedClusters",
  "properties": {
    "clusterUpgradeMode": "Manual",
    "clusterCodeVersion": "8.0.514.9590"
  }
}

När mallen har distribuerats tillämpas ändringar i klusteruppgraderingsläget. Om klustret är i manuellt läge startar klusteruppgradningen automatiskt.

Klustrets hälsoprinciper (en kombination av nodhälsa och hälsotillståndet för alla program som körs i klustret) följs under uppgraderingen. Om klustrets hälsoprinciper inte uppfylls återställs uppgraderingen.

Om en återställning inträffar måste du åtgärda de problem som resulterade i återställningen och initiera uppgraderingen igen genom att följa samma steg som tidigare.

Automatisk uppgradering med vågdistribution

Om du vill konfigurera automatiska uppgraderingar och vågdistributionen är det bara att lägga till/verifiera ClusterUpgradeMode är inställt på Automatic och clusterUpgradeCadence egenskapen definieras med ett av vågvärdena som anges ovan i Resource Manager-mallen.

{
  "apiVersion": "2021-05-01",
  "type": "Microsoft.ServiceFabric/managedClusters",
  "properties": {
    "clusterUpgradeMode": "Automatic",
    "clusterUpgradeCadence": "Wave1"
  }
}

När du har distribuerat den uppdaterade mallen registreras klustret i den angivna vågen för automatiska uppgraderingar.

Fråga efter klusterversioner som stöds

Du kan använda Azure REST API för att visa alla tillgängliga Service Fabric-körningsversioner (clusterVersions) tillgängliga för den angivna platsen och din prenumeration.

Du kan också referera till Service Fabric-versioner för ytterligare information om versioner och operativsystem som stöds.

GET https://<endpoint>/subscriptions/{{subscriptionId}}/providers/Microsoft.ServiceFabric/locations/{{location}}/managedclusterVersions?api-version=2021-05-01

"value": [
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/7.2.477.9590",
    "name": "7.2.477.9590",
    "type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
    "properties": {
      "supportExpiryUtc": "2021-11-30T00:00:00",
      "osType": "Windows",
      "clusterCodeVersion": "7.2.477.9590"
    }
  },
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/locations/eastus2/environments/Windows/managedClusterVersions/8.0.514.9590",
    "name": "8.0.514.9590",
    "type": "Microsoft.ServiceFabric/locations/environments/managedClusterVersions",
    "properties": {
      "supportExpiryUtc": "9999-12-31T23:59:59.9999999",
      "osType": "Windows",
      "clusterCodeVersion": "8.0.514.9590"
    }
  }
]

I supportExpiryUtc utdatarapporterna när en viss version upphör att gälla eller har upphört att gälla. De senaste versionerna har inget giltigt datum, utan ett värde på 9999-12-31T23:59:59.99999999, vilket bara innebär att förfallodatumet ännu inte har angetts.

Nästa steg