Créer et gérer des applications de fonction dans le plan Consommation flexible

Cet article explique comment créer des applications de fonction hébergées dans le plan Consommation flexible dans Azure Functions. Il montre également comment gérer certaines fonctionnalités d’une application hébergée par un plan Consommation flexible.

Les ressources d’application de fonction sont propres au langage. Veillez à choisir votre langage de programmation préféré en haut de l’article.

Prérequis

• Compte Azure avec un abonnement actif. Si vous n’en avez pas déjà un, vous pouvez créer un compte gratuit.

• Azure CLI : utilisé pour créer et gérer des ressources dans Azure. Lors de l’utilisation d’Azure CLI sur votre ordinateur local, veillez à utiliser la version 2.60.0 ou ultérieure. Vous pouvez également utiliser Azure Cloud Shell, qui a la version correcte d’Azure CLI.

• Visual Studio Code : utilisé pour créer et développer des applications, créer des ressources Azure, et déployer des projets de code sur Azure. Lors de l’utilisation de Visual Studio Code, veillez à installer également la dernière extension Azure Functions. Vous pouvez également installer le pack d’extension Azure Tools.

• Bien que cela ne soit pas obligatoire pour créer une application de plan Consommation flexible, vous avez besoin d’un projet de code pour pouvoir déployer et valider une nouvelle application de fonction. Effectuez la première partie de l’un de ces articles de démarrage rapide où vous créez un projet de code avec une fonction déclenchée par HTTP :

  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code
  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code
  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code

  Pour créer une application dans un nouveau plan Consommation flexible pendant un déploiement Maven, vous devez créer votre projet d’application local, puis mettre à jour le fichier pom.xml du projet. Pour plus d’informations, consultez Créer une application Java Consommation flexible à l’aide de Maven.

  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code
  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code
  • Créer un projet Azure Functions à partir de la ligne de commande
  • Créer un projet Azure Functions avec Visual Studio Code

  Revenez à cet article après avoir créé et exécuté le projet local, mais avant d’être invité à créer des ressources Azure. Vous créerez l’application de fonction et d’autres ressources Azure dans la section suivante.

Créer une application Consommation flexible

Cette section montre comment créer une application de fonction dans le plan Consommation flexible à l’aide d’Azure CLI, du portail Azure ou de Visual Studio Code. Pour obtenir un exemple de création d’une application dans un plan Consommation flexible à l’aide de modèles Bicep/ARM, consultez le dépôt Consommation flexible.

Vous pouvez ignorer cette section si vous choisissez de créer et déployer votre application à l’aide de Maven.

Pour prendre en charge votre code de fonction, vous devez créer trois ressources :

• Un groupe de ressources, qui est un conteneur logique pour les ressources associées.
• Un compte de stockage, qui sert à conserver l’état et d’autres informations sur vos fonctions.
• Une application de fonction dans le plan Consommation flexible, qui fournit l’environnement d’exécution de votre code de fonction. Une application de fonction est mappée à votre projet de fonction local. Elle vous permet de regrouper les fonctions en tant qu’unité logique pour faciliter la gestion, le déploiement et le partage des ressources dans le plan Consommation flexible.

Azure CLI

1. Si vous ne l’avez pas déjà fait, connectez-vous à Azure :

   az login
   

   La commande az login vous connecte à votre compte Azure.

2. Utilisez la commande az functionapp list-flexconsumption-locations pour passer en revue la liste des régions qui prennent actuellement en charge Consommation flexible.

   az functionapp list-flexconsumption-locations --output table
   

3. Créez un groupe de ressources dans l’une des régions actuellement prises en charge :

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   Dans la commande ci-dessus, remplacez <RESOURCE_GROUP> par une valeur unique dans votre abonnement, et <REGION> par l’une des régions actuellement prises en charge. La commande az group create crée un groupe de ressources.

4. Créez un compte de stockage universel dans votre groupe de ressources et votre région :

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   Dans l’exemple précédent, remplacez <STORAGE_NAME> par un nom qui vous convient et qui est unique dans Stockage Azure. Les noms doivent contenir entre 3 et 24 caractères, et comporter uniquement des lettres minuscules. Standard_LRS spécifie un compte universel, qui est pris en charge par Functions. La commande az storage account create crée le compte de stockage.

   Important

   Le compte de stockage permet de stocker les données importantes de l’application, dont parfois le code proprement dit de l’application. Vous devez limiter l’accès des autres applications et utilisateurs au compte de stockage.

5. Créer l’application de fonction dans Azure :

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   Les applications C# qui s’exécutent in-process ne sont pas prises en charge lors de l’exécution dans un plan Consommation flexible.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   Pour les applications Java, Java 11 est également pris en charge actuellement.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   Pour les applications Python, Python 3.10 est également pris en charge actuellement.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   Dans cet exemple, remplacez <RESOURCE_GROUP> et <STORAGE_NAME> respectivement par le groupe de ressources et le nom du compte que vous avez utilisés à l’étape précédente. Remplacez également <APP_NAME> par un nom global unique qui vous convient. <APP_NAME> représente également le domaine DNS (Domain Name System) par défaut pour l’application de fonction. La commande az functionapp create crée l’application de fonction dans Azure.

   Cette commande crée une application de fonction s’exécutant dans le plan Consommation flexible.

   Étant donné que vous avez créé l’application sans spécifier d’instances toujours prêtes, votre application génère des coûts uniquement lors de l’exécution active de fonctions. La commande crée aussi une instance d’Azure Application Insights associée dans le même groupe de ressources, avec laquelle vous pouvez superviser votre application de fonction et visualiser les journaux. Pour plus d’informations, consultez Surveiller l’exécution des fonctions Azure.

Azure portal

1. Dans le portail Azure, dans le menu ou la page Accueil, sélectionnez Créer une ressource.

2. Sélectionnez Démarrer, puis Créer sous Application de fonction.

3. Sous Sélectionner une option d’hébergement, choisissez Consommation flexible>Sélectionner.

4. Dans la page De base, utilisez les paramètres d’application de fonction comme indiqué dans le tableau ci-dessous :

   Paramètre	Valeur suggérée	Description
   Abonnement	Votre abonnement	Abonnement dans lequel vous créez votre application de fonction.
   Groupe de ressources	myResourceGroup	Nom du nouveau groupe de ressources dans lequel vous créez votre application de fonction.
   Nom de l’application de fonction	Nom globalement unique	Nom qui identifie votre nouvelle Function App. Les caractères valides sont a-z (insensible à la casse), 0-9et -.
   Région	Région recommandée	Sélectionnez une région proche de chez vous, ou proche d’autres services auxquels vos fonctions peuvent accéder. Les régions non prises en charge ne sont pas affichées. Pour plus d’informations, consultez Afficher les régions actuellement prises en charge.
   Pile d’exécution	Langage préféré	Choisissez l’une des piles de runtime de langage prises en charge. La modification dans le portail à l’aide de Visual Studio Code pour le web est actuellement disponible uniquement pour les applications Node.js, PowerShell et Python. La bibliothèque de classes C# et les fonctions Java doivent être développées localement.
   Version	Version du langage	Choisissez une version prise en charge de votre pile de runtime de langage.
   Taille des instances	Par défaut	Détermine la quantité de mémoire d’instance allouée pour chaque instance de votre application. Pour plus d’informations, consultez Mémoire d’instance.

5. Acceptez les options par défaut dans les onglets restants, y compris le comportement par défaut de création d’un compte de stockage sous l’onglet Stockage, ainsi qu’une nouvelle instance Application Insight sous l’onglet Surveillance. Vous pouvez également choisir d’utiliser un compte de stockage existant ou une instance Application Insights.

6. Sélectionnez Examiner + créer pour examiner la configuration de l'application que vous avez choisie, puis sélectionnez Créer pour approvisionner et déployer l'application de fonction.

7. Cliquez sur l’icône Notifications en haut à droite du portail pour voir le message Le déploiement a été effectué.

8. Sélectionnez Accéder à la ressource pour afficher votre nouvelle application de fonction. Vous pouvez également sélectionner Épingler au tableau de bord. L’épinglage permet de revenir plus facilement à cette ressource d’application de fonction à partir de votre tableau de bord.

Visual Studio Code

1. Appuyez sur F1 et, dans la palette de commandes, entrez Azure Functions : Créer une application de fonction dans Azure... (Avancé).

2. Si vous n’êtes pas connecté, vous êtes invité à le faire avec Se connecter à Azure. Vous pouvez également créer un compte Azure gratuit. Une fois la connexion établie à partir du navigateur, revenez à Visual Studio Code.

3. Suivez les invites et fournissez ces informations :

   Prompt	Sélection
   Entrez un nom globalement unique pour la nouvelle application de fonction.	Tapez un nom global unique identifiant votre nouvelle application de fonction et sélectionnez Entrée. Les caractères valides pour un nom d’application de fonction sont a-z, 0-9 et -.
   Sélectionnez un plan d’hébergement.	Choisissez Consommation flexible.
   Sélectionnez une pile de runtime.	Choisissez l’une des versions de pile de langage prises en charge.
   Sélectionnez un groupe de ressources pour les nouvelles ressources.	Choisissez Créer un groupe de ressources et tapez un nom de groupe de ressources, par exemple myResourceGroup, puis sélectionnez Entrée. Vous pouvez également sélectionner un groupe de ressources existant.
   Sélectionnez un emplacement pour les nouvelles ressources.	Sélectionnez une localisation dans une région prise en charge proche de chez vous, ou proche d’autres services auxquels vos fonctions accèdent. Les régions non prises en charge ne sont pas affichées. Pour plus d’informations, consultez Afficher les régions actuellement prises en charge.
   Sélectionnez un compte de stockage.	Choisissez Créer un nouveau compte de stockage. À l’invite, spécifiez un nom global unique pour le nouveau compte de stockage utilisé par votre application de fonction, puis sélectionnez Entrée. Les noms des comptes de stockage doivent comporter entre 3 et 24 caractères, et contenir uniquement des lettres minuscules et des chiffres. Vous pouvez également sélectionner un compte existant.
   Sélectionnez une ressource Application Insights pour votre application.	Choisissez Créer une nouvelle ressource Application Insights et, à l’invite, spécifiez le nom de l’instance utilisée pour stocker les données d’exécution de vos fonctions.

   Une notification s’affiche une fois que votre application de fonction est créée. Sélectionnez Afficher la sortie de dans cette notification pour afficher les résultats de la création et du déploiement, y compris les ressources Azure que vous avez créées.

Déployer votre projet de code

Vous pouvez ignorer cette section si vous choisissez de créer et déployer votre application à l’aide de Maven.

Vous pouvez choisir de déployer votre code de projet sur une application de fonction existante à l’aide de différents outils :

Visual Studio Code

Important

Le déploiement vers une application de fonction existante remplace toujours le contenu de cette application dans Azure.

1. Dans la palette de commandes, entrez puis sélectionnez Azure Functions : Déployer sur une application de fonction.

2. Sélectionnez l’application de fonction que vous venez de créer. Quand vous êtes invité à remplacer les déploiements précédents, sélectionnez Déployer pour déployer le code de votre fonction sur la nouvelle ressource de l’application de fonction.

3. Une fois le déploiement terminé, sélectionnez Afficher la sortie pour voir les résultats de la création et du déploiement, y compris les ressources Azure que vous avez créées. Si vous manquez la notification, sélectionnez l’icône de cloche dans le coin inférieur droit pour la voir à nouveau.

   

Core Tools

Dans votre dossier de projet racine, exécutez cette commande func azure functionapp publish :

func azure functionapp publish <APP_NAME>

Dans cet exemple, remplacez <APP_NAME> par le nom de votre application. Un déploiement réussi donne des résultats similaires à la sortie suivante (tronquée pour des raisons de simplicité) :

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

Créer et déployer votre application à l’aide de Maven

Vous pouvez utiliser Maven pour créer une application de fonction hébergée Consommation flexible et les ressources requises pendant le déploiement en modifiant le fichier pom.xml.

1. Créez un projet de code Java en suivant la première partie de l’un de ces articles de démarrage rapide :

   • Créer un projet Azure Functions à partir de la ligne de commande
   • Créer un projet Azure Functions avec Visual Studio Code

2. Dans votre projet de code Java, ouvrez le fichier pom.xml et apportez ces modifications pour créer votre application de fonction dans le plan Consommation flexible :

   • Remplacez la valeur de <properties>.<azure.functions.maven.plugin.version> par 1.34.0.

   • Dans la section <plugin>.<configuration> relative au azure-functions-maven-plugin, ajoutez ou supprimez les marques de commentaire de l’élément <pricingTier> comme suit :

     <pricingTier>Flex Consumption</pricingTier>
     

3. (Facultatif) Personnalisez le plan Consommation flexible dans votre déploiement Maven en incluant également ces éléments dans la section <plugin>.<configuration> :

   • <instanceSize> : définit la taille de mémoire d’instance pour l’application de fonction. La valeur par défaut est 2048.
   • <maximumInstances> : définit la valeur la plus élevée pour le nombre maximal d’instances de l’application de fonction.
   • <alwaysReadyInstances> : définit le nombre d’instances toujours prêtes avec des éléments enfants pour les groupes de déclencheurs HTTP (<http>), les groupes Durable Functions (<durable>) et d’autres déclencheurs spécifiques (<my_function>). Lorsque vous définissez un nombre d’instances supérieur à zéro, vous êtes facturé pour ces instances, que vos fonctions s’exécutent ou non. Pour plus d'informations, consultez Facturation.

4. Avant d’effectuer le déploiement, connectez-vous à votre abonnement Azure à l’aide d’Azure CLI.

   az login
   

   La commande az login vous connecte à votre compte Azure.

5. Utilisez la commande suivante pour déployer votre projet de code sur une nouvelle application de fonction dans Consommation flexible.

   mvn azure-functions:deploy
   

   Maven utilise des paramètres dans le modèle pom.xml pour créer votre application de fonction dans un plan Consommation flexible dans Azure, ainsi que les autres ressources requises. Si ces ressources existent déjà, le code est déployé sur votre application de fonction, en remplaçant tout code existant.

Activer l’intégration du réseau virtuel Azure

Vous pouvez activer l’intégration de réseau virtuel pour votre application dans un plan Consommation flexible. Les exemples de cette section partent du principe que vous avez déjà créé un réseau virtuel avec un sous-réseau dans votre compte. Vous pouvez activer l’intégration de réseau virtuel lorsque vous créez votre application ou ultérieurement.

Important

Le plan Flex Consumption ne prend actuellement pas en charge les sous-réseaux dont les noms contiennent des caractères de soulignement (_).

Pour activer la mise en réseau virtuelle lorsque vous créez votre application :

Azure CLI

Vous pouvez activer l’intégration de réseau virtuel en exécutant la commande az functionapp create et en incluant les paramètres --vnet et --subnet.

1. Créez le réseau virtuel et le sous-réseau, si ce n’est déjà fait.

2. Effectuez les étapes 1 à 4 dans Créer une application Consommation flexible pour créer les ressources requises par votre application.

3. Exécutez la commande az functionapp create, y compris les paramètres --vnet et --subnet, comme dans cet exemple :

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   La valeur <VNET_RESOURCE_ID> est l’ID de ressource du réseau virtuel, qui est au format suivant : /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME>. Vous pouvez utiliser cette commande pour obtenir la liste des ID de réseau virtuel, filtrés par <RESOURCE_GROUP> : az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id.

Azure portal

Effectuez ces étapes pour créer votre application de fonction avec l’intégration de réseau virtuel et les ressources Azure associées.

1. Dans le portail Azure, dans le menu ou la page Accueil, sélectionnez Créer une ressource.

2. Sélectionnez Démarrer, puis Créer sous Application de fonction.

3. Sous Sélectionner une option d’hébergement, choisissez Consommation flexible>Sélectionner.

4. Dans la page De base, utilisez les paramètres d’application de fonction comme indiqué dans le tableau ci-dessous :

   Paramètre	Valeur suggérée	Description
   Abonnement	Votre abonnement	Abonnement dans lequel vous créez votre application de fonction.
   Groupe de ressources	myResourceGroup	Nom du nouveau groupe de ressources dans lequel vous créez votre application de fonction.
   Nom de l’application de fonction	Nom globalement unique	Nom qui identifie votre nouvelle Function App. Les caractères valides sont a-z (insensible à la casse), 0-9et -.
   Région	Région recommandée	Sélectionnez une région proche de chez vous, ou proche d’autres services auxquels vos fonctions peuvent accéder. Les régions non prises en charge ne sont pas affichées. Pour plus d’informations, consultez Afficher les régions actuellement prises en charge.
   Pile d’exécution	Langage préféré	Choisissez l’une des piles de runtime de langage prises en charge. La modification dans le portail à l’aide de Visual Studio Code pour le web est actuellement disponible uniquement pour les applications Node.js, PowerShell et Python. La bibliothèque de classes C# et les fonctions Java doivent être développées localement.
   Version	Version du langage	Choisissez une version prise en charge de votre pile de runtime de langage.
   Taille des instances	Par défaut	Détermine la quantité de mémoire d’instance allouée pour chaque instance de votre application. Pour plus d’informations, consultez Mémoire d’instance.

5. Acceptez les options par défaut dans les onglets restants, y compris le comportement par défaut de création d’un compte de stockage sous l’onglet Stockage, ainsi qu’une nouvelle instance Application Insight sous l’onglet Surveillance. Vous pouvez également choisir d’utiliser un compte de stockage existant ou une instance Application Insights.

6. Sous l’onglet Réseau, définissez Activer l’accès public sur Désactivé et Activer l’injection de réseau sur Activé.

7. Pour Réseau virtuel, sélectionnez ou créez un réseau virtuel dans la même région que votre application.

8. Définissez Activer l’intégration de réseau virtuel sur Activé et sélectionnez ou créez un sous-réseau.

9. Sélectionnez Vérifier + créer pour examiner la configuration de l’application que vous avez choisie, puis sélectionnez Créer pour approvisionner et déployer l’application de fonction avec mise en réseau virtuelle.

10. Cliquez sur l’icône Notifications en haut à droite du portail pour voir le message Le déploiement a été effectué.

11. Sélectionnez Accéder à la ressource pour afficher votre nouvelle application de fonction. Vous pouvez également sélectionner Épingler au tableau de bord. L’épinglage permet de revenir plus facilement à cette ressource d’application de fonction à partir de votre tableau de bord.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas activer la mise en réseau virtuelle lorsque vous utilisez Visual Studio Code pour créer votre application.

Pour obtenir des exemples de bout en bout de la création d’applications dans Consommation flexible avec l’intégration de réseau virtuel, consultez les ressources suivantes :

• Consommation flexible : HTTP vers Event Hubs à l’aide de l’intégration de réseau virtuel
• Consommation flexible : déclenchée à partir de Service Bus à l’aide de l’intégration de réseau virtuel

Pour modifier ou supprimer l’intégration de réseau virtuel dans une application existante :

Azure CLI

Utilisez la commande az functionapp vnet-integration add pour activer l’intégration de réseau virtuel à une application de fonction existante :

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

Utilisez la commande az functionapp vnet-integration remove pour désactiver l’intégration de réseau virtuel dans votre application :

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Utilisez la commande az functionapp vnet-integration list pour dresser la liste des intégrations de réseau virtuel actuelles pour votre application :

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Azure portal

Vous pouvez intégrer votre application existante à un réseau virtuel et un sous-réseau existants dans le portail.

1. Dans la page de votre application de fonction dans le portail Azure, développez Paramètres dans le menu de gauche, puis sélectionnez Réseau.

2. Sous Configuration du trafic sortant, sélectionnez Non configuré.

3. Dans la page Intégration de réseau virtuel, sélectionnez Ajouter l’intégration de réseau virtuel.

4. Sélectionnez un Réseau virtuel et un Sous-réseau existants, puis sélectionnez Se connecter.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas configurer la mise en réseau virtuelle dans Visual Studio Code.

Lors du choix d’un sous-réseau, ces considérations s’appliquent :

• Le sous-réseau que vous choisissez ne peut pas être déjà utilisé à d’autres fins, comme avec des points de terminaison privés ou des points de terminaison de service, ni être délégué à tout autre plan d’hébergement ou service.
• Vous pouvez partager le même sous-réseau avec plusieurs applications s’exécutant dans un plan Consommation flexible. Étant donné que les ressources réseau sont partagées entre toutes les applications, une application de fonction peut avoir un impact sur les performances des autres sur le même sous-réseau.
• Dans un plan Consommation flexible, une application de fonction unique peut utiliser jusqu’à 40 adresses IP, même lorsqu’elle est mise à l’échelle au-delà de 40 instances. Bien que cette règle générale soit utile lors de l’estimation de la taille du sous-réseau dont vous avez besoin, elle n’est pas strictement appliquée.

Configurer les paramètres de déploiement

Dans le plan Consommation flexible, le package de déploiement qui contient le code de votre application est conservé dans un conteneur Stockage Blob Azure. Par défaut, les déploiements utilisent le même compte de stockage (AzureWebJobsStorage) et la même valeur de chaîne de connexion que ceux utilisés par le runtime Functions pour tenir à jour votre application. La chaîne de connexion est stockée dans le paramètre d’application DEPLOYMENT_STORAGE_CONNECTION_STRING. Toutefois, vous pouvez désigner un conteneur d’objets blob dans un compte de stockage distinct comme source de déploiement pour votre code. Vous pouvez également modifier la méthode d’authentification utilisée pour accéder au conteneur.

Une source de déploiement personnalisée doit répondre à ces critères :

• Le compte de stockage doit déjà exister.
• Le conteneur à utiliser pour les déploiements doit également exister.
• Lorsque plusieurs applications utilisent le même compte de stockage, chacune doit avoir son propre conteneur de déploiement. L’utilisation d’un conteneur unique pour chaque application évite le remplacement des packages de déploiement, ce qui se produirait si les applications partageaient le même conteneur.

Lors de la configuration de l’authentification du stockage de déploiement, gardez à l’esprit ces considérations :

• Lorsque vous utilisez une chaîne de connexion pour vous connecter au compte de stockage de déploiement, le paramètre d’application qui contient la chaîne de connexion doit déjà exister.
• Lorsque vous utilisez une identité managée affectée par l’utilisateur, l’identité fournie est liée à l’application de fonction. Le rôle Storage Blob Data Contributor étendu au compte de stockage de déploiement est également attribué à l’identité.
• Lorsque vous utilisez une identité managée affectée par le système, une identité est créée lorsqu’une identité affectée par le système valide n’existe pas déjà dans votre application. Lorsqu’une identité affectée par le système existe, le rôle Storage Blob Data Contributor étendu au compte de stockage de déploiement est également attribué à l’identité.

Pour configurer les paramètres de déploiement lorsque vous créez votre application de fonction dans le plan Consommation flexible :

Azure CLI

Utilisez la commande az functionapp create et fournissez ces options supplémentaires qui personnalisent le stockage de déploiement :

Paramètre	Description
--deployment-storage-name	Nom du compte de stockage de déploiement.
--deployment-storage-container-name	Nom du conteneur dans le compte pour contenir le package de déploiement de votre application.
--deployment-storage-auth-type	Type d’authentification à utiliser pour la connexion au compte de stockage de déploiement. Les valeurs acceptées incluent StorageAccountConnectionString, UserAssignedIdentity et SystemAssignedIdentity.
--deployment-storage-auth-value	Lors de l’utilisation de StorageAccountConnectionString, ce paramètre est défini sur le nom du paramètre d’application qui contient la chaîne de connexion au compte de stockage de déploiement. Lorsque vous utilisez UserAssignedIdentity, ce paramètre est défini sur le nom de l’ID de ressource de l’identité que vous souhaitez utiliser.

Cet exemple crée une application de fonction dans le plan Consommation flexible avec un compte de stockage de déploiement distinct et une identité affectée par l’utilisateur :

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

Azure portal

À l’heure actuelle, vous ne pouvez pas configurer le stockage de déploiement lors de la création de votre application dans le portail Azure. Pour configurer le stockage de déploiement lors de la création de l’application, utilisez plutôt Azure CLI pour créer votre application.

Vous pouvez utiliser le portail pour modifier les paramètres de déploiement d’une application existante, comme indiqué dans la section suivante.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas configurer le stockage de déploiement lors de la création de votre application dans Azure à l’aide de Visual Studio Code.

Vous pouvez également modifier la configuration du stockage de déploiement pour une application existante.

Azure CLI

Utilisez la commande az functionapp deployment config set pour modifier la configuration du stockage de déploiement :

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

Azure portal

1. Dans la page de votre application de fonction dans le portail Azure, développez Paramètres dans le menu de gauche, puis sélectionnez Paramètres de déploiement.

2. Sous l’emplacement Package d’application, sélectionnez un Compte de stockage existant, puis sélectionnez un conteneur vide existant dans le compte.

3. Sous Authentification du stockage, sélectionnez votre type d’authentification préféré

   • Si vous avez sélectionné Chaîne de connexion, sélectionnez le nom du paramètre d’application qui contient la chaîne de connexion pour le compte de stockage de déploiement.

   • Si vous avez sélectionné Identité affectée par l’utilisateur, sélectionnez l’identité que vous souhaitez utiliser.

4. Sélectionnez Enregistrer pour mettre à jour l’application.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas configurer le stockage de déploiement pour votre application dans Azure à l’aide de Visual Studio Code.

Configurer la mémoire d’instance

La taille de mémoire d’instance utilisée par votre plan Consommation flexible peut être définie explicitement lorsque vous créez votre application. Pour plus d’informations sur les tailles prises en charge, consultez Mémoire d’instance.

Pour définir une taille de mémoire d’instance différente de la taille par défaut lors de la création de votre application :

Azure CLI

Spécifiez le paramètre --instance-memory dans votre commande az functionapp create. Cet exemple crée une application C# avec une taille d’instance de 4096 :

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

Azure portal

Lorsque vous créez votre application dans un plan Consommation flexible dans le portail Azure, vous pouvez choisir la taille de mémoire de votre instance dans le champ Taille des instances sous l’onglet Informations de base. Pour plus d’informations, consultez Créer une application Consommation flexible.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas contrôler la taille de mémoire d’instance lorsque vous utilisez Visual Studio Code pour créer votre application. La taille par défaut est utilisée.

À tout moment, vous pouvez modifier le paramètre de taille de mémoire d’instance utilisé par votre application.

Azure CLI

Cet exemple utilise la commande az functionapp scale config set pour définir le paramètre de taille de mémoire d’instance sur 4,096 Mo :

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 4096

Azure portal

1. Dans la page de votre application de fonction dans le portail Azure, développez Paramètres dans le menu de gauche, puis sélectionnez Échelle et concurrence.

2. Sélectionnez une option de Mémoire d’instance et sélectionnez Enregistrer pour mettre à jour l’application.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas modifier le paramètre de taille de mémoire d’instance pour votre application à l’aide de Visual Studio Code.

Définir le nombre d’instances toujours prêtes

Vous pouvez définir un certain nombre d’instances toujours prêtes pour la mise à l’échelle par fonction groupes ou fonctions individuelles, afin de conserver vos fonctions chargées et prêtes à s’exécuter. Il existe trois groupes spéciaux, comme dans la mise à l’échelle par fonction :

• http : toutes les fonctions déclenchées par HTTP dans l’application sont mises à l’échelle ensemble dans leurs propres instances.
• durable : toutes les fonctions déclenchées durables (orchestration, activité, entité) dans l’application sont mises à l’échelle ensemble dans leurs propres instances.
• blob : toutes les fonctions déclenchées par blob (Event Grid) dans l’application sont mises à l’échelle ensemble dans leurs propres instances.

Utilisez http, durable ou blob comme nom du paramètre de paire valeur de nom pour configurer toujours les nombres prêts pour ces groupes. Pour toutes les autres fonctions de l’application, vous devez configurer toujours prêt pour chaque fonction individuelle à l’aide du format function:<FUNCTION_NAME>=n.

Azure CLI

Utilisez le paramètre --always-ready-instances avec la commande az functionapp create pour définir une ou plusieurs désignations d’instances toujours prêtes. Cet exemple affecte la valeur 5 au nombre d’instances toujours prêtes pour toutes les fonctions déclenchées par HTTP :

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

Cet exemple affecte la valeur 3 au nombre d’instances toujours prêtes pour toutes les fonctions de déclencheur Durable, et affecte la valeur 2 au nombre d’instances toujours prêtes pour une fonction déclenchée Service Bus nommée function5 :

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

Azure portal

À l’heure actuelle, vous ne pouvez pas définir d’instances toujours prêtes lors de la création de votre application dans le portail Azure. Pour définir des instances toujours prêtes lors de la création de l’application, utilisez plutôt Azure CLI pour créer votre application.

Vous pouvez utiliser le portail pour modifier les instances toujours prêtes sur une application existante, comme indiqué dans la section suivante.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas définir d’instances toujours prêtes lors de la création de votre application dans Azure à l’aide de Visual Studio Code.

Vous pouvez également modifier les instances toujours prêtes sur une application existante en ajoutant ou en supprimant des désignations d’instances ou en modifiant le nombre de désignations d’instances existantes.

Azure CLI

Cet exemple utilise la commande az functionapp scale config always-ready set pour affecter la valeur 10 au nombre d’instances toujours prêtes pour le groupe de déclencheurs HTTP :

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

Pour supprimer des instances toujours prêtes, utilisez la commande az functionapp scale config always-ready delete, comme dans cet exemple qui supprime toutes les instances toujours prêtes du groupe de déclencheurs HTTP et également d’une fonction nommée hello_world :

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http function:hello_world

Azure portal

1. Dans la page de votre application de fonction dans le portail Azure, développez Paramètres dans le menu de gauche, puis sélectionnez Échelle et concurrence.

2. Sous Nombre minimal d’instances toujours prêtes, tapez http, blob, durable, ou en utilisant le format function:<FUNCTION_NAME>=n dans Déclencheur, et tapez le Nombre d’instances toujours prêtes.

3. Sélectionnez Enregistrer pour mettre à jour l’application.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas modifier les instances toujours prêtes à l’aide de Visual Studio Code.

Définir les limites de concurrence HTTP

À moins que vous ne définissiez des limites spécifiques, les valeurs par défaut de concurrence HTTP pour les applications de plan Consommation flexible sont déterminées en fonction du paramètre de taille de votre instance. Pour plus d’informations, consultez Concurrence de déclencheurs HTTP.

Voici comment définir des limites de concurrence HTTP pour une application existante :

Azure CLI

Utilisez la commande az functionapp scale config set pour définir des limites de concurrence HTTP spécifiques pour votre application, quelle que soit la taille de l’instance.

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

Cet exemple affecte la valeur 10 au niveau de concurrence des déclencheurs HTTP. Une fois que vous avez défini spécifiquement une valeur de concurrence HTTP, cette valeur est conservée même en cas de modification du paramètre de taille d’instance de votre application.

Azure portal

1. Dans la page de votre application de fonction dans le portail Azure, développez Paramètres dans le menu de gauche, puis sélectionnez Échelle et concurrence.

2. Sous Concurrence par instance, sélectionnez Affecter manuellement et tapez une limite spécifique.

3. Sélectionnez Enregistrer pour mettre à jour l’application.

Visual Studio Code

À l’heure actuelle, vous ne pouvez pas définir de limites de concurrence HTTP à l’aide de Visual Studio Code.

Afficher les régions actuellement prises en charge

Pour afficher la liste des régions qui prennent actuellement en charge les plans Consommation flexible :

1. Si vous ne l’avez pas déjà fait, connectez-vous à Azure :

   az login
   

   La commande az login vous connecte à votre compte Azure.

2. Utilisez la commande az functionapp list-flexconsumption-locations pour passer en revue la liste des régions qui prennent actuellement en charge Consommation flexible.

   az functionapp list-flexconsumption-locations --output table
   

Lorsque vous créez une application dans le portail Azure ou à l’aide de Visual Studio Code, les régions actuellement non prises en charge sont filtrées et ne figurent pas dans la liste des régions.

Contenu connexe

• Hébergement du plan Consommation flexible Azure Functions
• Options d’hébergement Azure Functions