Gérer et utiliser des travaux dans le plan Azure Spring Apps Entreprise

Remarque

Les plans Essentiel, Standard et Entreprise seront déconseillés à compter de la mi-mars 2025, avec une période de mise hors service de 3 ans. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez l’annonce de mise hors service d’Azure Spring Apps.

Le plan de consommation standard et dédiée sera déconseillé à compter du 30 septembre 2024, avec un arrêt complet après six mois. Nous vous recommandons de passer à Azure Container Apps. Pour plus d’informations, consultez Migrer le plan de consommation standard et dédiée Azure Spring Apps vers Azure Container Apps.

Cet article s’applique à : ❎ Essentiel/Standard ✅ Entreprise

Cet article explique comment gérer le cycle de vie d’un travail et l’exécuter dans le plan Azure Spring Apps Entreprise.

Prérequis

• Une instance de plan Azure Spring Apps Entreprise déjà approvisionnée. Pour plus d’informations, consultez Démarrage rapide : Générer et déployer des applications sur Azure Spring Apps à l’aide du plan Enterprise.

Créer et déployer un travail

Azure CLI

Utilisez les commandes suivantes pour créer et déployer un travail :

az spring job create --name <job-name>
az spring job deploy \
    --name <job-name> \
    --artifact-path <artifact-path>

Azure portal

Suivez les étapes ci-dessous pour créer et déployer un travail :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, sélectionnez Paramètres, puis Travaux.

3. Dans la page Travaux, sélectionnez Créer un travail.

4. Ajoutez un nom pour le travail et sélectionnez d’autres configurations. Sélectionnez Créer et patientez jusqu’à ce que le travail ait été créé avec succès.

5. Sélectionnez Déployer le travail. Un panneau s’ouvre.

6. Pour déployer le travail, copiez les commandes Azure CLI dans le panneau, puis exécutez les commandes sur la ligne de commande.

Pour la préversion publique, vous pouvez créer un maximum de 10 travaux par instance de service.

Démarrer et annuler une exécution de travail

Azure CLI

Utilisez la commande suivante pour démarrer une exécution de travail :

az spring job start --name <job-name>

Si la commande s’exécute correctement, elle retourne le nom de l’exécution du travail. Avec le paramètre --wait-until-finished true, la commande ne retourne pas tant que l’exécution du travail n’est pas terminée.

Pour interroger l’état de l’exécution du travail, utilisez la commande suivante. Remplacez <execution-name> par le nom retourné par la commande start.

az spring job execution show \
    --job <job-name> \
    --name <execution-name>

Pour annuler les exécutions de travaux en cours d’exécution, utilisez la commande suivante :

az spring job execution cancel \
    --job <job-name> \
    --name <execution-name>

Azure portal

Effectuez les étapes suivantes pour démarrer ou annuler une exécution de travail :

1. Dans la page Travaux, sélectionnez le nom du travail pour ouvrir la page de vue d’ensemble du travail.

2. Sélectionnez Exécuter pour ouvrir le panneau de paramètres de l’exécution du travail.

3. Ajoutez des arguments et des variables d’environnement spécifiques si nécessaire pour cette exécution. Sélectionnez Exécuter pour démarrer l’exécution.

4. Pour réexécuter le travail, sélectionnez Réexécuter le travail afin de déclencher une nouvelle exécution de travail avec la même configuration.

5. Pour annuler l’exécution du travail en cours d’exécution, sélectionnez Annuler le travail.

Interroger l’historique d'exécution des travaux

Azure CLI

Pour afficher l’historique d’exécution, utilisez la commande suivante :

az spring job execution list --job <job-name>

Azure portal

1. Accédez à la section Exécutions de la page de vue d’ensemble Travaux.

2. Recherchez la dernière exécution du travail et sélectionnez Afficher les détails d’exécution pour afficher la configuration au niveau du travail et au niveau de l’exécution.

Pour la préversion publique, les dix derniers enregistrements d’exécution de travail terminés ou ayant échoué par travail sont conservés dans l’historique.

Journaux d’exécution des travaux de requête

Pour obtenir l’historique des exécutions de travaux dans le portail Azure, utilisez la requête Log Analytics suivante :

AppPlatformLogsforSpring
| where AppName == '<job-name>' and InstanceName startswith '<execution-name>'
| order by TimeGenerated asc

Pour plus d’informations, consultez Démarrage rapide : Configurer un espace de travail Log Analytics.

Pour les journaux en temps réel, utilisez la commande suivante sur la ligne de commande :

az spring job logs \
    --name <job-name> \
    --execution <execution-name>

S’il existe plusieurs instances pour l’exécution du travail, spécifiez --instance <instance-name> pour afficher les journaux d’une seule instance.

Réexécuter l’exécution d’un travail

Azure CLI

Utilisez la commande suivante pour déclencher une nouvelle exécution de travail :

az spring job start \
    --name <job-name> \
    --args <argument-value> \
    --envs <key=value>

Azure portal

Effectuez les étapes suivantes pour réexécuter une exécution de travail :

1. Ouvrez la section Exécutions de la page de vue d’ensemble Travaux.

2. Sélectionnez Réexécuter pour déclencher une nouvelle exécution de travail avec la même configuration que la précédente.

Une nouvelle exécution de travail s’affiche dans la section Exécutions.

Intégrer à des composants managés

Pour la préversion publique, les travaux peuvent s’intégrer en toute transparence à Spring Cloud Config Server pour une gestion efficace de la configuration et à Tanzu Service Registry pour la découverte de service.

Intégrer à Spring Cloud Config Server

Avec Spring Cloud Config Server, vous pouvez gérer les configurations ou les propriétés requises par un travail dans des dépôts Git, puis les charger dans le travail. Après avoir configuré des configurations de dépôts Git pour Spring Cloud Config Server, vous devez lier les travaux au serveur.

Azure CLI

Utilisez la commande suivante pour lier le travail à Spring Cloud Config Server lors de la création du travail :

az spring job create \
    --name <job-name> \
    --bind-config-server true

Pour les travaux existants, utilisez la commande suivante pour les lier à Spring Cloud Config Server :

az spring config-server bind --job <job-name>

Azure portal

Utilisez les étapes suivantes pour lier le travail à Spring Cloud Config Server lors de la création du travail :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, sélectionnez Travail.

3. Sélectionnez Créer un travail puis, dans la section Liaison, sélectionnez Spring Cloud Config Server.

4. Sélectionnez Créer pour démarrer le processus de création.

Pour les travaux existants, effectuez les étapes suivantes pour les lier à Spring Cloud Config Server :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, accédez à la section Composants managés, puis sélectionnez Spring Cloud Config Server.

3. Si le composant est désactivé, sélectionnez Gérer pour l’activer.

4. Sous l’onglet Paramètres, configurez Spring Cloud Config Server avec le dépôt Git approprié. Sélectionnez Valider, puis Appliquer.

5. Sous l’onglet Liaison de travail, sélectionnez Lier le travail et sélectionnez le travail pour appliquer.

   Une fois le travail lié avec succès, le nom du travail apparaît dans la liste.

6. Exécutez le travail.

Si vous n’avez plus besoin de Spring Cloud Config Server pour vos travaux, vous pouvez les en dissocier. Cette modification prend effet lors des nouvelles exécutions de travaux.

Azure CLI

Utilisez la commande suivante pour dissocier un travail :

az spring config-server unbind --job <job-name>

Azure portal

Utilisez les étapes suivantes pour dissocier un travail :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, accédez à la section Composants managés, puis sélectionnez Spring Cloud Config Server.

3. Sous l’onglet Liaison de travail, sélectionnez le travail que vous devez dissocier.

4. Sélectionnez Dissocier le travail.

Intégrer à Tanzu Service Registry

Il est courant qu’un travail appelle une API à partir d’une application de longue durée en collaboration afin de rechercher des informations, des notifications, etc. Pour permettre au travail de découvrir les applications s’exécutant dans le même service Azure Spring Apps, vous pouvez lier vos applications et travaux à un registre de services managés. La section suivante décrit comment lier un travail à Tanzu Service Registry.

Azure CLI

Utilisez la commande suivante pour lier un travail à Tanzu Service Registry lors de la création du travail :

az spring job create --bind-service-registry true

Pour les travaux existants, utilisez la commande suivante pour les lier à Tanzu Service Registry :

az spring service-registry bind --job <job-name>

Azure portal

Utilisez les étapes suivantes pour lier un travail à Tanzu Service Registry lors de la création du travail :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, accédez à la section Composants managés, puis sélectionnez Service Registry.

3. Si le composant est désactivé, sélectionnez Gérer pour l’activer.

4. Sous l’onglet Liaison de travail, sélectionnez Lier le travail et sélectionnez le travail pour appliquer.

   Une fois le travail lié avec succès, le nom du travail apparaît dans la liste.

5. Exécutez le travail.

Pour les travaux existants, utilisez les étapes suivantes pour les lier à Tanzu Service Registry :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, accédez à la section Composants managés, puis sélectionnez Service Registry.

3. Si le composant est désactivé, sélectionnez Gérer pour l’activer.

4. Sous l’onglet Liaison de travail, sélectionnez Lier le travail et sélectionnez le travail pour appliquer.

   Une fois le travail lié avec succès, le nom du travail apparaît dans la liste.

5. Exécutez le travail.

Lorsque vous exécutez l’exécution du travail, elle peut accéder aux points de terminaison des applications inscrites via le registre de services.

Si vous n’avez plus besoin du registre de services pour vos travaux, vous pouvez les en dissocier. Cette modification prend effet lors des nouvelles exécutions de travaux.

Azure CLI

Utilisez la commande suivante pour dissocier le travail :

az spring service-registry unbind --job <job-name>

Azure portal

Utilisez les étapes suivantes pour dissocier le travail :

1. Ouvrez votre instance de service Azure Spring Apps.

2. Dans le volet de navigation, accédez à la section Composants managés, puis sélectionnez Service Registry.

3. Sous l’onglet Liaison de travail, sélectionnez le travail que vous devez dissocier.

4. Sélectionnez Dissocier le travail.

Voir aussi

Travail dans Azure Spring Apps