Eseguire la migrazione della visualizzazione dinamica dell'applicazione all'amministratore spring boot

Articolo
2025-02-04

Nota

I piani Basic, Standard ed Enterprise saranno deprecati a partire dalla metà di marzo 2025, con un periodo di ritiro di 3 anni. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere l'annuncio di ritiro di Azure Spring Apps.

Il piano Standard a consumo e dedicato sarà deprecato a partire dal 30 settembre 2024, con un arresto completo dopo sei mesi. È consigliabile eseguire la transizione ad App Azure Container. Per altre informazioni, vedere Eseguire la migrazione del consumo di Azure Spring Apps Standard e del piano dedicato alle app Azure Container.

Questo articolo si applica a: ❎ Basic/Standard ✅ Enterprise

Questo articolo descrive il percorso di migrazione da Application Live View a Spring Boot Admin.

Spring Boot Admin è uno strumento potente per la gestione e il monitoraggio delle applicazioni Spring Boot. Basato sui attuatori Spring Boot, fornisce informazioni dettagliate sui lavori interni delle applicazioni in esecuzione tramite endpoint HTTP accessibili. L'amministratore di Spring Boot raccoglie i dati e facilita l'interazione con le applicazioni usando questi endpoint.

Configurare il server di amministrazione di Spring Boot

Azure Spring Apps ha fornito in precedenza l'integrazione predefinita con Tanzu Application Live View per facilitare la gestione delle applicazioni. Tuttavia, a causa delle modifiche apportate alle funzionalità del prodotto, questa funzionalità non è più disponibile. Per assicurarsi di poter continuare a gestire facilmente le applicazioni, la procedura seguente illustra la configurazione e l'uso di Spring Boot Admin Server come soluzione alternativa:

Crea una nuova app.
- Azure portal
- Interfaccia della riga di comando di Azure
Usare la procedura seguente per creare un'app Spring Boot Admin Server:
1. Passare all'istanza aziendale di Azure Spring Apps nel portale di Azure.
2. Nel riquadro di spostamento aprire il riquadro App per visualizzare le app per l'istanza del servizio.
3. Selezionare Crea app per aprire il riquadro Crea app .
4. Assegnare all'applicazione il nome spring-boot-admin.
5. Lasciare invariato il tipo di distribuzione(Java/Polyglot).
6. Aprire l'elenco a discesa Bind (Associa) e selezionare Service Registry (Registro di sistema del servizio).
7. Selezionare Crea per creare l'app.
Usare il comando seguente per creare un'app Spring Boot Admin Server:
```
az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-service-instance-name> \
    --name spring-boot-admin \
    --bind-service-registry
```

Compilare il servizio di amministrazione di Spring Boot.

Dopo aver creato l'app, il passaggio successivo consiste nel compilare l'app del servizio di amministrazione di Spring Boot. Seguire le istruzioni nella documentazione introduttiva dell'amministratore di Spring Boot.

È possibile fare riferimento al codice di esempio seguente:

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

Aggiungere le dipendenze di amministratore spring boot seguenti:

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

Distribuire l'app.

Dopo aver compilato il servizio di amministrazione di Spring Boot, distribuirlo usando l'interfaccia della riga di comando di Azure:

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

Assegnare un endpoint pubblico.

Rendere accessibile il server di amministrazione di Spring Boot assegnando un endpoint pubblico tramite Azure Spring Apps.

L'amministratore di Spring Boot non include l'autorizzazione per impostazione predefinita. Spring Boot Admin è una normale applicazione Spring Boot, in modo da poterla proteggere con la sicurezza spring. Vedere anche Protezione del server di amministrazione di Spring Boot.

Registrare le app in Spring Boot Admin

Usare il servizio di individuazione

Spring Boot Admin può individuare le applicazioni usando il servizio di individuazione. Dopo la registrazione delle app nel Registro di sistema del servizio Tanzu, il server di amministrazione spring Boot li riconosce automaticamente.

Per altre informazioni su come registrare le app con il Registro di sistema del servizio Tanzu, vedere Usare il Registro di sistema del servizio Tanzu.

Spring Boot Admin si connette e monitora facilmente le applicazioni Spring Boot con impostazioni di attuatore personalizzate.

Usare un client di amministrazione spring boot

È anche possibile registrare le app come client di amministrazione di Spring Boot. Questo approccio non dipende da un servizio di individuazione, ma richiede la modifica delle app per includere le dipendenze del client di amministrazione di Spring Boot. Per altre informazioni, vedere Introduzione nella documentazione relativa all'amministratore di Spring Boot.

Usare Spring Boot Admin per monitorare le app

Spring Boot Admin consente di visualizzare le metriche in tempo reale per le applicazioni Spring Boot. Spring Boot Admin si basa sul concetto di attuatori Spring Boot.

Seguire questa procedura per distribuire un'app e monitorarla in Spring Boot Admin:

Aggiungere la dipendenza dell'attuatore. Aggiungere la dipendenza seguente al file di pom.xml dell'applicazione.

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

Abilitare gli endpoint dell'attuatore. Nel file application.properties dell'applicazione aggiungere la configurazione seguente per esporre gli endpoint necessari:
```
management.endpoints.web.exposure.include=info,health
```
Compila l'applicazione. Usare il comando seguente per compilare l'app in locale:
```
mvn clean package -DskipTests
```

Distribuire l'applicazione. Distribuire l'app in Azure Spring Apps usando i comandi seguenti:

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

Disabilitare la visualizzazione dinamica dell'applicazione

Dopo la registrazione di tutte le applicazioni Spring Boot in Spring Boot Admin, è possibile disabilitare la funzionalità Visualizzazione live delle applicazioni in Azure Spring Apps seguendo questa procedura:

Azure portal
Interfaccia della riga di comando di Azure

Passare all'istanza del servizio Azure Spring Apps e quindi selezionare Strumenti di sviluppo.
Selezionare Gestisci strumenti.
Deselezionare la casella di controllo Abilita visualizzazione live app e quindi selezionare Salva.
È quindi possibile visualizzare lo stato di Application Live View negli strumenti di sviluppo.

Usare il comando seguente per disabilitare Application Live View:

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

Limitazioni note

Se si registrano app nel Registro di sistema dei servizi, l'applicazione EUREKA-SERVER viene visualizzata nel dashboard di amministrazione di Spring Boot con stato OFFLINE e non può essere nascosta o rimossa.
Per impostazione predefinita, l'accesso Single Sign-On (SSO) non è supportato.

Condividi tramite