Partager via

Mettre à jour les versions des piles de langage dans Azure Functions

Dans Azure Functions, la prise en charge d’une pile de langages est limitée à des versions spécifiques. À mesure que de nouvelles versions deviennent disponibles, vous pouvez mettre à jour vos applications de fonction pour tirer parti des nouvelles fonctionnalités. La prise en charge dans Functions peut également se terminer par des versions antérieures et est généralement alignée sur les chronologies de fin de support de la communauté. Pour plus d’informations, consultez la stratégie de prise en charge du runtime de langage. Pour connaître les versions prises en charge de différentes langues, consultez Langues par version du runtime.

Pour vous assurer que vos applications de fonction continuent à recevoir de la prise en charge, suivez les instructions de cet article pour les mettre à jour vers les dernières versions disponibles. La façon dont vous mettez à jour votre application de fonction dépend de plusieurs facteurs :

  • Langage que vous utilisez pour développer vos applications de fonction. Veillez à sélectionner votre langage de programmation en haut de cet article.
  • Système d’exploitation sur lequel votre application de fonction s’exécute dans Azure : Windows ou Linux.
  • Le plan d’hébergement.

Remarque

Cet article vous montre comment mettre à jour la version .NET d’une application de fonction qui utilise le modèle worker isolé. Si votre application de fonction s’exécute sur une version antérieure de .NET et utilise le modèle in-process, tenez compte des options suivantes :

Conditions préalables

  • Un compte Azure avec un abonnement actif. Créez-en un gratuitement.
  • Application de fonction hébergée dans l’un des plans Functions suivants :
    • Premium
    • Dedicated
    • Consumption

Préparer votre application de fonction

Avant de mettre à jour la configuration de la pile pour votre application de fonction dans Azure, effectuez les tâches décrites dans les sections suivantes.

Vérifier votre application de fonction localement

Testez et vérifiez localement le code de votre application de fonction sur la nouvelle version cible.

Pour mettre à jour le projet sur votre ordinateur local, procédez comme suit :

  1. Vérifiez que la version cible du Kit de développement logiciel (SDK) .NET est installée.

    Si vous ciblez une version en préversion, consultez les instructions functions relatives à la préversion des versions .NET pour vous assurer que la version est prise en charge. L’utilisation des préversions .NET peut nécessiter plus d’étapes.

  2. Mettez à jour vos références aux dernières versions de Microsoft.Azure.Functions.Worker et Microsoft.Azure.Functions.Worker.Sdk.

  3. Mettez à jour l’infrastructure cible de votre projet vers la nouvelle version. Pour les projets C#, vous devez mettre à jour l’élément <TargetFramework> dans le fichier .csproj . Pour plus d’informations sur votre version, consultez Frameworks cibles.

    La modification de l’infrastructure cible de votre projet peut également nécessiter des modifications apportées aux parties de votre chaîne d’outils, en dehors du code du projet. Par exemple, dans Visual Studio Code, vous devrez peut-être mettre à jour le paramètre d’extension azureFunctions.deploySubpath dans vos paramètres utilisateur ou dans le fichier .vscode/settings.json de votre projet. Recherchez les dépendances sur la version du framework qui existent en dehors de votre code de projet, dans le cadre des étapes de génération ou d’un pipeline d’intégration continue et de livraison continue (CI/CD).

  4. Apportez des mises à jour à votre code de projet dont la nouvelle version .NET a besoin. Consultez les notes de publication de la version pour obtenir des informations spécifiques. Vous pouvez également utiliser l’Assistant Mise à niveau .NET pour mettre à jour votre code en réponse aux modifications apportées aux versions majeures.

Après avoir apporté ces modifications, régénérez votre projet et testez-le pour confirmer que votre application de fonction s’exécute comme prévu.

Accéder au dernier runtime Functions

Assurez-vous que votre application de fonction s’exécute sur la dernière version du runtime Functions (version 4.x). Vous pouvez déterminer la version du runtime dans le Portail Azure ou à l’aide d’Azure CLI.

Utilisez cette procédure pour déterminer la version de votre runtime Functions :

  1. Dans le portail Azure, recherchez et sélectionnez votre application de fonction. Dans le menu latéral, sélectionnez Paramètres>Configuration.

  2. Accédez à l’onglet Paramètres d’exécution de la fonction et vérifiez la valeur de la version d’exécution. Votre application de fonction doit s’exécuter sur la version 4.x du runtime Functions (~4).

Si vous devez mettre à jour votre application de fonction vers la version 4.x, consultez Migrer des applications d’Azure Functions version 1.x vers la version 4.x ou Migrer des applications d’Azure Functions version 3.x vers la version 4.x. Suivez les instructions de ces articles plutôt que de modifier simplement le FUNCTIONS_EXTENSION_VERSION paramètre.

Publier les mises à jour de l’application de fonction

Si vous avez mis à jour votre application de fonction pour qu’elle s’exécute correctement sur la nouvelle version, publiez les mises à jour de l’application de fonction avant de mettre à jour la configuration de la pile pour votre application de fonction.

Conseil

Pour simplifier le processus de mise à jour, réduisez les temps d’arrêt de vos applications de fonction et fournissez une version potentielle pour la restauration, vous devez publier votre application de fonction mise à jour sur un emplacement intermédiaire. Pour plus d’informations, consultez l’article Emplacements de déploiement Azure Functions.

Lorsque vous publiez votre application de fonction mise à jour sur un emplacement intermédiaire, veillez à suivre les instructions de mise à jour spécifiques à l’emplacement dans le reste de cet article. Vous échangerez plus tard l’emplacement de préproduction mis à jour en production.

Mettre à jour la configuration de la pile

La façon dont vous mettez à jour la configuration de la pile dépend de l’exécution de votre application de fonction sur Windows ou sur Linux dans Azure.

Lorsque vous utilisez un emplacement de préproduction, veillez à cibler vos mises à jour vers l’emplacement approprié.

Effectuez les étapes suivantes pour mettre à jour la version de Java :

  1. Dans le portail Azure, recherchez et sélectionnez votre application de fonction. Dans le menu latéral, sélectionnez Paramètres>Configuration. Si vous avez un environnement de mise en scène, sélectionnez l'emplacement concerné.

  2. Dans l’onglet Paramètres généraux, mettez à jour la version Java vers la version souhaitée.

  3. Cliquez sur Enregistrer. Lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

Pour mettre à jour la version .NET, procédez comme suit :

  1. Dans le portail Azure, recherchez et sélectionnez votre application de fonction. Dans le menu latéral, sélectionnez Paramètres>Configuration. Si vous avez un environnement de mise en scène, sélectionnez l'emplacement concerné.

  2. Dans l’onglet Paramètres généraux, mettez à jour la version .NET vers la version souhaitée.

  3. Cliquez sur Enregistrer. Lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

Pour mettre à jour la version Node.js, procédez comme suit :

  1. Dans le portail Azure, recherchez et sélectionnez votre application de fonction. Dans le menu latéral, sélectionnez Paramètres>Configuration. Si vous avez un environnement de mise en scène, sélectionnez l'emplacement concerné.

  2. Dans l’onglet Paramètres généraux, mettez à jour la version Node.js vers la version souhaitée.

  3. Cliquez sur Enregistrer. Lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer. Cette modification met à jour le paramètre d’application WEBSITE_NODE_DEFAULT_VERSION.

Pour mettre à jour la version de PowerShell, procédez comme suit :

  1. Dans le portail Azure, recherchez et sélectionnez votre application de fonction. Dans le menu latéral, sélectionnez Paramètres>Configuration. Si vous avez un environnement de mise en scène, sélectionnez l'emplacement concerné.

  2. Dans l’onglet Paramètres généraux, mettez à jour la version PowerShell Core vers la version souhaitée.

  3. Cliquez sur Enregistrer. Lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

Les applications Python ne sont pas prises en charge sur Windows. Accédez à l’onglet Linux à la place.

Votre application de fonction redémarre après que vous avez mis à jour la version.

Permuter des emplacements

Si vous utilisez un emplacement intermédiaire pour déployer votre projet de code et mettre à jour vos paramètres, échangez l’emplacement intermédiaire en production. Pour plus d’informations, consultez la section Permuter des emplacements.

Contenu connexe

Guide du développeur Java

Guide pour l’exécution d’Azure Functions C# dans un processus Worker isolé

Guide du développeur Node.js

Guide de développement Python

Guide des développeurs PowerShell

  • Last updated on