Gérer votre application de fonctionManage your function app

Dans Azure Functions, une Function App fournit le contexte d’exécution de vos fonctions individuelles.In Azure Functions, a function app provides the execution context for your individual functions. Les comportements de la Function App s’appliquent à toutes les fonctions hébergées par une Function App donnée.Function app behaviors apply to all functions hosted by a given function app. Toutes les fonctions d’une application de fonction doivent être exprimées dans le même langage.All functions in a function app must be of the same language.

Les fonctions individuelles dans une application de fonction sont déployées ensemble et sont mises à l’échelle ensemble.Individual functions in a function app are deployed together and are scaled together. Toutes les fonctions de la même application de fonction partagent les ressources, par instance, à mesure que l’application de fonction est mise à l’échelle.All functions in the same function app share resources, per instance, as the function app scales.

Les chaînes de connexion, les variables d’environnement et d’autres paramètres d’application sont définis séparément pour chaque application de fonction.Connection strings, environment variables, and other application settings are defined separately for each function app. Toutes les données qui doivent être partagées entre les applications de fonction doivent être stockées en externe dans un magasin persistant.Any data that must be shared between function apps should be stored externally in a persisted store.

Cet article explique comment configurer et gérer vos applications de fonction.This article describes how to configure and manage your function apps.

Conseil

De nombreuses options de configuration peuvent également être gérées à l’aide d’Interface de ligne de commande Azure.Many configuration options can also be managed by using the Azure CLI.

Bien démarrer dans le portail AzureGet started in the Azure portal

Commencez par accéder au portail Azure et connectez-vous à votre compte Azure.To begin, go to the Azure portal and sign in to your Azure account. Dans la barre de recherche en haut du portail, tapez le nom de votre Function App et sélectionnez-la dans la liste.In the search bar at the top of the portal, type the name of your function app and select it from the list. Après avoir sélectionné votre Function App, la page suivante s’affiche :After selecting your function app, you see the following page:

Vue d’ensemble de Function App dans le portail Azure

Vous pouvez accéder à tout ce dont vous avez besoin pour gérer votre application de fonction à partir de la page Vue d’ensemble, en particulier les paramètres de l’application et les fonctionnalités de la plateforme .You can navigate to everything you need to manage your function app from the overview page, in particular the Application settings and Platform features.

Paramètres de l’applicationApplication settings

L’onglet Paramètres de l’application conserve les paramètres qui sont utilisés par votre application de fonction.The Application Settings tab maintains settings that are used by your function app. Ces paramètres sont chiffrés et stockés, et vous devez sélectionner Afficher les valeurs pour afficher les valeurs dans le portail.These settings are stored encrypted, and you must select Show values to see the values in the portal. Vous pouvez également accéder aux paramètres d’application à l’aide d’Azure CLI.You can also access application settings by using the Azure CLI.

PortailPortal

Pour ajouter un paramètre dans le portail, sélectionnez Nouveau paramètre d’application et ajoutez la nouvelle paire clé-valeur.To add a setting in the portal, select New application setting and add the new key-value pair.

Paramètres de l’application de fonction sur le portail Azure.

D’Azure CLIAzure CLI

La commande az functionapp config appsettings list retourne les paramètres d’application existants, comme dans l’exemple suivant :The az functionapp config appsettings list command returns the existing application settings, as in the following example:

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

La commande az functionapp config appsettings set ajoute ou met à jour un paramètre d’application.The az functionapp config appsettings set command adds or updates an application setting. L’exemple suivant crée un paramètre avec une clé nommée CUSTOM_FUNCTION_APP_SETTING et la valeur 12345 :The following example creates a setting with a key named CUSTOM_FUNCTION_APP_SETTING and a value of 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Utiliser des paramètres d’applicationUse application settings

Ces valeurs de paramètres d’application de fonction peuvent aussi être lues dans votre code en tant que variables d’environnement.The function app settings values can also be read in your code as environment variables. Pour plus d’informations, consultez la section Variables d’environnement de ces rubriques de référence spécifiques à une langue :For more information, see the Environment variables section of these language-specific reference topics:

Quand vous développez une application de fonction localement, vous devez conserver des copies locales de ces valeurs dans le fichier de projet local.settings.json.When you develop a function app locally, you must maintain local copies of these values in the local.settings.json project file. Pour plus d’informations, consultez Fichier de paramètres locaux.To learn more, see Local settings file.

Fonctionnalités de la plate-formePlatform features

Onglet Fonctionnalités de la plate-forme de Function App.

Les Function Apps s’exécutent dans la plateforme Azure App Service et y sont entretenues.Function apps run in, and are maintained, by the Azure App Service platform. Par conséquent, vos Function Apps ont accès à la plupart des fonctionnalités de la plateforme d’hébergement web principale d’Azure.As such, your function apps have access to most of the features of Azure's core web hosting platform. Dans l’onglet Fonctionnalités de la plate-forme, vous pouvez vous accéder aux nombreuses fonctionnalités de la plateforme App Service que vous pouvez utiliser dans vos Function Apps.The Platform features tab is where you access the many features of the App Service platform that you can use in your function apps.

Notes

Toutes les fonctionnalités App Service ne sont pas disponibles quand une Function App s’exécute dans le cadre du plan d’hébergement Consommation.Not all App Service features are available when a function app runs on the Consumption hosting plan.

Le reste de ce article se concentre sur les fonctionnalités App Service du portail Azure qui sont utiles pour Functions :The rest of this article focuses on the following App Service features in the Azure portal that are useful for Functions:

Pour plus d’informations sur l’utilisation des paramètres App Service, consultez Configurer des applications web dans Azure App Service.For more information about how to work with App Service settings, see Configure Azure App Service Settings.

Éditeur App ServiceApp Service Editor

L’éditeur App Service

L’éditeur App Service est un éditeur avancé intégré au portail. Vous pouvez l’utiliser pour modifier les fichiers de configuration JSON et les fichiers de code.The App Service editor is an advanced in-portal editor that you can use to modify JSON configuration files and code files alike. L’activation de cette option entraîne l’ouverture d’un onglet distinct du navigateur avec un éditeur de base.Choosing this option launches a separate browser tab with a basic editor. Vous pouvez ainsi l’intégrer au référentiel GitHub, exécuter et déboguer du code et modifier les paramètres de Function App.This enables you to integrate with the Git repository, run and debug code, and modify function app settings. Cet éditeur fournit un environnement de développement amélioré pour vos fonctions en comparaison avec l’éditeur de fonction intégré.This editor provides an enhanced development environment for your functions compared with the built-in function editor.

Nous vous recommandons d’envisager de développer vos fonctions sur votre ordinateur local.We recommend that you consider developing your functions on your local computer. Quand vous développez localement et publiez sur Azure, vos fichiers projet sont en lecture seule dans le portail.When you develop locally and publish to Azure, your project files are read-only in the portal. Pour en savoir plus, consultez Coder et tester Azure Functions localement.To learn more, see Code and test Azure Functions locally.

ConsoleConsole

Console Function App

La console intégrée au portail est un outil de développement idéal lorsque vous souhaitez interagir avec Function App à partir de la ligne de commande.The in-portal console is an ideal developer tool when you prefer to interact with your function app from the command line. Les commandes courantes incluent la création de fichiers et de répertoires et la navigation, ainsi que l’exécution de scripts et de fichiers de commandes.Common commands include directory and file creation and navigation, as well as executing batch files and scripts.

Quand vous développez localement, nous vous recommandons d’utiliser Azure Functions Core Tools et Interface de ligne de commande Azure.When developing locally, we recommend using the Azure Functions Core Tools and the Azure CLI.

Outils avancés (Kudu)Advanced tools (Kudu)

Configurer Kudu

Les outils avancés pour App Service (également appelé Kudu) donnent accès aux fonctionnalités d’administration avancées de votre Function App.The advanced tools for App Service (also known as Kudu) provide access to advanced administrative features of your function app. Dans Kudu, vous pouvez gérer les informations système, les paramètres d’application, les variables d’environnement, les extensions de site, les en-têtes HTTP et les variables de serveur.From Kudu, you manage system information, app settings, environment variables, site extensions, HTTP headers, and server variables. Vous pouvez également lancer Kudu en naviguant vers le point de terminaison SCM pour votre Function App, comme https://<myfunctionapp>.scm.azurewebsites.net/.You can also launch Kudu by browsing to the SCM endpoint for your function app, like https://<myfunctionapp>.scm.azurewebsites.net/

Centre de déploiementDeployment Center

Quand vous utilisez une solution de contrôle de code source pour développer et gérer le code de vos fonctions, le centre de déploiement vous permet de générer et de déployer à partir du contrôle de code source.When you use a source control solution to develop and maintain your functions code, Deployment Center lets you build and deploy from source control. Votre projet est généré et déployé sur Azure quand vous effectuez des mises à jour.Your project is built and deployed to Azure when you make updates. Pour plus d’informations, consultez Technologies de déploiement dans Azure Functions.For more information, see Deployment technologies in Azure Functions.

Partage des ressources cross-originCross-origin resource sharing

Pour empêcher l’exécution de code malveillant sur le client, les navigateurs modernes bloquent les requêtes des applications web vers les ressources qui s’exécutent dans un domaine distinct.To prevent malicious code execution on the client, modern browsers block requests from web applications to resources running in a separate domain. Le partage des ressources cross-origin (CORS) permet à un en-tête Access-Control-Allow-Origin de déclarer les origines autorisées à appeler des points de terminaison sur votre application de fonction.Cross-origin resource sharing (CORS) lets an Access-Control-Allow-Origin header declare which origins are allowed to call endpoints on your function app.

PortailPortal

Quand vous configurez la liste Origines autorisées pour votre application de fonction, l’en-tête Access-Control-Allow-Origin est automatiquement ajouté à toutes les réponses des points de terminaison HTTP dans votre application de fonction.When you configure the Allowed origins list for your function app, the Access-Control-Allow-Origin header is automatically added to all responses from HTTP endpoints in your function app.

Configurer la liste CORS de l’application de fonction

Quand le caractère générique (*) est utilisé, tous les autres domaines sont ignorés.When the wildcard (*) is used, all other domains are ignored.

Utilisez la commande az functionapp cors add pour ajouter un domaine à la liste des origines autorisées.Use the az functionapp cors add command to add a domain to the allowed origins list. L’exemple suivant ajoute le domaine contoso.com :The following example adds the contoso.com domain:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Utilisez la commande az functionapp cors show pour lister les origines autorisées actuelles.Use the az functionapp cors show command to list the current allowed origins.

AuthentificationAuthentication

Configurer l’authentification pour une Function App

Lorsque les fonctions utilisent un déclencheur HTTP, vous pouvez exiger l’authentification préalable des appels.When functions use an HTTP trigger, you can require calls to first be authenticated. App Service prend en charge l’authentification Azure Active Directory et la connexion avec des fournisseurs sociaux tels que Facebook, Microsoft et Twitter.App Service supports Azure Active Directory authentication and sign-in with social providers, such as Facebook, Microsoft, and Twitter. Pour plus d’informations sur la configuration de fournisseurs d’authentification spécifiques, consultez Azure App Service authentication overview (Vue d’ensemble de l’authentification Azure App Service).For details on configuring specific authentication providers, see Azure App Service authentication overview.

Étapes suivantesNext steps