Rolling upgrades configureren voor virtuele-machineschaalsets

Notitie

Beleid voor rolling upgrades is alleen beschikbaar voor Virtuele-machineschaalsets met Uniform Orchestration.

Rolling upgradebeleid is de veiligste manier om updates toe te passen op exemplaren in een virtuele-machineschaalset. Door updates in batches uit te voeren, zorgt u ervoor dat uw schaalset een vast aantal exemplaren onderhoudt om verkeer te nemen, wat betekent dat u uw hele werkbelasting niet hoeft uit te schakelen om een wijziging aan te brengen.

Beleid voor rolling upgrades is het meest geschikt voor productieworkloads.

Vereisten

• Als u een rolling upgrade-beleid gebruikt, moet de schaalset een statustest hebben of de toepassingsstatusextensie gebruiken om de toepassingsstatus te bewaken.

• Als u rolling upgrades gebruikt met MaxSurge, worden nieuwe VM's gemaakt met behulp van het meest recente schaalsetmodel om VM's te vervangen met behulp van het oude schaalsetmodel. Deze nieuw gemaakte VM's hebben nieuwe exemplaar-id's en IP-adressen. Zorg ervoor dat u voldoende quotum en adresruimte in uw subnet hebt om deze nieuwe VM's te kunnen gebruiken voordat u MaxSurge inschakelt. Zie Azure-abonnements- en servicelimieten voor meer informatie over quota en limieten.

Belangrijk

MaxSurge is momenteel in preview voor virtuele-machineschaalsets. Als u deze preview-functie wilt gebruiken, registreert u de providerfunctie met behulp van Azure Cloud Shell.

Register-AzProviderFeature -FeatureName MaxSurgeRollingUpgrade -ProviderNamespace Microsoft.Compute

Previews worden voor u beschikbaar gesteld op voorwaarde dat u akkoord gaat met de aanvullende gebruiksvoorwaarden. Sommige aspecten van deze functie worden mogelijk nog gewijzigd voordat de functie algemeen beschikbaar wordt.

Concepten

Instelling	Beschrijving
Upgradebeleidsmodus	De upgradebeleidsmodi die beschikbaar zijn op virtuele-machineschaalsets zijn automatisch, handmatig en rolling.
Batchgrootte rolling upgrade %	Hiermee geeft u op hoeveel van de totale exemplaren van uw schaalset u tegelijk wilt upgraden. Voorbeeld: Een batchgrootte van 20% wanneer u tien exemplaren in uw schaalset hebt, resulteert in upgradebatches met elk twee exemplaren.
Onderbrekingstijd tussen batches (sec)	Hiermee geeft u op hoe lang uw schaalset moet wachten tussen het upgraden van batches. Voorbeeld: Een onderbrekingstijd van 10 seconden betekent dat wanneer een batch is voltooid, de schaalset 10 seconden wacht voordat deze naar de volgende batch gaat.
Maximaal beschadigd exemplaarpercentage	Hiermee geeft u het totale aantal exemplaren op dat mag worden gemarkeerd als beschadigd voor en tijdens de rolling upgrade. Voorbeeld: Een maximaal beschadigd exemplaar % van 20 betekent dat als u een schaalset van 10 exemplaren hebt en meer dan twee exemplaren in het hele schaalsetrapport als beschadigd, de rolling upgrade stopt.
Maximaal beschadigd upgradepercentage	Hiermee geeft u het totale aantal exemplaren dat als beschadigd mag worden gemarkeerd nadat de upgrade is uitgevoerd. Voorbeeld: Een maximaal beschadigd upgradepercentage van 20 betekent dat als u een schaalset van 10 exemplaren hebt en meer dan twee exemplaren in het hele schaalsetrapport weer beschadigd is nadat de upgrade is uitgevoerd, de rolling upgrade wordt geannuleerd. Maximaal beschadigd upgradepercentage is een belangrijke instelling omdat de schaalset instabiele of slechte updates kan ondervangen voordat ze worden geïmplementeerd naar de hele schaalset.
Prioriteit geven aan beschadigde exemplaren	Geeft aan dat de schaalset exemplaren moet upgraden die als beschadigd zijn gemarkeerd voordat exemplaren die als in orde zijn gemarkeerd, worden bijgewerkt. Voorbeeld: Als sommige exemplaren in uw schaalset worden weergegeven als mislukt of beschadigd wanneer een rolling upgrade begint, worden deze exemplaren eerst bijgewerkt door de schaalset.
Upgrade voor meerdere zones inschakelen	Hiermee kan de schaalset grenzen van beschikbaarheidszones negeren bij het bepalen van batches.
MaxSurge	MaxSurge is momenteel in preview voor Virtual Machine Scale Sets Uniform Orchestration. Als u deze preview-functie wilt gebruiken, registreert u de providerfunctie met behulp van Register-AzProviderFeature -FeatureName MaxSurgeRollingUpgrade -ProviderNamespace Microsoft.Compute. Als MaxSurge is ingeschakeld, worden nieuwe exemplaren in batches gemaakt met behulp van het nieuwste schaalmodel. Zodra de batch met nieuwe exemplaren is gemaakt en gemarkeerd als in orde, beginnen ze met het nemen van verkeer. De schaalset verwijdert vervolgens exemplaren in batches die overeenkomen met het oude schaalsetmodel. Dit gaat door totdat alle exemplaren up-to-date zijn. rolling upgrades met MaxSurge kunnen helpen bij het verbeteren van de uptime van de service tijdens upgradegebeurtenissen. Als MaxSurge is uitgeschakeld, worden de bestaande exemplaren in een schaalset omlaag gebracht in batches die moeten worden bijgewerkt. Zodra de bijgewerkte batch is voltooid, beginnen de exemplaren opnieuw verkeer te nemen en begint de volgende batch. Dit gaat door totdat alle exemplaren up-to-date zijn.

Het rolling upgradebeleid instellen of bijwerken

Beleid voor rolling upgrades kan worden geconfigureerd tijdens het maken van een schaalset. Omdat het rolling upgradebeleid de status van de toepassing moet controleren en er specifieke instellingen zijn die bepalen hoe upgrades worden voltooid, wordt u aangeraden eerst uw schaalset te maken met behulp van handmatig upgradebeleid. Zodra u hebt bevestigd dat de status van de toepassing is gerapporteerd, werkt u uw upgradebeleid bij van handmatig naar Rolling.

Portal

Selecteer de virtuele-machineschaalset waarvoor u het upgradebeleid wilt wijzigen. Selecteer in het menu onder Instellingen upgradebeleid en selecteer in de vervolgkeuzelijst Rolling - Upgrades worden geïmplementeerd in batches met optionele pauze.

CLI

Werk een bestaande virtuele-machineschaalset bij met behulp van az vmss update.

az vmss update \
	--name myScaleSet \
	--resource-group myResourceGroup \
	--max-batch-instance-percent 10 \
	--max-unhealthy-instance-percent 20 \
	--max-unhealthy-upgraded-instance-percent 20 \
	--prioritize-unhealthy-instances true \
	--pause-time-between-batches PT2S \
	--max-surge true 

Powershell

Werk een bestaande virtuele-machineschaalset bij met update-AzVmss.

$vmss = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

Set-AzVmssRollingUpgradePolicy `
   -VirtualMachineScaleSet $VMSS `
   -MaxBatchInstancePercent 20 `
   -MaxUnhealthyInstancePercent 20 `
   -MaxUnhealthyUpgradedInstancePercent 20 `
   -PauseTimeBetweenBatches "PT30S" `
   -EnableCrossZoneUpgrade True `
   -PrioritizeUnhealthyInstance True `
   -MaxSurge True

Update-Azvmss -ResourceGroupName "myResourceGroup" `
    -Name "myScaleSet" `
    -UpgradePolicyMode "Rolling" `
    -VirtualMachineScaleSet $vmss

Azure VPN-gateway

Werk de eigenschappensectie van uw ARM-sjabloon bij en stel het upgradebeleid in op Rolling en verschillende opties voor rolling upgrades.

"properties": {
    "singlePlacementGroup": false,
        "upgradePolicy": {
            "mode": "Rolling",
            "rollingUpgradePolicy": {
            "maxBatchInstancePercent": 20,
            "maxUnhealthyInstancePercent": 20,
            "maxUnhealthyUpgradedInstancePercent": 20,
            "pauseTimeBetweenBatches": "PT2S",
	        "MaxSurge": "true"
            }
        }
    }

Status van rolling upgrade ophalen

Portal

Wanneer een rolling upgrade wordt geactiveerd in Azure Portal, wordt boven aan uw schaalsetresource een banner weergegeven waarin wordt aangegeven dat er een rolling upgrade wordt uitgevoerd. U kunt op Details weergeven klikken om de status van de rolling upgrade te bekijken. Wanneer alle updates zijn voltooid, verdwijnt de banner.

Daarnaast kunt u precies bekijken welke wijzigingen worden geïmplementeerd in het activiteitenlogboek. De gebeurtenis rolling upgrade bevindt zich onder Virtuele-machineschaalset maken of bijwerken. Selecteer Wijzigingsgeschiedenis om te controleren wat er wordt bijgewerkt.

CLI

U kunt de status van een rolling upgrade in uitvoering krijgen met az vmss rolling-upgrade get-latest.

az vmss rolling-upgrade get-latest \
    --name myScaleSet \
    --resource-group myResourceGroup

{
  "location": "eastus",
  "policy": {
    "maxBatchInstancePercent": 20,
    "maxSurge": false,
    "maxUnhealthyInstancePercent": 20,
    "maxUnhealthyUpgradedInstancePercent": 20,
    "pauseTimeBetweenBatches": "PT0S",
    "prioritizeUnhealthyInstances": true,
    "rollbackFailedInstancesOnPolicyBreach": false
  },
  "progress": {
    "failedInstanceCount": 0,
    "inProgressInstanceCount": 2,
    "pendingInstanceCount": 0,
    "successfulInstanceCount": 8
  },
  "runningStatus": {
    "code": "RollingForward",
    "lastAction": "Start",
    "lastActionTime": "2024-01-12T20:20:04.1863772+00:00",
    "startTime": "2024-01-12T20:20:04.4363788+00:00"
  },
  "type": "Microsoft.Compute/virtualMachineScaleSets/rollingUpgrades"
}

Powershell

U kunt de status van een rolling upgrade in uitvoering krijgen met Behulp van Get-AzVmssRollingUpgrade.

Get-AzVMssRollingUpgrade `
    -ResourceGroupName myResourceGroup `
    -VMScaleSetName myScaleSet

Policy                                  : 
  MaxBatchInstancePercent               : 20
  MaxUnhealthyInstancePercent           : 20
  MaxUnhealthyUpgradedInstancePercent   : 20
  PauseTimeBetweenBatches               : PT0S
  PrioritizeUnhealthyInstances          : True
  RollbackFailedInstancesOnPolicyBreach : False
  MaxSurge                              : False
RunningStatus                           : 
  Code                                  : RollingForward
  StartTime                             : 1/12/2024 8:20:04 PM
  LastAction                            : Start
  LastActionTime                        : 1/12/2024 8:20:04 PM
Progress                                : 
  SuccessfulInstanceCount               : 8
  FailedInstanceCount                   : 0
  InProgressInstanceCount               : 2
  PendingInstanceCount                  : 0
Type                                    : Microsoft.Compute/virtualMachineScaleSets/rollingUpgrades
Location                                : eastus
Tags                                    : {}

Een rolling upgrade annuleren

Portal

U kunt een doorlopende upgrade annuleren met behulp van Azure Portal door de details van de weergave te selecteren in de banner boven uw schaalset. In het pop-upvenster kunt u de huidige status bekijken en onderaan is een optie voor het annuleren van de upgrade .

CLI

U kunt een rolling upgrade stoppen met az vmss rolling-upgrade cancel. Als u na het uitvoeren van de opdracht geen uitvoer ziet, betekent dit dat de annuleringsaanvraag is geslaagd.

az vmss rolling-upgrade cancel \
    --name myScaleSet \
    --resource-group myResourceGroup

Powershell

U kunt een doorlopende upgrade stoppen met stop-AzVmssRollingUpgrade.

Stop-AzVmssRollingUpgrade `
    -ResourceGroupName myResourceGroup `
    -VMScaleSetName myScaleSet

Een rolling upgrade opnieuw starten

Als u besluit om een rolling upgrade te annuleren of de upgrade is gestopt vanwege een beleidsschending, worden wijzigingen die resulteren in een andere wijziging van het schaalsetmodel een nieuwe rolling upgrade geactiveerd. Als u een rolling upgrade opnieuw wilt starten om een algemene modelupdate te activeren. Dit vertelt de schaalset om te controleren of alle exemplaren up-to-date zijn met het nieuwste model.

CLI

Als u een rolling upgrade opnieuw wilt starten nadat deze is geannuleerd, moet u de schaalset activeren om te controleren of de exemplaren in de schaalset up-to-date zijn met het nieuwste schaalsetmodel. U kunt dit doen door az vmss update uit te voeren.

az vmss update \
    --name myScaleSet \
    --resource-group myResourceGroup

Powershell

Als u een rolling upgrade opnieuw wilt starten nadat deze is geannuleerd, moet u de schaalset activeren om te controleren of de exemplaren in de schaalset up-to-date zijn met het nieuwste schaalsetmodel. U kunt dit doen door Update-AzVmss uit te voeren.

$VMSS = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myScaleSet"

Update-AzVmss `
    -ResourceGroupName myResourceGroup `
    -Name myScaleSet `
    -VirtualMachineScaleSet $VMSS

Volgende stappen

Meer informatie over het uitvoeren van handmatige upgrades op virtuele-machineschaalsets.