Anpassen des Lebenszyklus einer Web- oder Workerrolle in .NET

Wichtig

Cloud Services (klassisch) ist jetzt ab dem 1. September 2024 für alle Kunden veraltet. Alle vorhandenen ausgeführten Bereitstellungen werden beendet und von Microsoft heruntergefahren, und die Daten gehen ab Oktober 2024 dauerhaft verloren. In neuen Bereitstellungen sollte das neue auf Azure Resource Manager basierende Bereitstellungsmodell für Azure Cloud Services (erweiterter Support) verwendet werden.

Wenn Sie eine Workerrolle erstellen, erweitern Sie die RoleEntryPoint -Klasse, die Methoden zum Außerkraftsetzen bereitstellt, sodass Sie auf Lebenszyklusereignisse reagieren können. Für Webrollen ist diese Klasse optional, daher wird sie in erster Linie für die Reaktion auf Lebenszyklusereignisse verwendet.

Erweitern der RoleEntryPoint-Klasse

Die RoleEntryPoint-Klasse enthält Methoden, die von Azure beim Starten, Ausführen oder Beenden einer Web- oder Workerrolle aufgerufen werden. Sie können diese Methoden optional außer Kraft setzen, um die Rolleninitialisierung, Herunterfahrsequenzen für Rollen oder den Ausführungsthread der Rolle zu verwalten.

Berücksichtigen Sie beim Erweitern von RoleEntryPointdas folgende Verhalten der Methoden:

• Da die OnStart-Methode einen booleschen Wert zurückgibt, kann sie false zurückgeben.

  Wenn Ihr Code falsezurückgibt, wird der Rollenvorgang abrupt beendet, ohne dass eine möglicherweise eingerichtete Herunterfahrsequenz ausgeführt wird. Im Allgemeinen sollte das Zurückgeben von false durch die OnStart-Methode vermieden werden.

• Jede nicht abgefangene Ausnahme in einer Überladung einer RoleEntryPoint -Methode wird als nicht behandelte Ausnahme behandelt.

  Wenn in einer der Lebenszyklusmethoden eine Ausnahme auftritt, löst Azure das UnhandledException-Ereignis aus, und der Prozess wird beendet. Nachdem Ihre Rolle offline geschaltet wurde, startet Azure ihn neu. Wenn eine nicht behandelte Ausnahme auftritt, wird das Stopping -Ereignis nicht ausgelöst, und die OnStop -Methode wird nicht aufgerufen.

Wenn Ihre Rolle nicht gestartet wird oder zwischen den Zuständen „Initialisieren“, „Ausgelastet“ und „Beenden“ wechselt, wirft Ihr Code bei jedem Neustart der Rolle möglicherweise eine nicht behandelte Ausnahme in einem der Lebenszyklusereignisse aus. Verwenden Sie in diesem Fall das UnhandledException -Ereignis, um die Ursache der Ausnahme zu ermitteln und die Ausnahme entsprechend zu behandeln. Ihre Rolle kann auch von der Run -Methode zurückgegeben werden, wodurch ein Neustart der Rolle veranlasst wird. Weitere Informationen zu den Bereitstellungszuständen finden Sie unter Allgemeine Probleme, durch die Rollen zyklisch ausgeführt werden.

Hinweis

Wenn Sie zum Entwickeln Ihrer Anwendung die Azure-Tools für Microsoft Visual Studio verwenden, erweitern die Rollenprojektvorlagen automatisch die RoleEntryPoint-Klasse in den Dateien WebRole.cs und WorkerRole.cs.

OnStart-Methode

Die OnStart -Methode wird aufgerufen, wenn die Rolleninstanz von Azure online geschaltet wird. Während der OnStart-Code ausgeführt wird, wird die Rolleninstanz als Ausgelastet gekennzeichnet, und es wird vom Lastenausgleich kein externer Datenverkehr an sie gesendet. Sie können diese Methode außer Kraft setzen, um Initialisierungsaufgaben wie das Implementieren von Ereignishandlern und Starten der Azure-Diagnoseauszuführen.

Wenn OnStart das Ergebnis true zurückgibt, wurde die Instanz erfolgreich initialisiert, und Azure ruft die RoleEntryPoint.Run-Methode auf. Wenn OnStart das Ergebnis false zurückgibt, wird die Rolle sofort beendet, ohne dass gegebenenfalls. geplante Herunterfahrsequenzen ausgeführt werden.

Im folgenden Codebeispiel wird veranschaulicht, wie die OnStart -Methode außer Kraft gesetzt wird. Diese Methode konfiguriert und startet einen Diagnosemonitor, wenn die Rolleninstanz gestartet wird, und richtet die Übertragung von Protokollierungsdaten an ein Speicherkonto ein:

public override bool OnStart()
{
    var config = DiagnosticMonitor.GetDefaultInitialConfiguration();

    config.DiagnosticInfrastructureLogs.ScheduledTransferLogLevelFilter = LogLevel.Error;
    config.DiagnosticInfrastructureLogs.ScheduledTransferPeriod = TimeSpan.FromMinutes(5);

    DiagnosticMonitor.Start("DiagnosticsConnectionString", config);

    return true;
}

OnStop-Methode

Die OnStop-Methode wird aufgerufen, nachdem Azure eine Rolleninstanz offline verwendet und bevor der Prozess beendet wird. Sie können diese Methode zum Aufrufen von Code außer Kraft setzen, der für das saubere Herunterfahren der Rolleninstanz erforderlich ist.

Wichtig

Die Codeausführung in der OnStop-Methode muss innerhalb eines begrenzten Zeitraums abgeschlossen werden, wenn er nicht im Rahmen des vom Benutzer initiierten Herunterfahrens, sondern aus anderen Gründen aufgerufen wird. Nach diesem Zeitraum wird der Prozess beendet. Sie müssen also sicherstellen, dass der Code in der OnStop-Methode schnell ausgeführt werden kann oder die nicht vollständige Ausführung toleriert. Die OnStop-Methode wird nach dem Auslösen des Stopping-Ereignisses aufgerufen.

Run-Methode

Sie können die Run -Methode außer Kraft setzen, um einen Thread mit langer Ausführungsdauer für die Rolleninstanz zu implementieren.

Die Außerkraftsetzung der Run-Methode ist nicht erforderlich. Die Standardimplementierung startet einen Thread, der sich unbegrenzt im Ruhezustand befindet. Die Außerkraftsetzung der Run-Methode hat eine Codeblockierung auf unbestimmte Zeit zur Folge. Wenn die Run-Methode wieder aktiv ist, wird die Rolle automatisch wiederverwendet. Anders ausgedrückt: Azure löst das Stopping-Ereignis aus und ruft die OnStop-Methode auf, sodass Ihre Herunterfahrsequenzen ausgeführt werden, bevor die Rolle offline geschaltet wird.

Implementieren der ASP.NET-Lebenszyklusmethoden für eine Webrolle

Sie können die ASP.NET-Lebenszyklusmethoden zusätzlich zu den Methoden der RoleEntryPoint -Klasse verwenden, um Initialisierungs- und Herunterfahrsequenzen für eine Webrolle zu verwalten. Dieser Ansatz kann für die Kompatibilität nützlich sein, wenn Sie eine vorhandene ASP.NET-Anwendung in Azure portieren. Die ASP.NET-Lebenszyklusmethoden werden in den RoleEntryPoint -Methoden aufgerufen. Die Application_Start -Methode wird aufgerufen, nachdem die RoleEntryPoint.OnStart-Methode abgeschlossen wurde. Die Application_End-Methode wird vor dem Aufruf der RoleEntryPoint.OnStop-Methode aufgerufen.

Nächste Schritte

Hier erfahren Sie, wie Sie ein Clouddienstpaket erstellen.