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

• 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.

• 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.

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.

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}
   

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.

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.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.

   

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)
   

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 :

   

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 :

   

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.

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}