Beendigungsbenachrichtigung für Instanzen von Azure-VM-Skalierungsgruppen

Artikel
05/09/2023

Für Skalierungsgruppeninstanzen kann der Empfang von Beendigungsbenachrichtigungen aktiviert und ein vordefiniertes Verzögerungstimeout für den Beendigungsvorgang festgelegt werden. Die Beendigungsbenachrichtigung wird über „Azure Metadata Service – Scheduled Events“ gesendet. Dieser Subdienst sendet Benachrichtigungen über die Durchführung und Verzögerung einschneidender Vorgänge, z. B. Neustarts und erneute Bereitstellungen. In der Lösung wurde der Scheduled Events-Liste mit „Terminate“ ein weiteres Ereignis hinzugefügt. Welche Verzögerung dem Beendigungsereignis zugeordnet wird, hängt von dem Verzögerungslimit ab, das der Benutzer in der Konfiguration des Skalierungsgruppenmodells festlegt.

Nachdem Sie sich durch Aufrufen des entsprechenden Metadata Service-Endpunkts für Scheduled Events registriert haben, brauchen Instanzen von Skalierungsgruppen bis zum Löschen der Instanz nicht mehr auf den Ablauf eines festgelegten Timeouts zu warten. Nach dem Empfang einer Beendigungsbenachrichtigung kann die Instanz jederzeit gelöscht werden, bevor das Beendigungstimeout abläuft. Beendigungsbenachrichtigungen können für Spot-Instanzen nicht aktiviert werden. Weitere Informationen zu Spot-Instanzen finden Sie unter Azure Spot Virtual Machines für VM-Skalierungsgruppen.

Aktivieren von Beendigungsbenachrichtigungen

Es gibt mehrere Möglichkeiten, Beendigungsbenachrichtigungen für Skalierungsgruppeninstanzen zu aktivieren. Dies ist unten in den Beispielen beschrieben.

Azure-Portal

Die folgenden Schritte ermöglichen eine Beendigungsbenachrichtigung, wenn eine neue Skalierungsgruppe erstellt wird.

Navigieren Sie zu VM-Skalierungsgruppen.
Wählen Sie + Hinzufügen aus, um eine neue Skalierungsgruppe zu erstellen.
Navigieren Sie zur Registerkarte Verwaltung.
Suchen Sie den Abschnitt Instanzbeendigung.
Wählen Sie für Instanzbeendigungsbenachrichtigung die Option Ein aus.
Legen Sie für Beendigungsverzögerung (Minuten) das gewünschte Standardtimeout fest.
Wenn Sie die Erstellung der neuen Skalierungsgruppe abgeschlossen haben, wählen Sie die Schaltfläche Überprüfen und erstellen aus.

Sie können auch Beendigungsbenachrichtigungen für eine vorhandene Skalierungsgruppe aktivieren.

Navigieren Sie zur gewünschten Skalierungsgruppe.
Gehen Sie zur Registerkarte Konfiguration.
Wählen Sie für Benachrichtigung bei Instanzbeendigung die Option Ein aus.
Legen Sie für Beendigungsverzögerung (Minuten) das gewünschte Standardtimeout fest.
Wählen Sie die Schaltfläche Speichern aus.

REST-API

Im folgenden Beispiel wird eine Beendigungsbenachrichtigung für das Skalierungsgruppenmodell aktiviert.

PUT on `/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}?api-version=2019-03-01`

{
  "properties": {
    "virtualMachineProfile": {
            "scheduledEventsProfile": {
                "terminateNotificationProfile": {
                    "notBeforeTimeout":"PT5M",
                    "enable":true
                }
            }
        }
    }        
}

Durch den vorangehenden Block wird eine Timeoutverzögerung von 5 Minuten (wie durch PT5M angegeben) für jeden beliebigen Beendigungsvorgang festgelegt, der für Instanzen in der Skalierungsgruppe ausgeführt wird. Das Feld notBeforeTimeout kann einen beliebigen Wert zwischen 5 und 15 Minuten im ISO 8601-Format enthalten. Sie können das Standardtimeout für den Beendigungsvorgang ändern, indem Sie die notBeforeTimeout-Eigenschaft unter terminateNotificationProfile wie oben beschrieben ändern.

Nachdem Sie scheduledEventsProfile für das Skalierungsgruppenmodell aktiviert und notBeforeTimeout festgelegt haben, aktualisieren Sie die einzelnen Instanzen entsprechend dem neuesten Modell, um die Änderungen widerzuspiegeln.

Hinweis

Beendigungsbenachrichtigungen für Skalierungsgruppeninstanzen können nur mit API-Version 2019-03-01 und höher aktiviert werden.

Azure PowerShell

Beim Erstellen einer neuen Skalierungsgruppe können Sie Beendigungsbenachrichtigungen für die Skalierungsgruppe mithilfe des Cmdlets New-AzVmssConfig aktivieren.

Dieses Beispielskript führt Sie durch die Erstellung eines Skalierungssatzes und der zugehörigen Ressourcen unter Verwendung der Konfigurationsdatei: Erstellen eines vollständigen Skalierungssatzes für virtuelle Computer. Sie können die Beendigungsbenachrichtigung konfigurieren, indem Sie die Parameter TerminateScheduledEvents und TerminateScheduledEventNotBeforeTimeoutInMinutes zum Konfigurationsobjekt für die Erstellung der Skalierungsgruppe hinzufügen. Das folgende Beispiel aktiviert das Feature mit einem Verzögerungstimeout von 10 Minuten.

Wichtig

Ab November 2023 werden VM-Skalierungsgruppen, die mit PowerShell und der Azure CLI erstellt wurden, standardmäßig auf den flexiblen Orchestrierungsmodus festgelegt, wenn kein Orchestrierungsmodus angegeben wird. Weitere Informationen zu dieser Änderung und zu den Maßnahmen, die Sie ergreifen sollten, finden Sie unter Breaking Change für PowerShell-/CLI-Kunden mit VMSS – Microsoft Community Hub.

New-AzVmssConfig `
  -Location "VMSSLocation" `
  -SkuCapacity 2 `
  -OrchestrationMode "Flexible" `
  -SkuName "Standard_DS2" `
  -TerminateScheduledEvents $true `
  -TerminateScheduledEventNotBeforeTimeoutInMinutes 10

Verwenden Sie das Cmdlet Update-AzVmss, um Beendigungsbenachrichtigungen für eine bestehende Skalierungsgruppe zu aktivieren.

Update-AzVmss `
  -ResourceGroupName "myResourceGroup" `
  -VMScaleSetName "myScaleSet" `
  -TerminateScheduledEvents $true `
  -TerminateScheduledEventNotBeforeTimeoutInMinutes 15

Im vorangehenden Beispiel werden Beendigungsbenachrichtigungen für eine bestehende Skalierungsgruppe aktiviert. Außerdem wird ein 15-minütiges Timeout für das Beendigungsereignis festgelegt.

Nachdem Sie Scheduled Events für das Skalierungsgruppenmodell aktiviert und das Timeout festgelegt haben, aktualisieren Sie die einzelnen Instanzen entsprechend dem neuesten Modell, um die Änderungen widerzuspiegeln.

Azure CLI 2.0

Das folgende Beispiel dient zum Aktivieren der Beendigungsbenachrichtigung beim Erstellen einer neuen Skalierungsgruppe.

az group create --name <myResourceGroup> --location <VMSSLocation>
az vmss create \
  --resource-group <myResourceGroup> \
  --name <myVMScaleSet> \
  --image Ubuntu2204 \
  --admin-username <azureuser> \
  --generate-ssh-keys \
  --terminate-notification-time 10

Im Beispiel oben wird zunächst eine Ressourcengruppe und dann eine neue Skalierungsgruppe mit aktivierten Beendigungsbenachrichtigungen und einem Standardtimeout von 10 Minuten erstellt.

Das folgende Beispiel dient zum Aktivieren der Beendigungsbenachrichtigung in einer vorhandenen Skalierungsgruppe.

az vmss update \  
  --resource-group <myResourceGroup> \
  --name <myVMScaleSet> \
  --enable-terminate-notification true \
  --terminate-notification-time 10

Empfangen von Beendigungsbenachrichtigungen

Beendigungsbenachrichtigungen werden über Scheduled Events zugestellt. Dabei handelt es sich um einen Azure Metadata Service. Der Azure-Metadatendienst macht Informationen zu ausgeführten virtuellen Computern mithilfe eines innerhalb einer VM zugänglichen REST-Endpunkts verfügbar. Die Informationen werden über eine nicht routingfähige IP-Adresse bereitgestellt, die außerhalb der VM nicht verfügbar gemacht wird.

Scheduled Events wird für die Skalierungsgruppe aktiviert, wenn Sie zum ersten Mal Ereignisse anfordern. Beim ersten Aufruf ist eine Verzögerung der Antwort um bis zu zwei Minuten zu erwarten. Senden Sie regelmäßig Abfragen an den Endpunkt, um anstehende Wartungsereignisse und den Status fortlaufender Wartungsaktivitäten zu ermitteln.

Scheduled Events wird für die Skalierungsgruppe deaktiviert, wenn von den Skalierungsgruppeninstanzen 24 Stunden lang keine Anforderung eingeht.

Endpunktermittlung

Für VNET-fähige VMs ist der Metadata Service über eine statische, nicht routingfähige IP-Adresse (169.254.169.254) erreichbar.

Der vollständige Endpunkt für die neueste Version von Scheduled Events ist wie folgt:

http://169.254.169.254/metadata/scheduledevents?api-version=2019-01-01

Abfrageantwort

Eine Antwort enthält ein Array geplanter Ereignisse. Ein leeres Array bedeutet, dass derzeit keine Ereignisse geplant sind.

Sofern geplante Ereignisse vorliegen, enthält die Antwort ein Array mit Ereignissen. Die Antwort für das „Terminate“-Ereignis sieht wie folgt aus:

{
    "DocumentIncarnation": {IncarnationID},
    "Events": [
        {
            "EventId": {eventID},
            "EventType": "Terminate",
            "ResourceType": "VirtualMachine",
            "Resources": [{resourceName}],
            "EventStatus": "Scheduled",
            "NotBefore": {timeInUTC},
        }
    ]
}

DocumentIncarnation ist ein ETag und bietet eine einfache Möglichkeit, um zu untersuchen, ob sich die Ereignisnutzlast seit der letzten Abfrage geändert hat.

Weitere Informationen zu den einzelnen vorangehenden Feldern finden Sie in der Scheduled Events-Dokumentation für Windows und Linux.

Reagieren auf Ereignisse

Sobald Sie von einem bevorstehenden Ereignis erfahren und Ihre Logik um ordnungsgemäßes Herunterfahren ergänzt haben, können Sie ein ausstehendes Ereignis genehmigen, indem Sie einen POST-Aufruf mit „EventId“ an den Metadatendienst senden. Durch den POST-Aufruf wird Azure mitgeteilt, dass das Löschen des virtuellen Computers fortgesetzt werden kann.

Im Folgenden finden Sie den im POST-Anforderungstext erwarteten JSON-Code. Die Anforderung sollte eine Liste mit StartRequests-Elementen enthalten. Jedes StartRequest-Element enthält die EventId für das Ereignis, das Sie beschleunigen möchten:

{
	"StartRequests" : [
		{
			"EventId": {EventId}
		}
	]
}

Stellen Sie sicher, dass durch jede VM in der Skalierungsgruppe nur die EventID genehmigt wird, die für die VM relevant ist. Eine VM kann ihren eigenen VM-Namen über Instanzmetadaten abrufen. Dieser Name hat das Format „{scale-set-name}_{instance-id}“ und wird im Abschnitt „Ressourcen“ der oben beschriebenen Abfrageantwort angezeigt.

Weitere Informationen finden Sie in den Beispielskripts für das Abfragen und Reagieren auf Ereignisse mit Python.

Tipps und Best Practices

Beendigungsbenachrichtigungen nur für Löschvorgänge – Durch alle Löschvorgänge (manuelles Löschen oder durch Autoskalierung initiiertes, horizontales Herunterskalieren) werden Terminate-Ereignisse generiert, sofern scheduledEventsProfile für die Skalierungsgruppe aktiviert wurde. Durch andere Vorgänge wie Neustart, Reimaging, erneute Bereitstellung und Beenden/Freigeben werden keine Terminate-Ereignisse generiert.
Keine verbindliche Wartezeit für Timeouts – Sie können den Beendigungsvorgang jederzeit starten, nachdem das Ereignis empfangen wurde und bevor die NotBefore-Zeit des Ereignisses abläuft.
Verbindliche Löschung bei Timeout: Es gibt keine Möglichkeit zur Erhöhung des Timeoutwerts, nachdem ein Ereignis generiert wurde. Nach Ablauf des Timeouts wird das ausstehende Terminate-Ereignis verarbeitet, und die VM wird gelöscht.
Änderbarer Timeoutwert – Sie können den Timeoutwert jederzeit ändern, bevor eine Instanz gelöscht wird, indem Sie die notBeforeTimeout-Eigenschaft des Skalierungsgruppenmodells ändern und die VM-Instanzen entsprechend dem neuesten Modell aktualisieren.
Alle ausstehenden Löschvorgänge genehmigen – Wenn es einen ausstehenden, nicht genehmigten Löschvorgang auf VM_1 gibt und ein weiteres Terminate-Ereignis auf VM_2 genehmigt wurde, wird VM_2 erst gelöscht, nachdem das Beendigungsereignis für VM_1 genehmigt wurde bzw. das Timeout abgelaufen ist. Sobald Sie das Beendigungsereignis für VM_1 genehmigen, werden sowohl VM_1 als auch VM_2 gelöscht.
Alle gleichzeitigen Löschvorgänge genehmigen (Ergänzung des vorangehenden Beispiels) – Wenn VM_1 und VM_2 dieselbe NotBefore-Zeit aufweisen, müssen beide Beendigungsereignisse genehmigt werden, da VMs ansonsten erst wieder gelöscht werden können, wenn das Timeout abgelaufen ist.

Problembehandlung

Fehler beim Aktivieren von scheduledEventsProfile

Wenn Sie einen BadRequest-Fehler mit der Fehlermeldung „Member 'scheduledEventsProfile' für Objekt vom Typ 'VirtualMachineProfile' nicht gefunden“ erhalten, überprüfen Sie die für Skalierungsgruppenvorgänge verwendete API-Version. Die Compute-API-Version 2019-03-01 oder höher ist erforderlich.

Fehler beim Abrufen von Terminate-Ereignissen

Wenn Sie keine Terminate-Ereignisse über Scheduled Events erhalten, dann überprüfen Sie die API-Version, die zum Abrufen der Ereignisse verwendet wird. Für Terminate-Ereignisse wird die Metadata Service-API-Version 2019-01-01 benötigt.