Freigeben über

Behandeln häufiger Probleme während des Azure-Runtime-Upgrades

  • Artikel

In diesem Artikel wird beschrieben, wie Sie einige der häufig auftretenden Probleme beheben können, die beim Aktualisieren der Funktions-App-Sprache oder Laufzeitversion auftreten können, z. B. nicht erreichbare Laufzeit und nicht gefundene Module.

  • Erweiterter Support für Microsoft .NET Core 3.1 endete am 3. Dezember 2022. Azure Functions runtime v3 basiert auf .NET Core 3.1. Es wird empfohlen, Ihre Funktions-App auf die Laufzeitversion 4.x zu aktualisieren, die .NET 6 verwendet und langfristige Unterstützung hat. Nach dem 3. Dezember 2022 sind Ihre Apps nicht für neue Features, Sicherheitspatches, Leistungsoptimierungen oder Support berechtigt, bis Sie sie auf Die Laufzeitversion 4.x der Funktionen aktualisieren.

  • Ihre Funktionen-Apps zur Laufzeit v3 werden weiterhin ausgeführt, und Ihre Anwendungen sind nicht betroffen. Sie können Code nach diesem Datum in diesen Funktionenanwendungen bereitstellen. Wir können jedoch die Möglichkeit für Sie entfernen, Anwendungen für die Funktionen-Runtime v3 mithilfe gängiger Pfade zu erstellen.

  • Weitere Informationen und Migrationsanleitungen finden Sie unter:

Überprüfen der Kompatibilität der Funktions-App für die Laufzeit v4

  • Navigieren Sie im Azure-Portal zu Ihrer Funktions-App. Wählen Sie Diagnose und Problemlösung, um die Azure Functions-Diagnose zu öffnen. Geben Sie in der Suchleiste Updating Function App Language oder Runtime Version ein, um sie direkt auszuführen. Der Diagnosebericht enthält eine Anleitung für das Update. Befolgen Sie nach Abschluss der Validierung die Empfehlungen und beheben Sie alle Probleme in Ihrer App.
  • Wir stellen Ihnen auch einen Pre-Upgrade Validator zur Verfügung, mit dem Sie mögliche Probleme bei der Migration Ihrer Functions-App auf 4.x erkennen können. Geben Sie in der gleichen Diagnose-Suchleiste Functions 4.x Pre-Upgrade Validator ein, um ihn direkt auszuführen. Befolgen Sie nach Abschluss der Validierung die Empfehlungen und beheben Sie alle Probleme in Ihrer App.
  • Wir empfehlen dringend ein Upgrade Ihrer lokalen Projektumgebung auf Version 4.x. Testen Sie Ihre App lokal gründlich mit Version 4.x von Azure Functions Core Tools.
  • Verwenden Sie einen Staging-Slot, um Ihre Anwendung in Azure mit der neuen Laufzeitversion zu testen und zu verifizieren, bevor Sie sie in einem Produktionsslot bereitstellen. Denken Sie daran, WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 für die Migration mit Slots einzustellen.

Ändern der Funktionslaufzeitversion für Windows

  1. Legen Sie FUNCTIONS_EXTENSION_VERSION fest, bei dem es sich um eine App-Einstellung im Konfigurationsbereich Azure-Portal handelt, auf ~4. Weitere Informationen finden Sie unter Ändern der Laufzeitversion.
  2. Legen Sie die netFrameworkVersion Websiteeinstellung auf .NET 6 fest. netFrameworkVersion ist eine SiteConfig-Einstellung, keine App-Einstellung. Und es ist nicht direkt im Azure-Portal verfügbar. Sie können sie jedoch mithilfe des Azure-Ressourcen-Explorers oder der Azure CLI/PowerShell festlegen.

Weitere Informationen finden Sie unter Functions-Runtimeversionen.

Ändern der Funktionslaufzeitversion für Linux

  1. Legen Sie FUNCTIONS_EXTENSION_VERSION fest, bei dem es sich um eine App-Einstellung im Konfigurationsbereich Azure-Portal handelt, auf ~4. Weitere Informationen finden Sie unter Ändern der Laufzeitversion.
  2. Legen Sie LinuxFxVersionmithilfe der Befehlszeilenschnittstelle (Command Line Interface, CLI) <Language>|<LanguageVersion>basierend auf der verwendeten Sprache fest. Weitere Informationen finden Sie unter Verwenden von LinuxFxVersion für Linux-Funktions-Apps. Um z. B. auf .NET 6 zu aktualisieren, können LinuxFxVersion Sie auf dotnet|6.0 und FUNCTIONS_EXTENSION_VERSION auf ~4.

Weitere Informationen finden Sie unter Functions-Runtimeversionen.

Abrufen einer Liste der unterstützten Sprachen durch die Laufzeitversion

Eine Liste der unterstützten Sprachen finden Sie in der Laufzeitversion.

Aktualisieren der Sprachversionseinstellung für die Funktions-App nach dem Aktualisieren des Codes

  • PowerShell: Legen Sie im Azure-Portal die PowerShell Core version. Weitere Informationen finden Sie unter Ändern der PowerShell-Version.
  • Python: Legen Sie linuxFxVersion auf python|3.x fest. Weitere Informationen finden Sie unter Ändern der Python-Version.
  • Java: Geben Sie die Sprachversion an, indem Sie -DjavaVersion als 11 oder 17 verwenden. Weitere Informationen finden Sie unter Angeben der Bereitstellungsversion.
  • Node, JavaScript: Legen Sie für Windows die WEBSITE_NODE_DEFAULT_VERSION App-Einstellung auf ~16. Legen Sie unter Linux linuxFxVersion mithilfe der CLI auf node|16 fest. Weitere Informationen finden Sie unter Festlegen der Node-Version.

Verwendung von Azure Functions Proxys

Die Unterstützung für Proxys ist in Version 4.x wieder verfügbar, sodass Sie für Ihre Funktions-Apps erfolgreich ein Upgrade auf die neueste Runtimeversion durchführen können. Es wird jedoch empfohlen, ihre Funktions-Apps so schnell wie möglich in Azure API Management zu integrieren. Mit der API-Verwaltung können Sie einen umfassenderen Satz von Features nutzen, um Ihre funktionenbasierten APIs zu definieren, zu sichern, zu verwalten und zu monetarisieren. Weitere Informationen finden Sie unter Migrieren zu APIM und Integrieren von Functions in APIM mithilfe von Visual Studio.

Abrufen einer Liste aller Azure Functions-Apps, die Laufzeitversion 1.x, 2.x oder 3.x verwenden

  1. Navigieren Sie im Azure-Portal zu Ihrer Funktions-App.
  2. Wählen Sie Diagnose und Problemlösung, um die Azure Functions-Diagnose zu öffnen.
  3. Geben Sie in der Suchleiste Updating Function App Language oder Runtime Version ein, um sie direkt auszuführen.
  4. Scrollen Sie im Diagnosebericht nach unten, und wählen Sie "Alle Funktions-App-Ansichtsdetails> auflisten" aus.
  5. Legen Sie die Suchfilter fest, und wählen Sie " Anzeigen" aus, um die Liste der Funktionen-Apps im aktuellen Abonnement abzurufen.

Alternativ können Sie dies mithilfe von APP Service REST-API-Aufrufen (GetConfiguration) ermitteln. LinuxFxVersion und WindowsFxVersion geben Sie die Versionsinformationen an.

Verschieben einer .NET Framework 4.6.1-App von Der Funktionslaufzeit v1 auf v4

.NET Framework 4.6.1 hat das Ende seiner Lebensdauer erreicht, sodass Apps ein Upgrade auf .NET Framework 4.8 erhalten sollten. In Functions v4 können Sie eine App mit .NET Framework 4.8 im prozessexternen Modus ausführen. Weitere Informationen finden Sie im Leitfaden für isolierte Prozesse.

Eine migrierte Funktions-App wird nicht gestartet oder hat einige Laufzeitprobleme.

  • Denken Sie bei .NET-Apps daran, den Code vor dem Erstellen und Bereitstellen auf .NET 6 zu aktualisieren.
  • Überprüfen Sie die Laufzeitversion der App im Azure-Portal.
  • Bei Windows-Apps müssen Sie netFrameworkVersion ebenfalls über die CLI oder PowerShell festlegen.
  • Stellen Sie sicher, dass Sie die 2.x- oder höher-Erweiterungspakete wie empfohlen verwenden. Version 4.x der Funktionslaufzeit erfordert Versionen 2.x oder 3.0.0.
  • Sich bei Azure Storage mithilfe von AzureWebJobsDashboard anzumelden, wird in 4.x nicht mehr unterstützt. Verwenden Sie stattdessen Application Insights für die Überwachung.
  • Wenn Sie eine Meldung erhalten, dass die Azure Functions-Laufzeit nicht erreichbar ist und Sie Speicherkonten freigeben, lesen Sie die Überlegungen zur Host-ID.
  • Azure Functions 4.x unterstützt nicht Node.js 10 und 12, Python 3.6 und PowerShell 6. Weitere Informationen finden Sie unter Sprachversionen, die für die v4-Laufzeit unterstützt werden.
  • Wenn bei Python-Funktionen Fehler im Zusammenhang mit Modulkonflikten und Modul nicht gefunden werden, versuchen Sie, die Einstellung PYTHON_ISOLATE_WORKER_DEPENDENCIES auf 1 in den App-Einstellungen festzulegen.
  • Überprüfen Sie die Migration vorhandener Funktions-Apps.
  • Suchen Sie bei Laufzeitproblemen über die Option "Probleme diagnostizieren und lösen" in der Azure-Portal nach Funktions-App, oder melden Sie Fehler, und überprüfen Sie den Diagnosebericht auf Fehlermeldungen und Lösungen. Überprüfen Sie auch das Erkennungsmodul Prüfungen der Functions-Konfiguration, um sicherzustellen, dass die Konfiguration fehlerfrei ist.
  • Lesen Sie den Blog "Probleme" beim Upgrade von Azure-Funktions-Apps auf V4 , um weitere Tipps zur Problembehandlung zu finden.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.