Ajouter des messages au stockage de files d’attente Azure, à l’aide de Functions

Dans Azure Functions, les liaisons d’entrée et de sortie fournissent une méthode déclarative pour rendre disponibles les données des services externes pour votre code. Dans cet article, vous utilisez une liaison de sortie pour créer un message dans une file d’attente lorsqu’une requête HTTP déclenche une fonction. Vous utilisez le conteneur de stockage Azure pour afficher les messages de file d’attente créés par votre fonction.

Prérequis

• Un abonnement Azure. Si vous n’en avez pas, créez un compte gratuit avant de commencer.

• Suivez les instructions dans Créer votre première fonction à l’aide du Portail Azure, en omettant l’étape Nettoyer les ressources, pour créer l’application de fonction et la fonction à utiliser dans cet article.

Ajouter une liaison de sortie

Dans cette section, vous utilisez l’interface utilisateur du portail pour ajouter une instance Stockage File d’attente Azure à la fonction créée dans la configuration requise. Cette liaison permet d’écrire un minimum de code pour créer un message dans une file d’attente. Vous n’avez pas besoin d’écrire du code pour des tâches telles que l’ouverture d’une connexion de stockage, la création d’une file d’attente ou l’obtention d’une référence à une file d’attente. La liaison de sortie de file d’attente et le runtime Azure Functions se chargent de ces tâches.

1. Dans le Portail Azure, recherchez et sélectionnez l’application de fonction créée dans Créer votre première fonction à l’aide du Portail Azure.

2. Dans votre application de fonction, sélectionnez la fonction créée.

3. Sélectionnez Integration (Intégration), puis + Add output (+ Ajouter une sortie).

   

4. Sélectionnez le type de liaison Stockage File d’attente Azure, puis ajoutez les paramètres indiqués dans le tableau qui suit cette capture d’écran :

   

   Setting	Valeur suggérée	description
   Nom de message de paramètre	outputQueueItem	Le nom du paramètre de liaison de sortie.
   Nom de la file d’attente	outqueue	Le nom de la file d’attente à connecter dans votre compte de stockage.
   Connexion au compte de stockage	AzureWebJobsStorage	Vous pouvez utiliser la connexion de compte de stockage existante utilisée par votre application de fonction ou en créer une.

5. Sélectionnez OK pour ajouter la liaison.

Maintenant que vous avez défini une liaison de sortie, vous devez mettre à jour le code afin d’utiliser la liaison pour ajouter des messages à une file d’attente.

Ajouter le code qui utilise la liaison de sortie

Dans cette section, vous ajoutez le code qui écrit un message dans la file d’attente de sortie. Le message contient la valeur transmise au déclencheur HTTP dans la chaîne de requête. Par exemple, si la chaîne de requête inclut name=Azure, le message de la file d’attente est Nom transmis à la fonction : Azure.

1. Dans votre fonction, sélectionnez Code + Test (Coder et tester) pour afficher le code de fonction dans l’éditeur.

2. Mettez à jour le code de fonction en fonction du langage de votre fonction :

   C#

   Ajoutez un paramètre outputQueueItem à la signature de méthode, comme indiqué dans l’exemple suivant :

   public static async Task<IActionResult> Run(HttpRequest req,
       ICollector<string> outputQueueItem, ILogger log)
   {
       ...
   }
   

   Dans le corps de la fonction juste avant l’instruction return, ajoutez le code qui utilise le paramètre pour créer un message de file d’attente :

   outputQueueItem.Add("Name passed to the function: " + name);
   

   JavaScript

   Pour créer un message de file d’attente, ajoutez le code qui utilise la liaison de sortie sur l’objet context.bindings :

   context.bindings.outputQueueItem = "Name passed to the function: " + 
               (req.query.name || req.body.name);
   

3. Cliquez sur Enregistrer pour enregistrer vos modifications.

Tester la fonction

1. Après avoir enregistré les modifications de code, sélectionnez Test (Tester).

2. Confirmez que votre test correspond à cette capture d’écran, puis sélectionnez Exécuter.

   

   Notez que Corps de la demande contient la valeur nameAzure. Cette valeur s’affiche dans le message de file d’attente créé lorsque la fonction est appelée.

   Plutôt que de sélectionner Exécuter, vous pouvez appeler la fonction en entrant une URL dans un navigateur et en spécifiant la valeur name dans la chaîne de requête. Cette méthode de navigateur est illustrée dans Créer votre première fonction à l’aide du Portail Azure.

3. Vérifiez les journaux d’activité pour vous assurer que la fonction a réussi.

   Le runtime Functions crée une file d’attente nommée outqueue dans votre compte de stockage lors de la première utilisation de la liaison de sortie. Vous utilisez un compte de stockage pour vérifier que la file d’attente et un message dans celle-ci ont bien été créés.

Rechercher le compte de stockage connecté à AzureWebJobsStorage

1. Dans votre application de fonction, développez Paramètres, puis sélectionnez Variables d’environnement.

2. Sous l’onglet Paramètres d’application, sélectionnez AzureWebJobsStorage.

   

3. Localisez et notez le nom du compte.

   

Analyser la file d’attente de sortie

1. Dans le groupe de ressources de votre application de fonction, sélectionnez le compte de stockage que vous utilisez.

2. Sous service de File d’attente, sélectionnez Files d’attente, puis la file d’attente nommée outqueue.

   La file d’attente contient le message que la liaison de sortie de file d’attente a créé lors de l’exécution de la fonction déclenchée via HTTP. Si vous avez appelé la fonction avec la valeur name par défaut d'Azure, le message de la file d'attente est Nom transmis à la fonction : Azure.

3. Réexécutez l’application de fonction.

   Un nouveau message apparaît dans la file d’attente.

Nettoyer les ressources

Au cours des étapes précédentes, vous avez créé des ressources Azure au sein d’un groupe de ressources. Si vous ne pensez pas avoir besoin de ces ressources à l’avenir, vous pouvez les supprimer en supprimant le groupe de ressources.

Dans le menu ou la page d’accueil du portail Azure, sélectionnez Groupes de ressources. Ensuite, dans la page Groupes de ressources, sélectionnez myResourceGroup.

Dans la page myResourceGroup, assurez-vous que les ressources répertoriées sont bien celles que vous souhaitez supprimer.

Sélectionnez Supprimer le groupe de ressources, tapez myResourceGroup dans la zone de texte pour confirmer, puis sélectionnez Supprimer.

Contenu connexe

Dans cet article, vous avez ajouté une liaison de sortie à une fonction existante. Pour découvrir plus d’informations sur la liaison vers Stockage File d’attente, consultez la page Liaisons et déclencheur de Stockage File d’attente.

• Concepts des déclencheurs et liaisons Azure Functions
  Découvrez comment Functions s’intègre à d’autres services.
• Informations de référence pour les développeurs sur Azure Functions
  Fournit des informations techniques supplémentaires sur l’exécution de Functions, ainsi que des informations de référence pour le codage de fonctions, et pour la définition de déclencheurs et de liaisons.
• Coder et tester Azure Functions localement
  Décrit les options pour le développement local de vos fonctions.