Démarrage rapide : Créer une fonction dans Azure avec Python avec Visual Studio CodeQuickstart: Create a function in Azure with Python using Visual Studio Code

Dans cet article, vous allez utiliser Visual Studio Code pour créer une fonction Python qui répond aux requêtes HTTP.In this article, you use Visual Studio Code to create a Python function that responds to HTTP requests. Après avoir testé le code localement, vous le déployez dans l’environnement serverless d’Azure Functions.After testing the code locally, you deploy it to the serverless environment of Azure Functions.

Le fait de suivre ce guide de démarrage rapide entraîne une petite dépense de quelques cents USD tout au plus dans votre compte Azure.Completing this quickstart incurs a small cost of a few USD cents or less in your Azure account.

Il existe également une version basée sur l’interface CLI de cet article.There's also a CLI-based version of this article.

Configurer votre environnementConfigure your environment

Avant de commencer, veillez à disposer des éléments suivants :Before you get started, make sure you have the following requirements in place:

Créer votre projet localCreate your local project

Dans cette section, vous utilisez Visual Studio Code pour créer un projet Azure Functions local en Python.In this section, you use Visual Studio Code to create a local Azure Functions project in Python. Plus loin dans cet article, vous allez publier votre code de fonction sur Azure.Later in this article, you'll publish your function code to Azure.

  1. Choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, sélectionnez l’icône Créer un projet.Choose the Azure icon in the Activity bar, then in the Azure: Functions area, select the Create new project... icon.

    Choisir Créer un projet

  2. Choisissez un emplacement de répertoire pour votre espace de travail de projet et optez pour Sélectionner.Choose a directory location for your project workspace and choose Select.

    Notes

    Ces étapes ont été conçues pour être terminées en dehors d’un espace de travail.These steps were designed to be completed outside of a workspace. Dans ce cas, ne sélectionnez pas de dossier de projet qui fait partie d’un espace de travail.In this case, do not select a project folder that is part of a workspace.

  3. Quand vous y êtes invité, indiquez les informations suivantes :Provide the following information at the prompts:

    • Sélectionner un langage pour votre projet de fonction : Choisissez Python.Select a language for your function project: Choose Python.

    • Sélectionner un alias Python pour créer un environnement virtuel : Choisissez l’emplacement de votre interpréteur Python.Select a Python alias to create a virtual environment: Choose the location of your Python interpreter.
      Si l’emplacement n’est pas affiché, tapez le chemin complet de votre fichier binaire Python.If the location isn't shown, type in the full path to your Python binary.

    • Sélectionner un modèle pour la première fonction de votre projet : Choisissez HTTP trigger.Select a template for your project's first function: Choose HTTP trigger.

    • Fournir un nom de fonction : Tapez HttpExample.Provide a function name: Type HttpExample.

    • Niveau d’autorisation : Choisissez l’option Anonymous, qui permet à quiconque d’appeler le point de terminaison de votre fonction.Authorization level: Choose Anonymous, which enables anyone to call your function endpoint. Pour en savoir plus sur le niveau d’autorisation, consultez Clés d’autorisation.To learn about authorization level, see Authorization keys.

    • Sélectionner la façon dont vous souhaitez ouvrir votre projet : Choisissez Add to workspace.Select how you would like to open your project: Choose Add to workspace.

  4. À l’aide de ces informations, Visual Studio Code génère un projet Azure Functions avec un déclencheur HTTP.Using this information, Visual Studio Code generates an Azure Functions project with an HTTP trigger. Vous pouvez voir les fichiers de projet locaux dans l’Explorateur.You can view the local project files in the Explorer. Pour en savoir plus sur les fichiers créés, consultez Fichiers projet générés.To learn more about files that are created, see Generated project files.

Exécuter la fonction localementRun the function locally

Visual Studio Code s’intègre à Azure Functions Core Tools pour vous permettre d’exécuter ce projet sur votre ordinateur de développement local avant toute publication sur Azure.Visual Studio Code integrates with Azure Functions Core tools to let you run this project on your local development computer before you publish to Azure.

  1. Pour appeler votre fonction, appuyez sur F5 pour démarrer le projet d’application de fonction.To call your function, press F5 to start the function app project. La sortie de Core Tools est affichée dans le panneau Terminal.Output from Core Tools is displayed in the Terminal panel. Votre application démarre dans le panneau Terminal.Your app starts in the Terminal panel. Vous pouvez voir le point de terminaison de l’URL de votre fonction déclenchée par HTTP en cours d’exécution localement.You can see the URL endpoint of your HTTP-triggered function running locally.

    Sortie VS Code de la fonction locale

    Si vous rencontrez des problèmes d’exécution sur Windows, assurez-vous que le terminal par défaut pour Visual Studio Code n’est pas défini sur WSL Bash.If you have trouble running on Windows, make sure that the default terminal for Visual Studio Code isn't set to WSL Bash.

  2. Une fois Core Tools en cours d’exécution, accédez à la zone Azure : Functions.With Core Tools running, go to the Azure: Functions area. Sous Fonctions, développez Projet local > Fonctions.Under Functions, expand Local Project > Functions. Cliquez avec le bouton droit (Windows) ou effectuez Ctrl-clic (macOS) sur la fonction HttpExample, puis choisissez Exécuter la fonction maintenant.Right-click (Windows) or Ctrl - click (macOS) the HttpExample function and choose Execute Function Now....

    Exécuter la fonction maintenant dans Visual Studio Code

  3. Dans Entrer le corps de la requête, vous pouvez voir la valeur du corps du message de requête pour { "name": "Azure" }.In Enter request body you see the request message body value of { "name": "Azure" }. Appuyez sur Entrée pour envoyer ce message de demande à votre fonction.Press Enter to send this request message to your function.

    Vous pourriez à la place envoyer une requête HTTP GET à l’adresse http://localhost:7071/api/HttpExample dans un navigateur web.You could have instead sent an HTTP GET request to the http://localhost:7071/api/HttpExample address in a web browser.

  4. Quand la fonction s’exécute localement et retourne une réponse, une notification est générée dans Visual Studio Code.When the function executes locally and returns a response, a notification is raised in Visual Studio Code. Les informations relatives à l’exécution de la fonction sont affichées dans le panneau Terminal.Information about the function execution is shown in Terminal panel.

  5. Appuyez sur Ctrl+C pour arrêter Core Tools et déconnecter le débogueur.Press Ctrl + C to stop Core Tools and disconnect the debugger.

Après avoir vérifié que la fonction s’exécute correctement sur votre ordinateur local, il est temps d’utiliser Visual Studio Code pour publier le projet directement sur Azure.After you've verified that the function runs correctly on your local computer, it's time to use Visual Studio Code to publish the project directly to Azure.

Connexion à AzureSign in to Azure

Avant de pouvoir publier votre application, vous devez vous connecter à Azure.Before you can publish your app, you must sign in to Azure.

  1. Si vous n’êtes pas déjà connecté, choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, choisissez Se connecter à Azure... . Si vous ne l’avez pas encore fait, vous pouvez créer un compte Azure gratuit .If you aren't already signed in, choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose Sign in to Azure.... If you don't already have one, you can Create a free Azure account. Les étudiants peuvent créer un compte gratuit Azure pour Étudiant .Students can create a free Azure account for Students.

    Se connecter à Azure dans VS Code

    Si vous êtes déjà connecté, passez à la section suivante.If you're already signed in, go to the next section.

  2. Quand vous y êtes invité dans le navigateur, choisissez votre compte Azure, puis connectez-vous à l’aide de vos informations d’identification de compte Azure.When prompted in the browser, choose your Azure account and sign in using your Azure account credentials.

  3. Une fois la connexion réussie, vous pouvez fermer la nouvelle fenêtre de navigateur.After you've successfully signed in, you can close the new browser window. Les abonnements qui font partie de votre compte Azure sont affichés dans la barre latérale.The subscriptions that belong to your Azure account are displayed in the Side bar.

Publication du projet sur AzurePublish the project to Azure

Dans cette section, vous créez une application de fonction et les ressources associées dans votre abonnement Azure, puis vous déployez votre code.In this section, you create a function app and related resources in your Azure subscription and then deploy your code.

Important

La publication sur une application de fonction existante remplace le contenu de cette application dans Azure.Publishing to an existing function app overwrites the content of that app in Azure.

  1. Choisissez l’icône Azure dans la barre d’activité, puis dans la zone Azure : Fonctions, choisissez le bouton Déployer sur une application de fonction.Choose the Azure icon in the Activity bar, then in the Azure: Functions area, choose the Deploy to function app... button.

    Publier votre projet sur Azure

  2. Quand vous y êtes invité, indiquez les informations suivantes :Provide the following information at the prompts:

    • Sélectionnez le dossier : choisissez un dossier dans votre espace de travail ou accédez à un dossier qui contient votre application de fonction.Select folder: Choose a folder from your workspace or browse to one that contains your function app.
      Vous ne verrez pas ceci si vous avez déjà ouvert une application de fonction valide.You won't see this if you already have a valid function app opened.

    • Sélectionnez l’abonnement : choisissez l’abonnement à utiliser.Select subscription: Choose the subscription to use.
      Vous ne verrez pas ceci si vous n’avez qu’un seul abonnement.You won't see this if you only have one subscription.

    • Sélectionnez une application de fonction dans Azure : Choisissez + Create new Function App.Select Function App in Azure: Choose + Create new Function App.
      (Ne choisissez pas l’option Advanced, qui n’est pas abordée dans cet article.)(Don't choose the Advanced option, which isn't covered in this article.)

    • Entrer un nom global unique pour l’application de fonction : Tapez un nom valide dans un chemin d’URL.Enter a globally unique name for the function app: Type a name that is valid in a URL path. Le système vérifie que le nom que vous tapez est unique dans Azure Functions.The name you type is validated to make sure that it's unique in Azure Functions.

    • Sélectionnez un runtime : Choisissez la version de Python que vous avez exécutée localement.Select a runtime: Choose the version of Python you've been running on locally. Vous pouvez utiliser la commande python --version pour vérifier votre version.You can use the python --version command to check your version.

    • Sélectionnez un emplacement pour les nouvelles ressources : Pour de meilleures performances, choisissez une région proche de vous.Select a location for new resources: For better performance, choose a region near you.

    L’extension montre l’état des ressources individuelles au fur et à mesure de leur création dans Azure, au sein de la zone de notification.The extension shows the status of individual resources as they are being created in Azure in the notification area.

    Notification de création de ressources Azure

  3. Quand vous avez terminé, les ressources Azure suivantes sont créées dans votre abonnement et leurs noms reposent sur le nom de votre application de fonction :When completed, the following Azure resources are created in your subscription, using names based on your function app name:

    • Un groupe de ressources, qui est un conteneur logique pour les ressources associées.A resource group, which is a logical container for related resources.
    • Un compte Stockage Azure standard, qui conserve l’état et d’autres informations spécifiques à vos projets.A standard Azure Storage account, which maintains state and other information about your projects.
    • Un plan de consommation, qui définit l’hôte sous-jacent pour votre application de fonction serverless.A consumption plan, which defines the underlying host for your serverless function app.
    • Une application de fonction, qui fournit l’environnement d’exécution de votre code de fonction.A function app, which provides the environment for executing your function code. Une application de fonction vous permet de regrouper des fonctions en une unité logique pour faciliter la gestion, le déploiement et le partage des ressources au sein du même plan d’hébergement.A function app lets you group functions as a logical unit for easier management, deployment, and sharing of resources within the same hosting plan.
    • Une instance Application Insights connectée à l’application de fonction, qui effectue le suivi de l’utilisation de votre fonction serverless.An Application Insights instance connected to the function app, which tracks usage of your serverless function.

    Une notification s’affiche après que votre application de fonction a été créée et que le package de déploiement a été appliqué.A notification is displayed after your function app is created and the deployment package is applied.

    Conseil

    Par défaut, les ressources Azure nécessaires à votre application de fonction sont créées d’après le nom d’application de fonction que vous indiquez.By default, the Azure resources required by your function app are created based on the function app name you provide. Par défaut, elles sont également créées dans le même nouveau groupe de ressources avec l’application de fonction.By default, they are also created in the same new resource group with the function app. Si vous souhaitez personnaliser les noms de ces ressources ou réutiliser des ressources existantes, vous devez plutôt publier le projet à l’aide des options de création avancées.If you want to either customize the names of these resources or reuse existing resources, you need to instead publish the project with advanced create options.

  4. 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.Select View Output in this notification to view the creation and deployment results, including the Azure resources that you created. Si vous manquez la notification, sélectionnez l’icône de cloche dans le coin inférieur droit pour la voir de nouveau.If you miss the notification, select the bell icon in the lower right corner to see it again.

    Créer une notification de fin

Exécuter la fonction dans AzureRun the function in Azure

  1. Dans la zone Azure : Fonctions de la barre latérale, développez votre abonnement, votre nouvelle application de fonction et Fonctions.Back in the Azure: Functions area in the side bar, expand your subscription, your new function app, and Functions. Cliquez avec le bouton droit (Windows) ou faites Ctrl - clic (macOS) sur la fonction HttpExample, puis choisissez Exécuter la fonction maintenant... .Right-click (Windows) or Ctrl - click (macOS) the HttpExample function and choose Execute Function Now....

    Exécuter la fonction maintenant dans Azure à partir de Visual Studio Code

  2. Dans Entrer le corps de la demande figure la valeur { "name": "Azure" } pour le corps du message de la demande.In Enter request body you see the request message body value of { "name": "Azure" }. Appuyez sur Entrée pour envoyer ce message de demande à votre fonction.Press Enter to send this request message to your function.

  3. Quand la fonction s’exécute dans Azure et retourne une réponse, une notification est générée dans Visual Studio Code.When the function executes in Azure and returns a response, a notification is raised in Visual Studio Code.

Nettoyer les ressourcesClean up resources

Quand vous passerez à l’étape suivante et ajouterez une liaison de file d’attente Stockage Azure à votre fonction, vous devrez conserver toutes vos ressources en place, car vous allez tirer parti de ce que vous avez déjà fait.When you continue to the next step and add an Azure Storage queue binding to your function, you'll need to keep all your resources in place to build on what you've already done.

Sinon, vous pouvez utiliser les étapes suivantes pour supprimer l’application de fonction et ses ressources connexes afin d’éviter des coûts supplémentaires.Otherwise, you can use the following steps to delete the function app and its related resources to avoid incurring any further costs.

  1. Dans Visual Studio Code, appuyez sur F1 pour ouvrir la palette de commandes.In Visual Studio Code, press F1 to open the command palette. Dans la palette de commandes, recherchez et sélectionnez Azure Functions: Open in portal.In the command palette, search for and select Azure Functions: Open in portal.

  2. Choisissez votre application de fonction et appuyez sur Entrée.Choose your function app, and press Enter. La page de l’application de fonction s’ouvre dans le portail Azure.The function app page opens in the Azure portal.

  3. Sous l’onglet Vue d’ensemble, sélectionnez le lien nommé à côté de Groupe de ressources.In the Overview tab, select the named link next to Resource group.

    Sélectionnez le groupe de ressources à supprimer dans la page d’application de fonction.

  4. Sur la page Groupe de ressources, passez en revue la liste des ressources incluses et vérifiez qu’elles correspondent à celles que vous souhaitez supprimer.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  5. Sélectionnez Supprimer le groupe de ressources et suivez les instructions.Select Delete resource group, and follow the instructions.

    Cette opération peut prendre quelques minutes.Deletion may take a couple of minutes. Une fois terminée, une notification s’affiche pendant quelques secondes.When it's done, a notification appears for a few seconds. Vous pouvez également sélectionner l’icône représentant une cloche en haut de la page pour afficher la notification.You can also select the bell icon at the top of the page to view the notification.

Pour en savoir plus sur les coûts de Functions, consultez Estimation des coûts d’un plan Consommation.To learn more about Functions costs, see Estimating Consumption plan costs.

Étapes suivantesNext steps

Vous avez utilisé Visual Studio Code pour créer une application de fonction à l’aide d’une simple fonction déclenchée par HTTP.You have used Visual Studio Code to create a function app with a simple HTTP-triggered function. Dans le prochain article, vous allez développer cette fonction en vous connectant au service Stockage Azure.In the next article, you expand that function by connecting to Azure Storage. Pour en savoir plus sur la connexion à d’autres services Azure, consultez Ajouter des liaisons à une fonction existante dans Azure Functions.To learn more about connecting to other Azure services, see Add bindings to an existing function in Azure Functions.

Vous rencontrez des problèmes ? Faites-le nous savoir.Having issues? Let us know.