Créer une fonction déclenchée par une file d’attente de stockage Azure
Découvrez comment créer une fonction qui est déclenchée lorsque des messages sont envoyés à une file d’attente de stockage Azure.
Remarque
La modification dans le portail n’est prise en charge que par les fonctions de Script de JavaScript, PowerShell et C#. La modification Python dans le portail est prise en charge uniquement lors de l’exécution dans le plan de Consommation. Pour créer une application C# Script qui prend en charge la modification dans le portail, vous devez choisir un runtimeVersion qui prend en charge le modèle in-process.
Quand cela est possible, vous devez développer vos fonctions localement.
Pour en savoir plus sur les limitations relatives à la modification du code de fonctions dans le portail Azure, consultez Limitations de développement dans le portail Azure.
Prérequis
- Un abonnement Azure. Si vous n’en avez pas, créez un compte gratuit avant de commencer.
Création d’une application Azure Function
Dans le menu du portail Azure ou dans la page Accueil, sélectionnez Créer une ressource.
Dans la page Nouveau, sélectionnez Calcul>Application de fonction.
Sous Sélectionner une option d’hébergement, sélectionnez Consommation>Sélectionner pour créer votre application dans le plan de Consommation par défaut. Avec cette option d’hébergement serverless, vous payez uniquement pour la durée d’exécution de vos fonctions. Le plan Premium offre également une mise à l'échelle dynamique. Si vous exécutez dans un plan App Service, vous devez gérer la mise à l’échelle de votre application de fonction.
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 L'abonnement sous lequel vous créez votre nouvelle application de fonction. Groupe de ressources myResourceGroup Nom du nouveau groupe de ressources dans lequel vous créez votre application de fonction. Vous devez créer un groupe de ressources du fait de limitations connues lors de la création d’applications de fonction dans un groupe de ressources existant. 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-.Pile d’exécution Langage préféré Choisissez un runtime qui prend en charge votre langage de programmation de fonction favori. L’édition dans le portail n’est disponible que pour les scripts JavaScript, PowerShell, Python, TypeScript et C#.
Pour créer une application C# Script qui prend en charge la modification dans le portail, vous devez choisir un runtimeVersion qui prend en charge le modèle in-process.
La bibliothèque de classes C# et les fonctions Java doivent être développées localement.Version Numéro de version Choisissez la version de votre runtime installé. 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. Système d’exploitation Windows Un système d'exploitation est présélectionné pour vous en fonction de votre sélection de pile d'exécution, mais vous pouvez modifier ce paramètre si nécessaire. La modification sur le portail est prise en charge sur Windows uniquement. 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.
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.
Cliquez sur l’icône Notifications en haut à droite du portail pour voir le message Le déploiement a été effectué.
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.
Créez ensuite une fonction dans la nouvelle Function App.
Créer une fonction déclenchée par une file d’attente
Dans votre application de fonction, sélectionnez Vue d’ensemble, puis + Créer sous Fonctions.
Sous Sélectionner un modèle, faites défiler vers le bas et choisissez le modèle Déclencheur Stockage File d’attente Azure.
Dans les détails du modèle, configurez le nouveau déclencheur avec les paramètres spécifiés dans ce tableau, puis sélectionnez Créer :
Paramètre Valeur suggérée Description Type de poste Ajouter à l’application Ce paramètre s’affiche uniquement pour une application Python v2. Nom Unique dans votre Function App Nom de cette fonction déclenchée par la file d’attente. Nom de la file d’attente éléments myqueue Le nom de la file d’attente à connecter à votre compte de stockage. Connexion au compte de stockage AzureWebJobsStorage Vous pouvez utiliser la connexion de compte de stockage qui est déjà utilisée par votre application de fonction, ou créez-en une. Azure crée la fonction déclenchée par Stockage File d’attente en fonction des valeurs fournies. Ensuite, connectez-vous à votre compte de stockage Azure et créez la file d’attente de stockage myqueue-items.
Créer la file d’attente
Revenez à la page Vue d’ensemble de votre application de fonction, sélectionnez votre Groupe de ressources, puis recherchez et sélectionnez le compte de stockage dans votre groupe de ressources.
Dans la page du compte de stockage, sélectionnez Stockage des données>Files d’attente>+ File d’attente.
Dans le champ Nom, tapez
myqueue-items, puis sélectionnez Créer.Sélectionnez la nouvelle file d’attente myqueue-items, que vous utiliserez pour tester la fonction en ajoutant un message à la file d’attente.
Tester la fonction
Dans une nouvelle fenêtre de navigateur, revenez à la page de votre application de fonction et sélectionnez Flux de journal, qui affiche la journalisation en temps réel pour votre application.
Dans la file d’attente myqueue-items, sélectionnez Ajouter un message, tapez « Hello World ! » dans le champ Texte du message, puis sélectionnez OK.
Revenez aux journaux de votre application de fonction et vérifiez que la fonction s’est exécutée pour traiter le message à partir de la file d’attente.
De retour dans votre file d’attente de stockage, sélectionnez Actualiser et vérifiez que le message a été traité et qu’il ne se trouve plus dans la file d’attente.
Nettoyer les ressources
Les autres démarrages rapides de cette collection reposent sur ce démarrage rapide. Si vous envisagez d’utiliser d’autres guides de démarrage rapide ou tutoriels, ou l’un des services que vous avez créés dans ce guide de démarrage rapide, ne supprimez pas les ressources.
Ressources dans Azure fait référence aux applications de fonction, fonctions, comptes de stockage, et ainsi de suite. Elles sont rassemblées en groupes de ressources, et vous pouvez supprimer tous les éléments d’un groupe en supprimant le groupe.
Vous avez créé des ressources pour effectuer ces démarrages rapides. Vous pouvez être facturé pour ces ressources en fonction de l’état de votre compte et de la tarification du service. Si vous n’avez plus besoin des ressources, voici comment les supprimer :
Dans le portail Azure, accédez à la page Groupe de ressources.
Pour accéder à cette page à partir de la page de l’application de fonction, sélectionnez l’onglet Vue d’ensemble, puis le lien situé sous Groupe de ressources.
Pour accéder à la page à partir du tableau de bord, sélectionnez Groupes de ressources, puis le groupe de ressources que vous avez utilisé pour cet article.
Dans la page Groupe de ressources, passez en revue la liste des ressources incluses et vérifiez qu’elles correspondent à celles que vous souhaitez supprimer.
Sélectionnez Supprimer le groupe de ressources et suivez les instructions.
La suppression peut prendre quelques minutes. Une fois terminée, une notification s’affiche pendant quelques secondes. Vous pouvez également sélectionner l’icône représentant une cloche en haut de la page pour afficher la notification.
Étapes suivantes
Vous avez créé une fonction qui s’exécute lorsqu’un message est ajouté à une file d’attente de stockage. Pour en savoir plus sur les déclencheurs de stockage en file d’attente, consultez la page Liaisons de file d’attente de stockage Azure Functions.
Maintenant que vous avez créé votre première fonction, nous allons ajouter une liaison de sortie à la fonction qui écrit un message dans une autre file d’attente.