Memigrasikan Tampilan Langsung Aplikasi ke Admin Spring Boot

Catatan

Paket Basic, Standard, dan Enterprise memasuki periode pensiun pada 17 Maret 2025. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Artikel ini berlaku untuk: ❎ Basic/Standard ✅ Enterprise

Artikel ini menjelaskan jalur migrasi dari Tampilan Langsung Aplikasi ke Spring Boot Admin.

Spring Boot Admin adalah alat yang ampuh untuk mengelola dan memantau aplikasi Spring Boot. Dibangun di Spring Boot Actuators, ini memberikan wawasan tentang pekerjaan internal menjalankan aplikasi melalui titik akhir HTTP yang dapat diakses. Spring Boot Admin mengumpulkan data dan memfasilitasi interaksi dengan aplikasi Anda dengan menggunakan titik akhir ini.

Menyiapkan Spring Boot Admin Server

Azure Spring Apps sebelumnya menyediakan integrasi bawaan dengan Tanzu Application Live View untuk membantu Anda mengelola aplikasi Anda. Namun, karena perubahan fitur produk, fungsionalitas ini tidak lagi tersedia. Untuk memastikan Anda dapat terus mengelola aplikasi dengan mudah, langkah-langkah berikut memandu Anda mengonfigurasi dan menggunakan Spring Boot Admin Server sebagai solusi alternatif:

Buat aplikasi baru.
- Portal Azure
- Azure CLI
Gunakan langkah-langkah berikut untuk membuat aplikasi Spring Boot Admin Server:
1. Navigasikan ke instans perusahaan Azure Spring Apps Anda di portal Azure.
2. Dari panel navigasi, buka panel Aplikasi untuk menampilkan aplikasi untuk instans layanan Anda.
3. Pilih Buat Aplikasi untuk membuka panel Buat Aplikasi .
4. Beri nama aplikasi spring-boot-admin.
5. Biarkan Jenis penyebaran sebagai Artefak (Java/Polyglot) tidak berubah.
6. Buka menu tarik-turun Ikatan dan pilih Registri Layanan.
7. Pilih Buat untuk membuat aplikasi.
Gunakan perintah berikut untuk membuat aplikasi 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
```

Bangun Spring Boot Admin Service.

Setelah Anda membuat aplikasi, langkah selanjutnya adalah membangun aplikasi layanan Spring Boot Admin. Ikuti instruksi dalam dokumentasi Memulai Admin Spring Boot.

Anda dapat mereferensikan contoh kode berikut:

SpringBootAdminApplication.java

@SpringBootApplication
@Configuration
@EnableAutoConfiguration // Use a discovery service instead of Spring Boot Admin Client. 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

Tambahkan dependensi Admin Spring Boot berikut:

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

Sebarkan aplikasi.

Setelah membangun layanan Spring Boot Admin, sebarkan menggunakan 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

Tetapkan titik akhir publik.

Buat server Spring Boot Admin dapat diakses dengan menetapkan titik akhir publik melalui Azure Spring Apps.

Admin Spring Boot tidak menyertakan otorisasi secara default. Spring Boot Admin adalah aplikasi Spring Boot normal, sehingga Anda dapat mengamankannya dengan keamanan musim semi. Lihat juga Mengamankan Server Admin Spring Boot.

Mendaftarkan aplikasi ke Spring Boot Admin

Menggunakan layanan penemuan

Spring Boot Admin dapat menemukan aplikasi dengan mengandalkan layanan penemuan. Setelah aplikasi terdaftar di Tanzu Service Registry, server Spring Boot Admin mengenalinya secara otomatis.

Untuk informasi selengkapnya tentang cara mendaftarkan aplikasi dengan Tanzu Service Registry, lihat Menggunakan Tanzu Service Registry.

Spring Boot Admin terhubung dengan lancar dan memantau aplikasi Spring Boot yang memiliki pengaturan aktuator kustom.

Menggunakan Klien Admin Spring Boot

Anda juga dapat mendaftarkan aplikasi sebagai Klien Admin Spring Boot. Pendekatan ini tidak bergantung pada layanan penemuan tetapi mengharuskan memodifikasi aplikasi Anda untuk menyertakan dependensi Klien Admin Spring Boot. Untuk informasi selengkapnya, lihat Memulai dalam dokumentasi Spring Boot Admin.

Menggunakan Spring Boot Admin untuk memantau aplikasi Anda

Spring Boot Admin memungkinkan Anda melihat metrik langsung untuk aplikasi Spring Boot. Spring Boot Admin didasarkan pada konsep Spring Boot Actuators.

Ikuti langkah-langkah berikut untuk menyebarkan aplikasi dan memantaunya di Spring Boot Admin:

Tambahkan dependensi aktuator. Tambahkan dependensi berikut ke file pom.xml aplikasi Anda.

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

Aktifkan titik akhir aktuator. Dalam file application.properties aplikasi Anda, tambahkan konfigurasi berikut untuk mengekspos titik akhir yang diperlukan:
```
management.endpoints.web.exposure.include=info,health
```
Bangun aplikasi. Gunakan perintah berikut untuk membangun aplikasi Anda secara lokal:
```
mvn clean package -DskipTests
```

Terapkan aplikasi. Sebarkan aplikasi ke Azure Spring Apps dengan menggunakan perintah berikut:

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

Nonaktifkan Tampilan Langsung Aplikasi

Setelah semua aplikasi Spring Boot terdaftar di Spring Boot Admin, Anda dapat menonaktifkan fitur Application Live View di Azure Spring Apps dengan mengikuti langkah-langkah berikut:

Portal Azure
Azure CLI

Navigasi ke instans layanan Azure Spring Apps Anda, lalu pilih Alat Pengembang.
Pilih Kelola Alat.
Kosongkan kotak centang Aktifkan Tampilan Langsung Aplikasi, lalu pilih Simpan.
Anda kemudian dapat melihat status Tampilan Langsung Aplikasi di Alat Pengembang.

Gunakan perintah berikut untuk menonaktifkan Tampilan Langsung Aplikasi:

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

Pembatasan yang diketahui

Jika Anda mendaftarkan aplikasi dengan Service Registry, aplikasi EUREKA-SERVER muncul di dasbor Spring Boot Admin dengan status OFFLINE , dan tidak dapat disembunyikan atau dihapus.
Secara default, akses menyeluruh (SSO) tidak didukung.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-10-31