Créer votre première fonction Java dans Azure à l’aide d’IntelliJ
Cet article explique comment utiliser Java et IntelliJ pour créer une fonction Azure.
Plus précisément, cet article vous montre :
- Comment créer une fonction Java déclenchée par HTTP dans un projet IntelliJ IDEA
- Les étapes pour tester et déboguer le projet dans l’environnement de développement intégré (IDE) sur votre ordinateur
- Les instructions pour déployer le projet de fonction sur Azure Functions
Prérequis
- Compte Azure avec un abonnement actif. Créez un compte gratuitement.
- Un kit de développement Java (JDK) pris en charge par Azure, version 8, 11, 17 ou 21. (Java 21 est actuellement pris en charge en préversion sur Linux uniquement)
- IntelliJ IDEA Ultimate Edition ou Community Edition
- Maven 3.5.0 (ou version supérieure)
- La dernière version de Functions Core Tools
Installer le plug-in et se connecter
Pour installer Azure Toolkit for IntelliJ puis vous connecter, procédez comme suit :
Dans la boîte de dialogue Paramètres/Préférences d’IntelliJ IDEA (Ctrl+Alt+S), sélectionnez Plug-ins. Recherchez ensuite Azure Toolkit for IntelliJ dans la Place de marché, puis sélectionnez Installer. Une fois l’installation effectuée, sélectionnez Redémarrer pour activer le plug-in.
Pour vous connecter à votre compte Azure, ouvrez la barre latérale Azure Explorer, puis sélectionnez l’icône Connexion à Azure dans la barre du haut (ou dans le menu IDEA, sélectionnez Outils > Azure > Connexion à Azure).
Dans la fenêtre Connexion à Azure, sélectionnez OAuth 2.0, puis sélectionnez Se connecter. Pour d’autres options de connexion, consultez Instructions de connexion pour Azure Toolkit for IntelliJ.
Dans le navigateur, connectez-vous avec votre compte, puis revenez à IntelliJ. Dans la boîte de dialogue Sélectionner des abonnements, sélectionnez les abonnements à utiliser, puis choisissez Sélectionner.
Créer votre projet local
Pour utiliser Azure Toolkit for IntelliJ afin de créer un projet Azure Functions local, procédez comme suit :
Ouvrez la boîte de dialogue Bienvenue d’Open IntelliJ IDEA, sélectionnez Nouveau projet pour ouvrir l’Assistant de création de projet, puis sélectionnez Azure Functions.
Sélectionnez Déclencheur HTTP, sélectionnez Suivant, puis suivez l’Assistant pour passer en revue toutes les configurations dans les pages suivantes. Vérifiez l’emplacement de votre projet, puis sélectionnez Terminer. IntelliJ IDEA ouvre ensuite votre nouveau projet.
Exécutez le projet localement.
Pour exécuter le projet localement, procédez comme suit :
Important
La variable d’environnement JAVA_HOME doit être définie correctement dans le répertoire JDK utilisé lors de la compilation du code à l’aide de Maven. La version du JDK doit être au moins aussi élevée que le paramètre Java.version.
Accédez à src/main/java/org/example/functions/HttpTriggerJava.java pour voir le code généré. À côté de la ligne 17, vous devez voir un bouton vert Exécuter. Sélectionnez-le, puis choisissez Exécuter « Functions-azur... ». Vous devez voir votre application de fonction s’exécuter localement avec quelques journaux.
Vous pouvez essayer la fonction en accédant au point de terminaison affiché à partir du navigateur, comme
http://localhost:7071/api/HttpTriggerJava?name=Azure.
Le journal s’affiche également dans votre IDEA. Arrêtez l’application de fonction en sélectionnant Arrêter.
Déboguer le projet localement
Pour déboguer le projet localement, procédez comme suit :
Sélectionnez le bouton Déboguer de la barre d’outils. Si vous ne voyez pas la barre d’outils, activez-la en choisissant View>Appearance>Toolbar (Afficher > Apparence > Barre d’outils).
Sélectionnez la ligne 20 du fichier src/main/java/org/example/functions/HttpTriggerJava.java pour ajouter un point d’arrêt. Accédez à nouveau au point de terminaison
http://localhost:7071/api/HttpTriggerJava?name=Azure. Vous constaterez que le point d’arrêt a été atteint. Vous pouvez ensuite essayer d’autres fonctionnalités de débogage telles que Step, Watch et Evaluation. Arrêtez la session de débogage en sélectionnant Arrêter.
Créer l’application de fonction dans Azure
Pour créer une application de fonction et les ressources associées dans votre abonnement Azure, suivez les étapes ci-après :
Dans l’Explorateur Azure, au sein de votre IDEA, cliquez avec le bouton droit sur Application de fonction, puis sélectionnez Créer.
Sélectionnez Plus de paramètres, puis indiquez les informations suivantes aux invites :
Prompt Sélection Abonnement choisissez l’abonnement à utiliser. Groupe de ressources Choisissez le groupe de ressources de votre application de fonction. Nom Spécifiez le nom d’une nouvelle application de fonction. Ici, nous pouvons simplement accepter la valeur par défaut. Plateforme Sélectionnez Windows-Java 17 ou une autre plateforme, selon le cas. Région Pour de meilleures performances, choisissez une région proche de vous. Options d’hébergement Choisissez les options d’hébergement de votre application de fonction. Planifier Choisissez le niveau tarifaire du plan App Service à utiliser, ou sélectionnez + pour créer un plan App Service. Important
Pour créer votre application dans le plan de consommation flexible, sélectionnez Consommation flexible. Le plan Consommation flexible est actuellement en préversion.
Cliquez sur OK. Une notification s’affiche une fois votre application de fonction créée.
Déployer votre projet sur Azure
Pour déployer votre projet sur Azure, procédez comme suit :
Sélectionnez et développez l’icône Azure dans l’Explorateur de projets IntelliJ, puis sélectionnez Déployer sur Azure -> Déployer sur Azure Functions.
Vous pouvez sélectionner l’application de fonction de la section précédente. Pour en créer une autre, sélectionnez + sur la ligne Fonction. Tapez le nom de l’application de fonction, puis choisissez la plateforme appropriée. Ici, vous pouvez accepter la valeur par défaut. Sélectionnez OK. La nouvelle application de fonction que vous avez créée est automatiquement sélectionnée. Sélectionnez Exécuter pour déployer vos fonctions.
Gérer les applications de fonction à partir d’IDEA
Pour gérer vos applications de fonction avec Azure Explorer dans votre IDEA, procédez comme suit :
Sélectionnez Application de fonction pour voir la liste de toutes vos applications de fonction.
Sélectionnez l’une de vos applications de fonction, puis cliquez avec le bouton droit, et sélectionnez Afficher les propriétés pour ouvrir la page de détails.
Cliquez avec le bouton droit sur votre application de fonction HttpTrigger-Java, puis sélectionnez Déclencher la fonction dans le navigateur. Vous verrez que le navigateur est ouvert avec l’URL du déclencheur.
Ajouter des fonctions au projet
Pour ajouter plus de fonctions à votre projet, procédez comme suit :
Cliquez avec le bouton droit sur le package org.example.functions, puis sélectionnez Nouveau -> Classe de fonction Azure.
Renseignez le nom de la classe HttpTest, sélectionnez HttpTrigger dans l’Assistant Création de classe de fonction, puis sélectionnez OK pour effectuer la création. Vous pouvez ainsi créer des fonctions comme vous le souhaitez.
Nettoyage des fonctions
Sélectionnez l’une de vos applications de fonction à l’aide d’Azure Explorer dans votre IDEA, puis cliquez avec le bouton droit et sélectionnez Supprimer. L’exécution de cette commande peut prendre plusieurs minutes. Une fois l’opération effectuée, l’état est actualisé dans l’Azure Explorer.
Étapes suivantes
Vous avez créé un projet Java avec une fonction déclenchée par HTTP, l’avez exécuté sur votre ordinateur local et l’avez déployée sur Azure. À présent, étendez votre fonction en continuant à l’article suivant :