Service Fabric-clusterupgrades beheren

Een Azure Service Fabric-cluster is een resource die u bezit, maar wordt deels beheerd door Microsoft. U kunt als volgt beheren wanneer en hoe Microsoft uw Azure Service Fabric-cluster bijwerken.

Zie Azure Service Fabric-clusters upgraden en bijwerken voor meer achtergrondinformatie over concepten en processen voor clusterupgrades.

Upgrademodus instellen

U kunt instellen dat uw cluster automatische Service Fabric-upgrades ontvangt wanneer deze door Microsoft worden uitgebracht, of u kunt handmatig kiezen uit een lijst met momenteel ondersteunde versies door de upgrademodus voor uw cluster in te stellen. U kunt dit doen via het beheer van de infrastructuurupgrademodus in Azure Portal of de upgradeMode instelling in uw clusterimplementatiesjabloon.

Azure Portal

Met Azure Portal kiest u tussen automatische of handmatige upgrades bij het maken van een nieuw Service Fabric-cluster.

U kunt ook schakelen tussen automatische of handmatige upgrades vanuit de sectie Fabric-upgrades van een bestaande clusterresource.

Handmatige upgrades met Azure Portal

Wanneer u de optie voor handmatige upgrade selecteert, hoeft u alleen maar een upgrade te starten door een upgrade te selecteren in de vervolgkeuzelijst beschikbare versies en vervolgens Opslaan. Van daaruit wordt de clusterupgrade onmiddellijk gestart.

Het clusterstatusbeleid (een combinatie van knooppuntstatus en de status van alle toepassingen die in het cluster worden uitgevoerd) worden tijdens de upgrade nageleefd. Als niet aan het clusterstatusbeleid wordt voldaan, wordt de upgrade teruggedraaid.

Nadat u de problemen hebt opgelost die hebben geleid tot het terugdraaien, moet u de upgrade opnieuw starten door dezelfde stappen te volgen als voorheen.

Resource Manager-sjabloon

Als u de upgrademodus voor het cluster wilt wijzigen met behulp van een Resource Manager-sjabloon, geeft u Automatisch of Handmatig op voor de upgradeMode eigenschap van de resourcedefinitie Microsoft.ServiceFabric/clusters. Als u handmatige upgrades kiest, stelt u ook de optie in clusterCodeVersion op een infrastructuurversie die momenteel wordt ondersteund.

Na een geslaagde implementatie van de sjabloon worden wijzigingen in de upgrademodus van het cluster toegepast. Als uw cluster zich in de handmatige modus bevindt, wordt de clusterupgrade automatisch gestart.

Het clusterstatusbeleid (een combinatie van knooppuntstatus en de status van alle toepassingen die in het cluster worden uitgevoerd) worden tijdens de upgrade nageleefd. Als niet aan het clusterstatusbeleid wordt voldaan, wordt de upgrade teruggedraaid.

Nadat u de problemen hebt opgelost die hebben geleid tot het terugdraaien, moet u de upgrade opnieuw starten door dezelfde stappen te volgen als voorheen.

Golfimplementatie voor automatische upgrades

Met de automatische upgrademodus hebt u de mogelijkheid om uw cluster in te schakelen voor golfimplementatie. Met golfimplementatie kunt u een pijplijn maken voor het upgraden van uw test-, fase- en productieclusters op volgorde, gescheiden door ingebouwde bake time om toekomstige Service Fabric-versies te valideren voordat uw productieclusters worden bijgewerkt.

Golfimplementatie inschakelen

Notitie

Voor de wave-implementatie is de API-versie 2020-12-01-preview (of hoger) vereist voor uw Resource Microsoft.ServiceFabric/clusters .

Als u wave-implementatie wilt inschakelen voor automatische upgrade, moet u eerst bepalen welke golf u aan uw cluster wilt toewijzen:

• Wave 0 (Wave0): Clusters worden bijgewerkt zodra een nieuwe Service Fabric-build wordt uitgebracht. Bedoeld voor test-/ontwikkelclusters.
• Wave 1 (Wave1): Clusters worden één week (zeven dagen) bijgewerkt nadat een nieuwe build is uitgebracht. Bedoeld voor pre-prod-/faseringsclusters.
• Golf 2 (Wave2): Clusters worden twee weken (14 dagen) bijgewerkt nadat een nieuwe build is uitgebracht. Bedoeld voor productieclusters.

Voeg vervolgens een upgradeWave eigenschap toe aan uw clusterresourcesjabloon met een van de bovenstaande golfwaarden. Zorg ervoor dat de API-versie van uw clusterresource is 2020-12-01-preview of hoger.

{
    "apiVersion": "2020-12-01-preview",
    "type": "Microsoft.ServiceFabric/clusters",
     ...
        "fabricSettings": [...],
        "managementEndpoint": ...,
        "nodeTypes": [...],
        "provisioningState": ...,
        "reliabilityLevel": ...,
        "upgradeMode": "Automatic",
        "upgradeWave": "Wave1",
       ...

Zodra u de bijgewerkte sjabloon hebt geïmplementeerd, wordt uw cluster ingeschreven in de opgegeven golf voor de volgende upgradeperiode en daarna.

U kunt zich registreren voor e-mailmeldingen met koppelingen voor verdere hulp als een clusterupgrade mislukt.

Registreren voor meldingen

U kunt zich registreren voor meldingen wanneer een clusterupgrade mislukt. Er wordt een e-mailbericht verzonden naar uw aangewezen e-mailadres(en) met meer informatie over de upgradefout en koppelingen naar verdere hulp.

Notitie

Registratie in golfimplementatie is niet vereist voor het ontvangen van meldingen voor upgradefouten.

Als u zich wilt registreren voor meldingen, voegt u een notifications sectie toe aan uw clusterresourcesjabloon en wijst u een of meer e-mailadressen (ontvangers) aan om meldingen te ontvangen:

    "apiVersion": "2020-12-01-preview",
    "type": "Microsoft.ServiceFabric/clusters",
     ...
        "upgradeMode": "Automatic",
        "upgradeWave": "Wave1",
        "notifications": [
        {
            "isEnabled": true,
            "notificationCategory": "WaveProgress",
            "notificationLevel": "Critical",
            "notificationTargets": [
            {
                "notificationChannel": "EmailUser",
                "receivers": [
                    "devops@contoso.com"
                ]
            }]
        }]

Zodra u de bijgewerkte sjabloon hebt geïmplementeerd, wordt u ingeschreven voor meldingen over upgradefouten.

Aangepast beleid voor handmatige upgrades

U kunt aangepast statusbeleid opgeven voor handmatige clusterupgrades. Deze beleidsregels worden toegepast telkens wanneer u een nieuwe runtimeversie selecteert, waardoor het systeem wordt geactiveerd om de upgrade van uw cluster te starten. Als u het beleid niet overschrijft, worden de standaardinstellingen gebruikt.

U kunt het aangepaste statusbeleid opgeven of de huidige instellingen bekijken in de sectie Infrastructuurupgrades van uw clusterresource in Azure Portal door aangepaste optie voor upgradebeleid te selecteren.

Controleren op ondersteunde clusterversies

U kunt verwijzen naar Service Fabric-versies voor meer informatie over ondersteunde versies en besturingssystemen.

U kunt azure REST API ook gebruiken om alle beschikbare Service Fabric Runtime-versies (clusterVersions) weer te geven die beschikbaar zijn voor de opgegeven locatie en uw abonnement.

GET https://<endpoint>/subscriptions/{{subscriptionId}}/providers/Microsoft.ServiceFabric/locations/{{location}}/clusterVersions?api-version=2018-02-01

"value": [
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/environments/Windows/clusterVersions/5.0.1427.9490",
    "name": "5.0.1427.9490",
    "type": "Microsoft.ServiceFabric/environments/clusterVersions",
    "properties": {
      "codeVersion": "5.0.1427.9490",
      "supportExpiryUtc": "2016-11-26T23:59:59.9999999",
      "environment": "Windows"
    }
  },
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/environments/Windows/clusterVersions/4.0.1427.9490",
    "name": "5.1.1427.9490",
    "type": " Microsoft.ServiceFabric/environments/clusterVersions",
    "properties": {
      "codeVersion": "5.1.1427.9490",
      "supportExpiryUtc": "9999-12-31T23:59:59.9999999",
      "environment": "Windows"
    }
  },
  {
    "id": "subscriptions/########-####-####-####-############/providers/Microsoft.ServiceFabric/environments/Windows/clusterVersions/4.4.1427.9490",
    "name": "4.4.1427.9490",
    "type": " Microsoft.ServiceFabric/environments/clusterVersions",
    "properties": {
      "codeVersion": "4.4.1427.9490",
      "supportExpiryUtc": "9999-12-31T23:59:59.9999999",
      "environment": "Linux"
    }
  }
]
}

De supportExpiryUtc in de uitvoerrapporten wanneer een bepaalde release verloopt of is verlopen. De meest recente releases hebben geen geldige datum, maar een waarde van 9999-12-31T23:59:59.9999999, wat betekent dat de vervaldatum nog niet is ingesteld.

Controleren op ondersteund upgradepad

U kunt verwijzen naar de documentatie over Service Fabric-versies voor ondersteunde upgradepaden en gerelateerde versiegegevens.

Met behulp van ondersteunde informatie over de doelversie kunt u de volgende PowerShell-stappen gebruiken om het ondersteunde upgradepad te valideren.

1. Meld u aan bij Azure

   Login-AzAccount
   

2. Het abonnement selecteren

   Set-AzContext -SubscriptionId <your-subscription>
   

3. De API aanroepen

   $params = @{ "TargetVersion" = "<target version>"}
   Invoke-AzResourceAction -ResourceId <cluster resource id> -Parameters $params -Action listUpgradableVersions -Force
   

   Voorbeeld:

   $params = @{ "TargetVersion" = "8.1.335.9590"}
   Invoke-AzResourceAction -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/myResourceGroup/providers/Microsoft.ServiceFabric/clusters/myCluster -Parameters $params -Action listUpgradableVersions -Force
   
   Output
   supportedPath
   -------------
   {8.1.329.9590, 8.1.335.9590}
   

Volgende stappen

• Service Fabric-upgrades beheren
• Uw Service Fabric-clusterinstellingen aanpassen
• Uw cluster in- en uitschalen
• Meer informatie over toepassingsupgrades