Partager via

Résoudre les problèmes courants lors de la mise à niveau d’Azure Runtime

  • Article

Cet article explique comment résoudre certains des problèmes courants qui peuvent se produire pendant la mise à jour du langage de l’application de fonction ou de la version du runtime, comme le runtime inaccessible et les modules introuvables.

  • Le support étendu de Microsoft .NET Core 3.1 a pris fin le 3 décembre 2022. Azure Functions runtime v3 est basé sur .NET Core 3.1. Nous vous recommandons de mettre à jour votre application de fonction vers la version d’exécution 4.x, qui utilise .NET 6 et offre une prise en charge à long terme. Après le 3 décembre 2022, vos applications ne sont pas éligibles pour les nouvelles fonctionnalités, les correctifs de sécurité, les optimisations des performances ou la prise en charge jusqu’à ce que vous les mettez à niveau vers la version 4.x du runtime Functions.

  • Vos applications Functions sur le runtime v3 continueront de s’exécuter, et vos applications ne sont pas affectées. Après cette date, vous pouvez déployer du code sur ces applications Functions. Toutefois, nous pouvons supprimer la possibilité pour vous de créer des applications ciblant le runtime Functions v3 à l’aide de chemins d’accès courants.

  • Pour plus d’informations et pour obtenir des conseils sur la migration, consultez :

Valider la compatibilité de l’application de fonction pour le runtime v4

  • Accédez à votre application de fonction dans le Portail Azure. Sélectionnez Diagnostiquer et résoudre les problèmes pour ouvrir Azure Functions diagnostics. Dans la barre de recherche , tapez Mise à jour du langage de l’application de fonction ou de la version du runtime pour l’exécuter directement. Le rapport de diagnostic inclut des conseils sur la mise à jour. Une fois la validation terminée, suivez les recommandations et résolvez les problèmes dans votre application.
  • Nous fournissons également un validateur de pré-mise à niveau pour vous aider à identifier les problèmes potentiels lors de la migration de votre application de fonction vers la version 4.x. Dans la même barre de recherche diagnostics, tapez Functions 4.x Pre-Upgrade Validateator pour l’exécuter directement. Une fois la validation terminée, suivez les recommandations et résolvez les problèmes dans votre application.
  • Nous vous recommandons vivement de mettre à niveau votre environnement de projet local vers la version 4.x. Testez entièrement votre application localement à l’aide de la version 4.x des outils de base Azure Functions.
  • Envisagez d’utiliser un emplacement de préproduction pour tester et vérifier votre application dans Azure sur la nouvelle version du runtime avant de la déployer sur un emplacement de production. N’oubliez pas de définir WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 pour la migration avec des emplacements.

Modifier la version du runtime Functions pour Windows

  1. Définissez FUNCTIONS_EXTENSION_VERSION, qui est un paramètre d’application dans le volet Configuration Portail Azure, sur ~4. Pour plus d’informations, consultez Modifier la version du runtime.
  2. Définissez le paramètre de netFrameworkVersion site sur cible .NET 6. netFrameworkVersion est un paramètre SiteConfig, et non un paramètre d’application. Et il n’est pas directement disponible dans le Portail Azure. Mais vous pouvez le définir à l’aide d’Azure Resource Explorer ou d’Azure CLI/PowerShell.

Pour plus d’informations, consultez Versions du runtime Functions.

Modifier la version du runtime Functions pour Linux

  1. Définissez FUNCTIONS_EXTENSION_VERSION, qui est un paramètre d’application dans le volet Configuration Portail Azure, sur ~4. Pour plus d’informations, consultez Modifier la version du runtime.
  2. Définissez LinuxFxVersion, à l’aide de l’interface de ligne de commande (CLI) sur <Language>|<LanguageVersion>, en fonction du langage utilisé. Pour plus d’informations, consultez Utilisation de LinuxFxVersion pour les applications de fonction Linux. Par exemple, pour effectuer une mise à jour vers .NET 6, vous pouvez définir LinuxFxVersion sur dotnet|6.0 et FUNCTIONS_EXTENSION_VERSION~4sur .

Pour plus d’informations, consultez Versions du runtime Functions.

Obtenir la liste des langues prises en charge par la version du runtime

Consultez la liste des langues prises en charge par la version du runtime.

Mettre à jour le paramètre de version de langue pour l’application de fonction après la mise à jour du code

Utilisation des proxys Azure Functions

La prise en charge des proxys est à nouveau disponible dans la version 4.x afin que vous puissiez mettre à niveau vos applications de fonction vers la dernière version du runtime. Toutefois, nous vous recommandons de passer à l’intégration de vos applications de fonction avec Azure Gestion des API dès que possible. Gestion des API vous permet de tirer parti d’un ensemble plus complet de fonctionnalités pour définir, sécuriser, gérer et monétiser vos API basées sur Functions. Pour plus d’informations, consultez Guide pratique pour migrer vers APIM et Intégrer des fonctions avec APIM à l’aide de Visual Studio.

Obtenir la liste de toutes les applications Azure Functions qui utilisent runtime version 1.x, 2.x ou 3.x

  1. Accédez à votre application de fonction dans le Portail Azure.
  2. Sélectionnez Diagnostiquer et résoudre les problèmes pour ouvrir Azure Functions diagnostics.
  3. Dans la barre de recherche , tapez Mise à jour du langage de l’application de fonction ou de la version du runtime pour l’exécuter directement.
  4. Dans le rapport de diagnostic, faites défiler vers le bas et sélectionnez Lister tous les détails de l’affichage de l’application>de fonction.
  5. Définissez les filtres de recherche et sélectionnez Afficher pour obtenir la liste des applications de fonctions dans l’abonnement actuel.

Vous pouvez également utiliser App Service appels d’API REST (GetConfiguration) pour le déterminer. LinuxFxVersion et WindowsFxVersion fournissez les informations de version.

Déplacer une application .NET Framework 4.6.1 du runtime Functions v1 vers v4

.NET Framework 4.6.1 étant en fin de vie, les applications doivent être mises à niveau vers .NET Framework 4.8. Dans Functions v4, vous pouvez exécuter une application .NET Framework 4.8 en mode hors processus. Pour plus d’informations, consultez le guide de processus isolé.

Une application de fonction migrée ne démarre pas ou rencontre des problèmes d’exécution

  • Pour les applications .NET, n’oubliez pas de mettre à jour le code vers .NET 6 avant de générer et de déployer.
  • Double case activée la version runtime de l’application dans le Portail Azure.
  • Pour les applications Windows, vous devez également définir netFrameworkVersion à l’aide de l’interface CLI ou de PowerShell.
  • Vérifiez que vous utilisez les offres groupées d’extensions 2.x ou ultérieures, comme recommandé. La version 4.x du runtime Functions nécessite les versions 2.x ou 3.0.0.
  • La connexion au Stockage Azure à l’aide d’AzureWebJobsDashboard n’est plus prise en charge dans la version 4.x. Au lieu de cela, utilisez Application Insights pour la surveillance.
  • Si vous recevez un message indiquant que Azure Functions runtime est inaccessible et que vous partagez des comptes de stockage, consultez Considérations relatives à l’ID d’hôte.
  • Azure Functions 4.x ne prend pas en charge les Node.js 10 et 12, Python 3.6 et PowerShell 6. Pour plus d’informations, consultez Versions de langage prises en charge pour le runtime v4.
  • Pour les fonctions Python, s’il existe des erreurs liées à la collision de module et au module introuvable, essayez de définir PYTHON_ISOLATE_WORKER_DEPENDENCIES sur 1 dans les paramètres de l’application.
  • Consultez Migration d’applications de fonction existantes.
  • Pour les problèmes d’exécution, à partir de l’option Diagnostiquer et résoudre les problèmes dans le Portail Azure, recherchez Application de fonction hors service ou signalant des erreurs, puis passez en revue le rapport de diagnostic pour les messages d’erreur et les solutions. Examinez également le détecteur de vérifications de la configuration de la fonction pour vous assurer que la configuration est correcte.
  • Consultez le blog Problèmes lors de la mise à niveau d’applications de fonction Azure vers V4 pour obtenir des conseils de dépannage supplémentaires.

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.