Freigeben über

Aktualisieren von Sprachstapelversionen in Azure Functions

In Azure Functions ist die Unterstützung für einen Sprachstapel auf bestimmte Versionen beschränkt. Wenn neue Versionen verfügbar sind, aktualisieren Sie Ihre Funktions-Apps ggf., um neue Features nutzen zu können. Die Unterstützung in Functions kann auch für ältere Versionen eingestellt werden. Das Ende ist außerdem in der Regel auf die Termine für das Ende des Supports der Community ausgerichtet. Weitere Informationen finden Sie in der Runtime-Supportrichtlinie für Sprachen. Unterstützte Versionen verschiedener Sprachen finden Sie unter Sprachen nach Laufzeitversion.

Um sicherzustellen, dass Ihre Funktions-Apps weiterhin unterstützt werden, befolgen Sie bitte die Anweisungen in diesem Artikel, um sie auf die neuesten verfügbaren Versionen zu aktualisieren. Die Art und Weise, wie Sie Ihre Funktions-App aktualisieren, hängt von mehreren Faktoren ab:

  • Die Sprache, die Sie zur Entwicklung Ihrer Funktions-Apps verwenden. Bitte wählen Sie oben in diesem Artikel Ihre Programmiersprache aus.
  • Das Betriebssystem, auf dem Ihre Funktions-App in Azure ausgeführt wird: Windows oder Linux.
  • Vom Hostingplan

Hinweis

Dieser Artikel erläutert, wie Sie die .NET-Version einer Funktions-App aktualisieren, die das isolierte Workermodell verwendet. Wenn Ihre Funktions-App auf einer älteren Version von .NET ausgeführt wird und das In-Process-Modell verwendet, sollten Sie die folgenden Optionen in Betracht ziehen:

Voraussetzungen

  • Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto.
  • Eine Funktions-App, die in einem der folgenden Funktionspläne gehostet wird:
    • Premium
    • Dediziert
    • Consumption

Vorbereiten der Funktions-App

Bevor Sie die Stapelkonfiguration für Ihre Funktions-App in Azure aktualisieren, führen Sie bitte die Aufgaben in den folgenden Abschnitten aus.

Lokales Überprüfen der Funktions-App

Testen und überprüfen Sie Ihren Funktions-App-Code lokal auf der neuen Zielversion.

Führen Sie die folgenden Schritte aus, um das Projekt auf Ihrem lokalen Computer zu aktualisieren:

  1. Stellen Sie sicher, dass die Zielversion des .NET SDK installiert ist.

    Wenn Sie auf eine Vorschauversion abzielen, lesen Sie die Funktionsanleitungen für die Vorschau von .NET-Versionen , um sicherzustellen, dass die Version unterstützt wird. Für die Verwendung von .NET-Vorschauen sind möglicherweise weitere Schritte erforderlich.

  2. Aktualisieren Sie Ihre Verweise auf die neuesten Versionen von Microsoft.Azure.Functions.Worker und Microsoft.Azure.Functions.Worker.Sdk.

  3. Aktualisieren Sie das Zielframework Ihres Projekts auf die neue Version. Für C#-Projekte müssen Sie das Element <TargetFramework> in der CSPROJ-Datei aktualisieren. Weitere Informationen zu Ihrer Version finden Sie unter Target Frameworks.

    Die Änderung des Ziel-Frameworks Ihres Projekts kann auch Änderungen an Teilen Ihrer Toolchain außerhalb des Projektcodes erfordern. In Visual Studio Code müssen Sie z. B. die Erweiterungseinstellung azureFunctions.deploySubpath in den Benutzereinstellungen oder die Datei .vscode/settings.json Ihres Projekts aktualisieren. Überprüfen Sie, ob außerhalb Ihres Projektcodes Abhängigkeiten von der Framework-Version bestehen, beispielsweise als Teil von Build-Schritten oder einer CI/CD-Pipeline (Continuous Integration and Continuous Delivery).

  4. Aktualisieren Sie den Projektcode, den die neue .NET-Version benötigt. Überprüfen Sie die Versionshinweise auf spezifische Informationen. Sie können auch den .NET-Upgrade-Assistenten verwenden, um Ihren Code als Reaktion auf Änderungen in Hauptversionen zu aktualisieren.

Nachdem Sie diese Änderungen vorgenommen haben, erstellen Sie Ihr Projekt neu, und testen Sie es, um zu überprüfen, ob Ihre Funktions-App wie erwartet ausgeführt wird.

Wechseln zur neuesten Funktionslaufzeit

Stellen Sie sicher, dass Ihre Funktions-App auf der neuesten Version der Funktionslaufzeit (Version 4.x) ausgeführt wird. Sie können die Runtimeversion im Azure-Portal oder mithilfe der Azure CLI ermitteln.

Gehen Sie folgendermaßen vor, um die Laufzeitversion Ihrer Funktionen zu ermitteln:

  1. Suchen Sie im Azure-Portal Ihre Funktions-App, und wählen Sie sie aus. Wählen Sie im linken Menü Einstellungen>Konfiguration aus.

  2. Wechseln Sie zur Registerkarte Funktionslaufzeiteinstellungen, und überprüfen Sie den Wert der Laufzeitversion. Ihre Funktions-App sollte auf Version 4.x der Funktionsruntime (~4) ausgeführt werden.

Wenn Sie Ihre Funktions-App auf Version 4.x aktualisieren müssen, lesen Sie die Informationen unter Migrieren von Apps von Azure Functions Version 1.x zu Version 4.x oder Migrieren von Apps von Azure Functions Version 3.x zu Version 4.x. Befolgen Sie die Anweisungen in diesen Artikeln, anstatt nur die FUNCTIONS_EXTENSION_VERSION Einstellung zu ändern.

Veröffentlichen von Funktions-App-Updates

Wenn Sie Ihre Funktions-App so aktualisiert haben, dass sie ordnungsgemäß in der neuen Version ausgeführt wird, veröffentlichen Sie die Funktions-App-Updates, bevor Sie die Stapelkonfiguration für Ihre Funktions-App aktualisieren.

Tipp

Um den Updateprozess zu optimieren, Downtime für Ihre Funktions-Apps zu minimieren und eine Rollbackmöglichkeit zu bieten, sollten Sie die aktualisierte Funktions-App in einem Stagingslot veröffentlichen. Weitere Informationen finden Sie unter Azure Functions-Bereitstellungsslots.

Wenn Sie Ihre aktualisierte Funktions-App in einem Stagingslot veröffentlichen, müssen Sie die slotspezifischen Updateanweisungen im restlichen Artikel befolgen. Später überführen Sie den aktualisierten Stagingslot in die Produktion:

Aktualisieren der Stapelkonfiguration

Die Art und Weise, wie Sie die Stapelkonfiguration aktualisieren, hängt davon ab, ob die Funktions-App in Azure unter Windows oder unter Linux ausgeführt wird.

Wenn Sie einen Staging-Slot verwenden, richten Sie Ihre Updates auf den richtigen Slot aus.

Führen Sie die folgenden Schritte aus, um die Java-Version zu aktualisieren:

  1. Suchen Sie im Azure-Portal Ihre Funktions-App, und wählen Sie sie aus. Wählen Sie im linken Menü Einstellungen>Konfiguration aus. Wenn Sie über einen Staging-Slot verfügen, wählen Sie den jeweiligen Slot aus.

  2. Aktualisieren Sie auf der Registerkarte Allgemeine Einstellungen die Java-Version auf die gewünschte Version.

  3. Wählen Sie Speichern aus. Wenn Sie über einen Neustart benachrichtigt werden, wählen Sie Weiter aus.

Führen Sie die folgenden Schritte aus, um die .NET-Version zu aktualisieren:

  1. Suchen Sie im Azure-Portal Ihre Funktions-App, und wählen Sie sie aus. Wählen Sie im linken Menü Einstellungen>Konfiguration aus. Wenn Sie über einen Staging-Slot verfügen, wählen Sie den jeweiligen Slot aus.

  2. Aktualisieren Sie auf der Registerkarte Allgemeine Einstellungen die .NET-Version auf die gewünschte Version.

  3. Wählen Sie Speichern aus. Wenn Sie über einen Neustart benachrichtigt werden, wählen Sie Weiter aus.

Führen Sie die folgenden Schritte aus, um die Node.js-Version zu aktualisieren:

  1. Suchen Sie im Azure-Portal Ihre Funktions-App, und wählen Sie sie aus. Wählen Sie im linken Menü Einstellungen>Konfiguration aus. Wenn Sie über einen Staging-Slot verfügen, wählen Sie den jeweiligen Slot aus.

  2. Aktualisieren Sie auf der Registerkarte Allgemeine Einstellungen die Node.js-Version auf die gewünschte Version.

  3. Wählen Sie Speichern aus. Wenn Sie über einen Neustart benachrichtigt werden, wählen Sie Weiter aus. Durch diese Änderung wird die Anwendungseinstellung WEBSITE_NODE_DEFAULT_VERSION aktualisiert.

Führen Sie die folgenden Schritte aus, um die PowerShell-Version zu aktualisieren:

  1. Suchen Sie im Azure-Portal Ihre Funktions-App, und wählen Sie sie aus. Wählen Sie im linken Menü Einstellungen>Konfiguration aus. Wenn Sie über einen Staging-Slot verfügen, wählen Sie den jeweiligen Slot aus.

  2. Aktualisieren Sie auf der Registerkarte Allgemeine Einstellungen die PowerShell Core-Version auf die gewünschte Version.

  3. Wählen Sie Speichern aus. Wenn Sie über einen Neustart benachrichtigt werden, wählen Sie Weiter aus.

Python-Apps werden unter Windows nicht unterstützt. Gehen Sie stattdessen zur Registerkarte Linux.

Ihre Funktions-App wird neu gestartet, nachdem Sie die Version aktualisiert haben.

Austauschen von Slots

Wenn Sie einen Stagingslot verwenden, um Ihr Codeprojekt bereitzustellen und Ihre Einstellungen zu aktualisieren, tauschen Sie den Stagingslot in die Produktion aus. Weitere Informationen finden Sie in unter Austauschen von Slots.

Verwandte Inhalte

Entwicklerhandbuch für Java

Leitfaden zum isolierten Workerprozess in C#

Entwicklerhandbuch für Node.js

Python Developer Center

Entwicklerhandbuch für PowerShell

  • Last updated on