Migrer l’affichage en direct de l’application vers l’administrateur Spring Boot

Article
02/07/2025

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 décrit le chemin de migration de l’affichage en direct de l’application vers l’administrateur Spring Boot.

L’administrateur Spring Boot est un outil puissant pour la gestion et la surveillance des applications Spring Boot. En se basant sur des actionneurs, Spring Boot fournit des insights sur les fonctionnements internes des applications en cours d’exécution via des points de terminaison HTTP accessibles. L’administrateur Spring Boot collecte des données et facilite l’interaction avec vos applications à l’aide de ces points de terminaison.

Configurer le serveur d’administration Spring Boot

Azure Spring Apps fournissait jusqu’à présent une solution intégrée avec l’application d’affichage en direct Tanzu pour vous aider à gérer vos applications. Toutefois, en raison des modifications apportées aux fonctionnalités du produit, cette fonctionnalité n’est plus disponible. Pour vous assurer de continuer à gérer facilement vos applications, les étapes suivantes vous guident tout au long de la configuration et de l’utilisation du serveur d’administration Spring Boot comme solution alternative :

Créer une application.
- Azure portal
- Azure CLI
Pour créer une application de serveur d’administration Spring Boot, procédez comme suit :
1. Accédez à votre instance d’entreprise Azure Spring Apps dans le portail Azure.
2. Dans le volet de navigation, ouvrez le volet Apps pour afficher les applications de votre instance de service.
3. Sélectionnez Créer une application pour ouvrir le volet Créer une application.
4. Nommez l’application spring-boot-admin.
5. Laissez le Type de déploiement défini comme Artefacts (Java/Polyglot) inchangé.
6. Ouvrez la liste déroulante Liaison et sélectionnez Service Registre.
7. Sélectionnez Créer pour créer l’application.
Utilisez la commande suivante pour créer une application de serveur d’administration Spring Boot :
```
az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --bind-service-registry
```

Générer le service d’administration Spring Boot.

Après avoir créé l’application, l’étape suivante consiste à générer l’application de service d’administration Spring Boot. Suivez les instructions de la documentation Prise en main de l’administrateur Spring Boot.

Vous pouvez vous référer à l’exemple de code suivant :

SpringBootAdminApplication.java

@SpringBootApplication
@Configuration
@EnableAutoConfiguration // Use a discovery service instead of Spring Boot Admin Clinet. The rest is done by our AutoConfiguration.
@EnableDiscoveryClient  // Enables the service to register with a discovery service
@EnableAdminServer
public class SpringBootAdminApplication {
  public static void main(String[] args) {
     SpringApplication.run(SpringBootAdminApplication.class, args);
  }
}

pom.xml

Ajoutez les dépendances d’administration Spring Boot suivantes :

<!-- Spring Boot Admin -->
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-starter-server</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>
<dependency>
  <groupId>de.codecentric</groupId>
  <artifactId>spring-boot-admin-server-ui</artifactId>
  <version>${spring-boot-admin.version}</version>
</dependency>

Déployez l’application.

Après avoir généré le service d’administration Spring Boot, déployez-le à l’aide d’Azure CLI :

cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --source-path

Attribuer un point de terminaison public.

Rendez le serveur d’administration Spring Boot accessible en affectant un point de terminaison public via Azure Spring Apps.

L’administrateur Spring Boot n’inclut pas l’autorisation par défaut. L’administrateur Spring Boot est une application Spring Boot normale. Vous pouvez donc la sécuriser avec la sécurité Spring. Consultez également Sécurisation du serveur d’administration Spring Boot.

Inscrire des applications à l’administrateur Spring Boot

Utiliser le service de découverte

L’administrateur Spring Boot peut trouver des applications en s’appuyant sur le service de découverte. Une fois que les applications sont inscrites avec le Service de registre Tanzu, le serveur d’administration Spring Boot les reconnaît automatiquement.

Pour plus d’informations sur l’inscription d’applications auprès du service de registre Tanzu, consultez Utiliser le service de registre Tanzu.

L’administrateur Spring Boot se connecte et surveille en toute transparence les applications Spring Boot qui ont des paramètres d’actionneur personnalisés.

Utiliser un client d’administration Spring Boot

Vous pouvez également inscrire des applications en tant que clients d’administration Spring Boot. Cette approche ne dépend pas d’un service de découverte, mais nécessite la modification de vos applications pour inclure les dépendances du client d’administration Spring Boot. Pour plus d’informations, consultez la rubrique Prise en main de la documentation de l’administrateur Spring Boot.

Utiliser l’administrateur Spring Boot pour surveiller vos applications

L’administrateur Spring Boot vous permet d’afficher en direct les indicateurs de performance pour les applications Spring Boot. L’administrateur Spring Boot est basé sur le concept des actionneurs Spring Boot.

Procédez comme suit pour déployer une application et la surveiller dans l’administrateur Spring Boot :

Ajoutez la dépendance de l’actionneur. Ajoutez la dépendance suivante au fichier pom.xml de votre application.

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
 </dependency>

Activez les points de terminaison de l’actionneur. Dans le fichier propriétés de l’application votre application, ajoutez la configuration suivante pour exposer les points de terminaison nécessaires :
```
management.endpoints.web.exposure.include=info,health
```
Générez l’application. Utilisez la commande suivante pour générer localement votre application :
```
mvn clean package -DskipTests
```

Déployez l’application. Utilisez la commande suivante pour déployer l’application sur Azure Spring Apps :

az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name>
cd <path-to-maven-or-gradle-source-root>
az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name <app-name> \
    --source-path

Désactiver l’affichage en direct de l’application

Une fois que toutes les applications Spring Boot sont inscrites dans l’administrateur Spring Boot, vous pouvez désactiver la fonctionnalité d’affichage en direct de l’application dans Azure Spring Apps en procédant comme suit :

Azure portal
Azure CLI

Accédez à votre instance de service Azure Spring Apps, puis sélectionnez Outils de développement.
Sélectionnez Gérer les outils.
Décochez la case Activer l’affichage en direct de l’application, puis sélectionnez Enregistrer.
Vous pouvez ensuite afficher l’état de Application Live View sur les Outils de développement.

Utilisez la commande suivante pour désactiver l’affichage en direct de l’application :

az spring application-live-view delete
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name>

Limitations connues

Si vous inscrivez des applications avec le service de registre, l’application EUREKA-SERVER apparaît dans le tableau de bord d’administration Spring Boot avec le statut HORS CONNEXION et ne peut pas être masquée ou supprimée.
Par défaut, l’authentification unique (SSO) n’est pas prise en charge.

Partager via