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

Article
02/09/2024

La prise en charge d’une pile de langage donnée dans Azure Functions se limite à des versions spécifiques. À mesure que de nouvelles versions sont disponibles, vous pouvez mettre à jour vos applications pour tirer parti de leurs fonctionnalités. La prise en charge dans Functions peut également se terminer pour les versions antérieures, généralement alignées sur les chronologies de fin de support de la communauté. Pour en savoir plus, consultez l’article Stratégie de support du runtime de langage. Pour vous assurer que vos applications continuent de bénéficier du support, vous devez suivre les instructions décrites dans cet article pour les mettre à jour vers les dernières versions disponibles.

Le mode de mise à jour de votre application de fonction dépend des éléments suivants :

Le langage que vous utilisez pour créer vos fonctions. Veillez à choisir votre langage de programmation en haut de l’article.
Le système d’exploitation sur lequel votre application s’exécute dans Azure : Windows ou Linux.
Le plan d’hébergement.

Remarque

Cet article explique comment mettre à jour la version .NET d’une application à l’aide du modèle Worker isolé. Les applications qui s’exécutent sur des versions antérieures de .NET avec le modèle in-process peuvent être mises à jour pour cibler .NET 8 ou migrer du modèle in-process vers le modèle Worker isolé.

Préparation de la mise à jour

Avant de mettre à jour la configuration de la pile pour votre application de fonction dans Azure, vous devez effectuer ces tâches :

1. Vérifier vos fonctions localement

Assurez-vous de tester et de vérifier votre code de fonction localement sur la nouvelle version cible.

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

Vérifiez que vous avez installé la version cible du Kit de développement logiciel (SDK) .NET.

Si vous ciblez une version préliminaire, consultez les instructions Functions pour obtenir une préversion des versions de .NET pour vous assurer que la version est prise en charge. Des étapes supplémentaires peuvent être nécessaires pour les préversions .NET.
Mettez à jour vos références vers les dernières versions de Microsoft.Azure.Functions.Worker et Microsoft.Azure.Functions.Worker.Sdk.
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. Consultez l’article sur les infrastructures cibles pour connaître les spécificités relatives à la version choisie.

La modification de l’infrastructure cible de votre projet peut également nécessiter la modification de certaines parties de votre chaîne d’outils, en dehors du code du projet. Par exemple, dans VS Code, vous devrez peut-être mettre à jour le paramètre d’extension azureFunctions.deploySubpath par le biais des paramètres utilisateur ou le fichier .vscode/settings.json de votre projet. Recherchez les dépendances sur la version de l’infrastructure qui peuvent exister en dehors de votre code de projet, dans le cadre des étapes de génération ou d’un pipeline CI/CD.
Effectuez les mises à jour du code de votre projet requises par la nouvelle version .NET. Consultez les notes de publication de la version pour en connaître les détails. Vous pouvez également utiliser l’Assistant Mise à niveau de .NET pour vous aider à mettre à jour votre code en réponse aux modifications apportées aux versions principales.

Une fois ces modifications effectuées, régénérez votre projet et testez-le pour vérifier que votre application s’exécute comme prévu.

2. Passer au runtime Functions le plus récent

Vérifiez 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.

Azure portal
Azure CLI

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

Dans le Portail Azure, recherchez votre application de fonction, puis sélectionnez Configuration sur le côté gauche sous Paramètres.
Sélectionnez l’onglet Paramètres du runtime de la fonction et vérifiez la valeur Version de runtime pour voir si votre application de fonction s’exécute sur la version 4.x du runtime Functions (~4).

Utilisez cette commande az functionapp config appsettings list pour vérifier la version de votre runtime :

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

Le paramètre FUNCTIONS_EXTENSION_VERSION définit la version du runtime. La valeur de ~4 signifie que votre application de fonction est déjà en cours d’exécution sur la dernière version mineure de la version majeure (4.x) la plus récente.

Si vous devez d’abord 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. Vous devez suivre les instructions de ces articles sans vous contenter de modifier le paramètre FUNCTIONS_EXTENSION_VERSION.

Publier des mises à jour d’application

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

Conseil

Pour simplifier le processus de mise à jour, réduire les temps d’arrêt de vos fonctions et fournir un potentiel de restauration, vous devez publier votre application mise à jour dans un emplacement de préproduction. Pour plus d’informations, consultez l’article Emplacements de déploiement Azure Functions.

Lorsque vous publiez votre application mise à jour dans un emplacement de préproduction, veillez à suivre les instructions de mise à jour spécifiques de 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 varie selon que vous l’exécutez 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 :

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version de Java vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version .NET vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version Node.js vers la version souhaitée.
Sélectionnez Enregistrer, puis 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 :

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version .NET vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Remarque

Vous pouvez utiliser uniquement le Portail Azure pour mettre à jour les applications de fonction sur Linux hébergées dans un plan Premium ou un plan (App Service) dédié. Pour les applications sur Linux hébergées dans un plan de consommation, vous devez utiliser Azure CLI à la place.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version de Java vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version .NET vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version Node.js vers la version souhaitée.
Sélectionnez Enregistrer, puis 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 :

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version .NET vers la version souhaitée.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Dans le Portail Azure, recherchez votre application de fonction et sélectionnez Configuration sur le côté gauche. Lorsque vous utilisez un emplacement de préproduction, veillez à sélectionner d’abord l’emplacement spécifique.
Dans l’onglet Paramètres généraux, mettez à jour la version Python vers la version souhaitée.

Remarque

Vous ne pouvez pas modifier la version Python lors de l’exécution dans un plan de consommation.
Sélectionnez Enregistrer, puis lorsque vous êtes averti d’un redémarrage, sélectionnez Continuer.

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

Commencez par utiliser la commande az functionapp list-runtimes pour afficher les valeurs de version prises en charge pour votre langage. Exécutez ensuite la commande az functionapp config set pour mettre à jour la version du langage de votre application de fonction :

Exécutez la commande az functionapp list-runtimes pour afficher les valeurs de version prises en charge pour .NET sur le modèle Worker isolé :

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

Exécutez la commande az functionapp config set pour mettre à jour la version .NET de votre application de fonction :

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Commencez par utiliser la commande az functionapp list-runtimes pour afficher les valeurs de version prises en charge pour votre pile de langage (Node.js). Exécutez ensuite la commande az functionapp config set pour mettre à jour la version Node.js de votre application de fonction :

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Dans cet exemple, remplacez <APP_NAME> et <RESOURCE_GROUP> par le nom de votre application de fonction et du groupe de ressources, respectivement. Remplacez également <VERSION> par la version du langage prise en charge vers laquelle vous effectuez la mise à jour. Si vous n’utilisez aucun emplacement intermédiaire, supprimez le paramètre --slot.

Remarque

Vous ne pouvez pas modifier la version Python lors de l’exécution dans un plan de consommation.

Exécutez la commande az functionapp list-runtimes pour afficher le paramètre du site linuxFxVersion pris en charge pour votre version de langage :

Exécutez la commande az functionapp list-runtimes pour afficher le paramètre du site linuxFxVersion pris en charge pour votre version de pile de langage :

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

Exécutez la commande az functionapp config set pour mettre à jour le paramètre du site pour la nouvelle version du langage de votre application de fonction :

Exécutez la commande az functionapp config set pour mettre à jour le paramètre du site pour la nouvelle version de pile de votre application de fonction :

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

Dans cet exemple, remplacez <APP_NAME> et <RESOURCE_GROUP> par le nom de votre application de fonction et du groupe de ressources, respectivement. Remplacez également <LANGUAGE|VERSION> par la linuxFxVersion pour votre mise à jour. Si vous n’utilisez aucun emplacement intermédiaire, supprimez le paramètre --slot.

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

Permuter des emplacements

Si vous effectuez le déploiement du projet de code et mettez à jour les paramètres dans un emplacement de préproduction, vous devez échanger l’emplacement de préproduction en production. Pour plus d’informations, consultez la section Permuter des emplacements.