Démarrage rapide : Déployer votre première application Spring Batch sur Azure Spring Apps

Remarque

Les 50 premières heures de processeur virtuel et 100 Go de mémoire sont gratuites chaque mois. Pour plus d’informations, consultez Price Reduction - Azure Spring Apps does more, costs less! sur le blog Apps on Azure.

Notes

Azure Spring Apps est le nouveau nom du service Azure Spring Cloud. Bien que le service ait un nouveau nom, vous verrez l’ancien nom à divers endroits pendant un certain temps, car nous travaillons à mettre à jour les ressources telles que les captures d’écran, les vidéos et les diagrammes.

Ce guide de démarrage rapide montre comment déployer une application éphémère Spring Batch sur Azure Spring Apps. L’exemple de projet est dérivé de l’exemple Spring Batch Football Job. Il s’agit d’un travail de chargement de statistiques. Dans l’exemple d’origine, un test unitaire déclenche le travail. Dans l’exemple adapté, la méthode main de FootballJobApplication lance le travail.

Cet article s’applique à :❌ De base/Standard ✔️ Entreprise

Le diagramme suivant présente l’architecture du système :

Cet article fournit les options suivantes pour le déploiement sur Azure Spring Apps :

• L’option Portail Azure est la méthode la plus simple et la plus rapide pour créer des ressources et déployer des applications en un seul clic. Cette option convient aux développeurs Spring qui souhaitent déployer rapidement des applications sur des services cloud Azure.
• L'option Azure CLI utilise un puissant outil de ligne de commande pour gérer les ressources Azure. Cette option convient aux développeurs Spring qui sont familiarisés avec les services cloud Azure.

1. Prérequis

Azure portal

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Si vous déployez une instance du plan Entreprise Azure Spring Apps pour la première fois dans l’abonnement cible, consultez la section Exigences du Plan Entreprise dans la Place de marché Azure.

Azure CLI

• Un abonnement Azure. Si vous n’avez pas d’abonnement, créez un compte gratuit avant de commencer.
• Git.
• Kit de développement Java (JDK), version 17.
• Azure CLI version 2.55.0 ou ultérieure. Installez l’extension Azure Spring Apps avec les commandes suivantes : az extension add --name spring.
• Si vous déployez une instance du plan Entreprise Azure Spring Apps pour la première fois dans l’abonnement cible, consultez la section Exigences du Plan Entreprise dans la Place de marché Azure.

2. Préparer le projet Spring

Utilisez la commande suivante pour cloner l’exemple de projet à partir de GitHub :

git clone https://github.com/Azure-Samples/azure-spring-apps-samples.git

3. Préparer l’environnement cloud

La principale ressource requise pour exécuter cet exemple est une instance Azure Spring Apps. Cette section décrit les étapes pour créer cette ressource.

Azure portal

3.1. Connectez-vous au portail Azure.

Accédez au Portail Microsoft Azure et entrez vos informations d’identification pour vous connecter au portail. Il s’ouvre par défaut sur le tableau de bord des services.

3.2. Créer une instance Azure Spring Apps

Utilisez les étapes suivante pour créer une instance de service Azure Spring Apps :

1. Sélectionnez Créer une ressource dans le coin du portail Azure.

2. Sélectionnez Calcul>Azure Spring Apps.

3. Remplissez le formulaire Informations de base avec les informations suivantes :

   Paramètre	Valeur suggérée	Description
   Abonnement	Nom de votre abonnement.	Abonnement Azure que vous souhaitez utiliser pour votre serveur. Si vous disposez de plusieurs abonnements, choisissez celui dans lequel vous souhaitez que la ressource soit facturée.
   Groupe de ressources	myresourcegroup	Un nouveau nom de groupe de ressources ou un nom de groupe existant dans votre abonnement.
   Nom	myasa	Nom unique qui identifie votre instance Azure Spring Apps. Le nom doit comporter entre 4 et 32 caractères, et contenir uniquement des lettres minuscules, des chiffres et des traits d’union. Le premier caractère du nom du service doit être une lettre, et le dernier doit être une lettre ou un chiffre.
   Planifier	Entreprise	Plan tarifaire qui détermine la ressource et le coût associés à votre instance.
   Région	La région la plus proche de vos utilisateurs.	L’emplacement géographique le plus proche de vos utilisateurs.
   Redondant interzone	Non sélectionné	Option permettant de créer votre service Azure Spring Apps dans une zone de disponibilité Azure. Cette fonctionnalité n’est actuellement pas prise en charge dans toutes les régions.
   Plan IP logiciel	Paiement à l’utilisation	Plan tarifaire qui vous permet de payer au fur et à mesure à l’aide d’Azure Spring Apps.
   Terms	Volumes sélectionnés	Case à cocher du contrat associée à l’offre de la Place de marché. Vous devez cocher cette case.
   Déployer l’exemple de projet	Non sélectionné	Option permettant d’utiliser l’exemple d’application intégré.

4. Sélectionnez Vérifier et créer pour passer en revue vos sélections. Ensuite, sélectionnez Créer pour approvisionner l’instance Azure Spring Apps.

5. Dans la barre d’outils, sélectionnez l’icône Notifications (en forme de cloche) pour surveiller le processus de déploiement. Une fois le déploiement terminé, vous pouvez sélectionner Épingler au tableau de bord, ce qui crée une vignette pour ce service dans votre tableau de bord du Portail Microsoft Azure, en tant que raccourci vers la page Vue d’ensemble du service.

   

6. Sélectionnez Accéder à la ressource pour accéder à la page Vue d’ensemble d’Azure Spring Apps.

3.3. Activer le registre de services

Accédez à l’instance Azure Spring Apps que vous avez créée, développez Composants managés dans le volet de navigation, puis sélectionnez Registre de services. Ensuite, dans la page Vue d’ensemble, sélectionnez Gérer pour ouvrir la page Gérer, sélectionnez Activer le registre de services, puis sélectionnez Appliquer.

3.4. Configurez un espace de travail Log Analytics

Pour plus d’informations sur l’interrogation des données dans les journaux, consultez Démarrage rapide : Configurer un espace de travail Log Analytics.

Azure CLI

3.1. Donner des noms à chaque ressource

Créez des variables destinées à contenir les noms de ressources à l’aide des commandes suivantes. Veillez à remplacer les espaces réservés par vos valeurs.

export LOCATION=<location>
export RESOURCE_GROUP=<resource-group-name>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>

3.2. Création d’un groupe de ressources

Procédez comme suit pour créer un groupe de ressources :

1. Utilisez la commande suivante pour vous connecter à Azure CLI :

   az login
   

2. Utilisez la commande suivante pour définir la localisation par défaut :

   az configure --defaults location=${LOCATION}
   

3. Utilisez la commande suivante pour répertorier tous les abonnements disponibles, puis déterminez l’ID d’abonnement à utiliser :

   az account list --output table
   

4. Utilisez la commande suivante pour définir votre abonnement par défaut :

   az account set --subscription <subscription-ID>
   

5. Utilisez la commande suivante pour créer un groupe de ressources :

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Utilisez la commande suivante pour définir le groupe de ressources nouvellement créé comme groupe de ressources par défaut :

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Créer une instance Azure Spring Apps

Azure Spring Apps est utilisé pour héberger l’application web Spring. Utilisez les étapes suivantes pour créer une instance Azure Spring Apps et une application à l’intérieur :

1. Utilisez la commande suivante pour créer une instance de service Azure Spring Apps et activer le registre de services :

   az spring create \
       --name ${AZURE_SPRING_APPS_INSTANCE} \
       --sku enterprise \
       --enable-sr
   

2. Utilisez la commande suivante pour vérifier que l’instance de service du plan Entreprise d’Azure Spring Apps a été correctement créée :

   az spring show --name ${AZURE_SPRING_APPS_INSTANCE}
   

4. Déployer l’application football-billboard sur Azure Spring Apps

Azure portal

Pour déployer l’application, effectuez les étapes suivantes :

1. Accédez à l’instance Azure Spring Apps que vous avez créée, développez Paramètres dans le volet de navigation, puis sélectionnez Applications.

2. Dans le volet Applications, sélectionnez Créer une application pour ouvrir la page Créer une application.

3. Définissez Nom de l’application sur football-billboard, sélectionnez Registre de services dans la colonne Lier, puis sélectionnez Créer.

   

4. Après avoir créé l’application, sélectionnez Déployer l’application et copiez la commande Azure CLI pour le déploiement de l’application. Ensuite, ouvrez une fenêtre Bash et collez la commande sur la ligne de commande, en remplaçant le chemin de l’artefact par la bonne valeur pour votre système. Exécutez ensuite la commande. Patientez plusieurs minutes jusqu’à ce que la génération et le déploiement réussissent. La sortie et la commande devraient ressembler à l’exemple suivant :

   $ az spring app deploy -s job-demo -g job-demo -n football-billboard --artifact-path target/spring-batch-football-billboard-0.0.1-SNAPSHOT.jar
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football-billboard'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

5. Après le déploiement, revenez au volet Applications et sélectionnez l’application football-billboard. Ensuite, accédez à la page de vue d’ensemble et sélectionnez Attribuer un point de terminaison afin d’exposer le point de terminaison public pour l’application.

Azure CLI

Pour déployer l’application, effectuez les étapes suivantes :

1. Utilisez la commande suivante pour accéder à l’exemple de dossier de projet à partir du dossier racine du référentiel :

   cd azure-spring-apps-samples/job-samples/football-billboard
   

2. Utilisez la commande suivante pour créer une application dans l’instance Azure Spring Apps et lier le registre de services :

   az spring app create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --assign-endpoint true \
       --bind-sr
   

3. Utilisez la commande suivante pour déployer l’application :

   az spring app deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

5. Déployer l’exemple de travail sur Azure Spring Apps

Cette section fournit les étapes de déploiement de l’exemple.

Azure portal

5.1. Créer et exécuter le travail

Suivez les étapes ci-dessous pour créer et exécuter le travail :

1. Accédez au volet Travaux, puis sélectionnez Créer un travail. Renseignez le nom du travail en mettant football. Configurez les paramètres de travail, tels que le parallélisme, la limite de nouvelle tentative et le délai d’expiration. Ajoutez des variables d’environnement et des variables d’environnement secrètes si nécessaire. Après confirmation, sélectionnez Créer.

   

2. Après avoir créé le travail, développez Composants managés dans le volet de navigation et sélectionnez Registre de services. Sélectionnez ensuite Liaison de travail, Lier le travail pour sélectionner le travail de football, puis Appliquer pour lier.

   

3. Revenez au volet Travaux après la liaison du travail, sélectionnez Déployer le travail, puis copiez la commande Azure CLI pour le déploiement du travail. Ensuite, ouvrez une fenêtre Bash et collez la commande sur la ligne de commande, en remplaçant le chemin de l’artefact par la bonne valeur pour votre système. Exécutez ensuite la commande. Patientez plusieurs minutes jusqu’à ce que la génération et le déploiement réussissent. La sortie et la commande devraient ressembler à l’exemple suivant :

   $ az spring job deploy -s job-demo -g job-demo -n football --artifact-path target/spring-batch-football-0.0.1-SNAPSHOT-jar-with-dependencies.jar --build-env BP_JVM_VERSION=17
   This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
   This command usually takes minutes to run. Add '--verbose' parameter if needed.
   [1/5] Requesting for upload URL.
   [2/5] Uploading package to blob.
   [3/5] Creating or Updating build 'football'.
   [4/5] Waiting for building container image to finish. This may take a few minutes.
   

4. Après le déploiement, ouvrez la page de vue d’ensemble du travail football en sélectionnant son nom. Sélectionnez Exécuter pour lancer l’exécution de la tâche. Vous pouvez personnaliser chaque exécution du travail avec des paramètres différents tels que des variables d’environnement, ou sélectionner simplement Exécuter pour déclencher l’exécution. Un message indique que le travail est en cours d’exécution.

   

Azure CLI

5.1. Créer et exécuter le travail

Suivez les étapes ci-dessous pour créer et exécuter le travail :

1. Utilisez la commande suivante pour accéder à l’exemple de dossier de projet à partir du dossier football-billboard où vous étiez précédemment :

   cd ..
   cd football
   

2. Utilisez la commande suivante pour créer un travail dans l’instance Azure Spring Apps et lier le registre de services :

   az spring job create \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --bind-sr
   

3. Utilisez la commande suivante pour déployer l’exemple de projet football sur le travail. Cette commande charge et compile le code source sur Azure afin qu’il soit prêt à démarrer.

   az spring job deploy \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --source-path . \
       --build-env BP_JVM_VERSION=17
   

4. Utilisez la commande suivante pour démarrer le travail et définir la variable EXECUTION_NAME sur le nom d’exécution du travail :

   export EXECUTION_NAME=$(az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --query name \
       --output tsv)
   

6. Vérifier le résultat de l’exécution du travail et l’interface utilisateur du panneau d’affichage

Vous pouvez maintenant accéder à l’exécution du travail et vérifier son résultat.

Azure portal

Utilisez les étapes suivantes pour valider :

1. Dans le volet Exécutions, vérifiez le résultat de l’exécution du travail. Attendez quelques secondes et actualisez pour voir l’état se changer en Terminé. Cette valeur signifie que l’exécution du travail se termine correctement.

2. Sélectionnez Afficher les journaux pour interroger les journaux de l’exécution du travail.

   

3. Ouvrez le point de terminaison public de l’application dans une fenêtre de navigateur pour voir l’interface utilisateur du panneau d’affichage. Laissez l’application ouverte.

   

4. Revenez à la page de vue d’ensemble du travail football et sélectionnez Exécuter pour redéclencher l’exécution.

5. Revenez à la page de point de terminaison dans le navigateur et sélectionnez Actualiser pour voir l’interface utilisateur modifiée, comme illustré dans la capture d’écran suivante :

   

Azure CLI

Utilisez les étapes suivantes pour valider :

1. Utilisez la commande suivante pour interroger le résultat de l’exécution à l’aide du nom du travail et de son nom d’exécution :

   az spring job logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football \
       --execution ${EXECUTION_NAME} \
       --all-instances
   

   Le journal des travaux qui streame l’exécution du travail devrait ressembler à l’exemple suivant :

   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - No TaskExecutor has been set, defaulting to synchronous executor.
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is {} player summary before job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] launched with the following parameters: [{}]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [playerLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [playerLoad] executed in 200ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [gameLoad]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [gameLoad] executed in 290ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.job.SimpleStepHandler - Executing step: [summarizationStep]
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.step.AbstractStep - Step: [summarizationStep] executed in 7ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.batch.core.launch.support.SimpleJobLauncher - Job: [SimpleJob: [name=footballJob]] completed with the following parameters: [{}] and the following status: [COMPLETED] in 519ms
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO com.microsoft.sample.FootballJobApplication - There is 1 player summary after job execution
   [football-xxxxxxxxxxxxx-xxxxxx-x-xxxxx] [main] INFO org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseFactory - Shutting down embedded database: url='jdbc:hsqldb:mem:testdb'
   ...
   

2. Utilisez la commande suivante pour récupérer le point de terminaison de l’application football-billboard :

   az spring app show \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football-billboard \
       --query properties.url
   

3. Ouvrez le point de terminaison public de l’application dans une fenêtre de navigateur pour voir l’interface utilisateur du panneau d’affichage. Laissez l’application ouverte.

   

4. Utilisez la commande suivante pour redémarrer le travail :

   az spring job start \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name football
   

5. Revenez à la page de point de terminaison dans le navigateur et sélectionnez Actualiser pour voir l’interface utilisateur modifiée, comme illustré dans la capture d’écran suivante :

   

7. Nettoyer les ressources

Assurez-vous de supprimer les ressources que vous avez créées dans cet article lorsque vous n’en aurez plus besoin. Vous pouvez supprimer le groupe de ressources Azure qui inclut toutes les ressources du groupe de ressources.

Azure portal

Procédez comme suit pour supprimer l’ensemble du groupe de ressources, y compris la nouvelle instance de service créée :

1. Localisez votre groupe de ressources dans le portail Azure. Dans le menu de navigation, sélectionnez Groupes de ressources, puis sélectionnez le nom de votre groupe de ressources.

2. Dans la page Groupe de ressources, sélectionnez Supprimer. Entrez le nom de votre groupe de ressources dans la zone de texte pour confirmer la suppression, puis sélectionnez Supprimer.

Azure CLI

Pour supprimer l’intégralité du groupe de ressources, y compris l’instance de service que vous venez de créer, utilisez la commande suivante :

az group delete --name ${RESOURCE_GROUP}

8. Étapes suivantes

Pour plus d’informations, consultez les articles suivants :

• Exemples Azure Spring Apps.
• Azure pour les développeurs Spring
• Documentation Spring Cloud Azure