Azure Functions-Bereitstellungsslots

Artikel
02/27/2024

Azure Functions-Bereitstellungsslots ermöglichen Ihrer Funktions-App das Ausführen verschiedener Instanzen, die als Slots bezeichnet werden. Slots sind verschiedene Umgebungen, die über einen öffentlich verfügbaren Endpunkt verfügbar gemacht werden. Eine App-Instanz wird immer dem Produktionsslot zugeordnet, und Sie können Instanzen, die einem Slot zugewiesen sind, bei Bedarf austauschen. Funktions-Apps, die in einem Verbrauchsplan ausgeführt werden, verfügen über ein einziges zusätzliches Einschubfach für Staging. Sie können weitere Staginglots erhalten, indem Sie Ihre Anwendung in einem Premium-Plan oder Dedicated (App Service) Plan ausführen. Weitere Informationen finden Sie unter Diensteinschränkungen.

Im Folgenden wird dargestellt, wie sich der Austausch von Slots auf Funktionen auswirkt:

Die Umleitung des Datenverkehrs erfolgt nahtlos, und es gehen keine Anforderungen aufgrund des Tauschs verloren. Dieses nahtlose Verhalten tritt auf, da der nächste Funktionsauslöser an das vertauschte Einschubfach weitergeleitet wird.
Aktuell ausgeführte Funktionen werden während des Austauschs beendet. Wie Sie zustandslose und defensive Funktionen schreiben können, erfahren Sie unter Verbessern der Leistung und Zuverlässigkeit von Azure Functions.

Gründe für die Verwendung von Slots

Es gibt viele Vorteile bei der Verwendung von Bereitstellungsslots, unter anderem:

Verschiedene Umgebungen für unterschiedliche Zwecke: Die Verwendung verschiedener Slots bietet Ihnen die Möglichkeit, App-Instanzen vor dem Austauschen in den Produktions- oder einen Stagingslot zu unterscheiden.
Vorwärmen: Wenn Sie in einem Slot anstatt direkt in der Produktionsumgebung bereitstellen, können Sie die App vor dem Livebetrieb vorwärmen. Außerdem reduziert die Verwendung von Slots die Latenzzeit für HTTP-ausgelöste Workloads. Instanzen werden vor der Bereitstellung vorgewärmt, wodurch sich der Kaltstart bei neu bereitgestellten Funktionen verkürzt.
Einfache Fallbacks: Nach einem Austausch mit der Produktion enthält der Slot mit der vorherigen Staging-App die vorherige Produktions-App. Wenn die in den Produktionsslot überführten Änderungen nicht Ihren Erwartungen entsprechen, können Sie den Austausch sofort wieder umkehren, um Ihre „letzte als funktionierend bekannte Instanz“ wiederherzustellen.
Minimieren Sie Neustarts: Ändern von App-Einstellungen in einem Produktionsplatz erfordert einen Neustart der ausgeführten App. Sie können stattdessen Einstellungen in einem Stagingslot ändern und die Einstellungsänderung mit einer vorgewärmten Instanz in die Produktion übertragen. Einschubfächer (Slots) sind der empfohlene Weg, um zwischen den Laufzeitversionen von Functions zu migrieren und dabei die höchste Verfügbarkeit zu gewährleisten. Weitere Informationen finden Sie unter Minimale Downtime Update.

Austauschvorgänge

Während eines Austauschs wird ein Einschubfach als Quelle und das andere als Ziel betrachtet. Der Quellslot enthält die Instanz der Anwendung, die auf den Zielslot angewendet wird. Die folgenden Schritte stellen sicher, dass es beim Zielslot während eines Austauschs zu keinen Ausfallzeiten kommt:

Einstellungen anwenden: Einstellungen aus dem Zielslot werden auf alle Instanzen des Quellslot angewendet. Beispielsweise werden die Produktionseinstellungen auf die Staginginstanz angewendet. Die angewendeten Einstellungen umfassen die folgenden Kategorien:
- Slotspezifische App-Einstellungen und Verbindungszeichenfolgen (sofern zutreffend)
- Einstellungen für Continuous Deployment (sofern aktiviert)
- Einstellungen für die App Service-Authentifizierung (sofern aktiviert)
Warten auf Neustarts und Verfügbarkeit: Der Austausch wartet, bis jede Instanz im Quellslot ihren Neustart abgeschlossen hat und für Anforderungen verfügbar ist. Sollte eine Instanz nicht erfolgreich neu gestartet werden, werden sämtliche Änderungen am Quellslot zurückgesetzt, und der Austauschvorgang wird beendet.
Routing aktualisieren: Nach erfolgreicher Vorwärmung aller Instanzen im Quellslot schließen die beiden Slots den Austausch ab, indem die Routingregeln ausgetauscht werden. Nach diesem Schritt verfügt das Zielslot (zum Beispiel das Produktionsslot) über die Anwendung, die zuvor im Quellslot vorbereitet wurde.
Wiederholen Sie den Vorgang: Nachdem der Quellslot nun die Anwendung vor dem Austausch enthält, die sich zuvor im Zielslot befand, führen Sie den gleichen Vorgang erneut aus, indem alle Einstellungen angewendet und die Instanzen für den Quellslot neu gestartet werden.

Berücksichtigen Sie dabei Folgendes:

In jeder Phase des Austauschvorgangs erfolgt die Initialisierung der ausgetauschten Apps im Quellslot. Der Zielslot bleibt während der gesamten Vorbereitung des Quellslots online – unabhängig davon, ob der Austausch erfolgreich ist oder nicht.
Wenn Sie einen Stagingslot gegen den Produktionsslot austauschen möchten, muss der Produktionsslot immer der Zielslot sein. So ist sichergestellt, dass Ihre Produktions-App durch den Austauschvorgang nicht beeinträchtigt wird.
Einstellungen im Zusammenhang mit Ereignisquellen und Bindungen müssen als Bereitstellungssloteinstellungen konfiguriert werden, bevor Sie einen Austausch starten. Wenn Sie vorzeitig als „sticky“ (persistent) markiert werden, wird sichergestellt, dass Ereignisse und Ausgaben an die richtige Instanz weitergeleitet werden.

Verwalten von Einstellungen

Einige Konfigurationseinstellungen sind slotspezifisch. In den nachstehenden Listen finden Sie die Einstellungen, die sich beim Austauschen von Slots ändern und die unverändert bleiben.

Slotspezifische Einstellungen:

Veröffentlichungsendpunkte
Benutzerdefinierte Domänennamen
Nicht-öffentliche Zertifikate und TLS/SSL-Einstellungen
Skalierungseinstellungen
IP-Einschränkungen
Always On
Diagnoseeinstellungen
Ressourcenfreigabe zwischen verschiedenen Ursprüngen (Cross-Origin Resource Sharing, CORS)
Private Endpunkte

Nicht slotspezifische Einstellungen:

Allgemeine Einstellungen (z. B. Framework-Version, 32/64-Bit-Angabe, WebSockets)
App-Einstellungen (können so konfiguriert werden, dass sie beim Slot verbleiben)
Verbindungszeichenfolgen (können so konfiguriert werden, dass sie beim Slot verbleiben)
Handlerzuordnungen
Öffentliche Zertifikate
Hybridverbindungen *
Virtual Network-Integration*
Dienstendpunkte*
Azure Content Delivery Network*

Funktionen, die mit einem Sternchen (*) gekennzeichnet sind, werden standardmäßig nicht ausgetauscht.

Hinweis

Bestimmte App-Einstellungen, die für nicht ausgetauschte Einstellungen gelten, werden ebenfalls nicht ausgetauscht. Da die Diagnoseprotokolleinstellungen beispielsweise nicht ausgetauscht werden, werden verwandte App-Einstellungen wie WEBSITE_HTTPLOGGING_RETENTION_DAYS und DIAGNOSTICS_AZUREBLOBRETENTIONDAYS ebenfalls nicht ausgetauscht, auch wenn Sie nicht als Sloteinstellungen angezeigt werden.

Erstellen einer Bereitstellungseinstellung

Sie können Einstellungen als Bereitstellungseinstellungen markieren, wodurch sie dauerhaft gelten. Eine persistente (sticky) Einstellung wird nicht zusammen mit der App-Instanz ausgetauscht.

Wenn Sie eine Bereitstellungseinstellung in einem Slot erstellen, achten Sie darauf, dass Sie dieselbe Einstellung mit einem eindeutigen Wert in allen anderen Slots erstellen, die an einem Austausch beteiligt sind. Auf diese Weise bleiben die Einstellungsnamen zwischen Slots konsistent, während sich der Wert einer Einstellung nicht ändert. Diese Namenskonsistenz stellt sicher, dass Ihr Code nicht versucht, auf eine Einstellung zuzugreifen, die in einem Slot definiert ist, in einem anderen aber nicht.

Führen Sie die folgenden Schritte aus, um eine Bereitstellungseinstellung zu erstellen:

Navigieren Sie in der Funktions-App zu Bereitstellungsslots, und wählen Sie dann den Slotnamen aus.
Wählen Sie Konfiguration aus, und wählen Sie den Namen der Einstellung aus, die für den aktuellen Slot persistent sein soll.
Wählen Sie Bereitstellungssloteinstellung aus, und wählen Sie dann OK aus.
Sobald der Abschnitt mit den Einstellungen nicht mehr angezeigt wird, wählen Sie Speichern aus, um die Änderungen beizubehalten.

Bereitstellung

Slots sind leer, wenn Sie einen Slot erstellen. Sie können jede der unterstützten Bereitstellungstechnologien verwenden, um Ihre Anwendung in einem Slot bereitzustellen.

Skalierung

Alle Slots werden auf dieselbe Anzahl von Workern wie der Produktionsslot skaliert.

Bei Verbrauch-Plänen wird der Slot analog der App skaliert.
Bei App Service-Plänen wird die App auf eine feste Anzahl von Workern skaliert. Slots werden auf derselben Anzahl von Workern wie der App-Plan ausgeführt.

Anzeigen von Slots

Sie können Informationen zu vorhandenen Slots entweder über die Azure CLI oder über das Azure-Portal anzeigen.

Azure portal
Azure-Befehlszeilenschnittstelle

Führen Sie die folgenden Schritte aus, um ein neues Slot im Portal zu erstellen:

Navigieren Sie zu Ihrer Funktions-App.
Wählen Sie Bereitstellungsslots aus und die vorhandenen Slots werden angezeigt.

Führen Sie diesen Az Funktions-App-Bereitstellungsslotlisten-Befehl aus, um die vorhandenen Slots in Ihrer Funktions-App aufzulisten:

az functionapp deployment slot list --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>"

Hinzufügen eines Slots

Sie können einen Slot entweder über die Azure CLI oder über das Azure-Portal hinzufügen.

Azure portal
Azure-Befehlszeilenschnittstelle

Führen Sie die folgenden Schritte aus, um einen Slot im Portal zu erstellen:

Navigieren Sie zu Ihrer Funktions-App.
Wählen Sie Bereitstellungsslots aus, und wählen Sie dann + Slot hinzufügen aus.
Geben Sie den Namen des Slots ein, und wählen Sie dann Hinzufügen aus.

Führen Sie den Az Funktions-App-Bereitstellungsslot erstellen-Befehl aus, um einen Slot namens staging in Ihrer Funktions-App zu erstellen:

az functionapp deployment slot create --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot staging

Zugriff auf Slotressourcen

Der Zugriff auf Ressourcen (HTTP-Trigger und Administratorendpunkte) in einem Stagingslot erfolgt auf die gleiche Weise wie im Produktionsslot. Anstelle des Hostnamens der Funktions-App verwenden Sie jedoch den slotspezifischen Hostnamen in der Anforderungs-URL zusammen mit beliebigen slotspezifischen Schlüsseln. Da Stagingslots Live-Apps sind, müssen Sie Ihre Funktionen in einem Stagingslot genau wie im Produktionsslot sichern.

Austauschen von Slots

Sie können Slots in und außerhalb der Produktion entweder über die Azure CLI oder über das Azure-Portal austauschen.

Azure portal
Azure-Befehlszeilenschnittstelle

Gehen Sie folgendermaßen vor, um einen Stagingslot in die Produktion zu überführen:

Navigieren Sie zur Funktionen-App.
Wählen Sie Bereitstellungssloteinstellung aus, und wählen Sie dann Austauschen aus.
Überprüfen Sie die Konfigurationseinstellungen für den Austausch, und wählen Sie dann Austauschen aus.

Der Tauschvorgang kann einige Sekunden dauern.

Führen Sie diesen Az Funktions-App-Bereitstellungsslot-Befehl aus, um zwischen einem Slot namens staging und dem Produktionsslot in Ihrer Funktions-App zu wechseln:

az functionapp deployment slot swap --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot staging --target-slot production

Ausführen eines Rollbacks für einen Austausch

Wenn ein Austausch zu einem Fehler führt oder Sie einen Austausch einfach „rückgängig“ machen möchten, können Sie ein Rollback auf den ursprünglichen Zustand ausführen. Um zum Zustand vor dem Austausch zurückzukehren, führen Sie einen weiteren Austausch aus, um den Austausch rückgängig zu machen.

Entfernen eines Slots

Sie können einen Slot entweder über die Azure CLI oder über das Azure-Portal entfernen.

Azure portal
Azure-Befehlszeilenschnittstelle

Führen Sie die folgenden Schritte aus, um einen Slot aus Ihrer Anwendung im Portal zu entfernen:

Navigieren Sie in der Funktions-App zu Bereitstellungsslots, und wählen Sie dann den Slotnamen aus.
Klicken Sie auf Löschen.
Geben Sie den Namen des Bereitstellungsslots ein, den Sie löschen möchten, und wählen Sie dann Löschen aus.
Schließen Sie den Bestätigungsbereich.

Führen Sie den Az Funktions-App-Bereitstellungsslot-Befehl zum Löschen aus, um einen Slot namens staging aus Ihrer Funktions-App zu entfernen:

az functionapp deployment slot delete --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot staging

Ändern des App Service-Plans

Bei einer Funktions-App, die in einem App Service-Plan ausgeführt wird, können Sie den zugrunde liegenden App Service-Plan für einen Slot zu ändern.