Mulai Cepat: Menyiapkan Spring Cloud Config Server untuk Azure Spring Apps

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

Config Server adalah layanan konfigurasi terpusat untuk sistem terdistribusi. Layanan ini menggunakan repositori yang dapat disambungkan yang saat ini mendukung penyimpanan lokal, Git, dan Subversion. Dalam mulai cepat ini, Anda menyiapkan server konfigurasi untuk mendapatkan data dari repositori Git.

Prasyarat

• Penyelesaian mulai cepat sebelumnya dalam seri ini: Menyediakan layanan Azure Spring Apps.
• Azure Spring Apps Config Server hanya berlaku untuk paket Dasar atau Standar.

Prosedur Server Konfigurasi

Siapkan Server Konfigurasi Anda dengan lokasi repositori Git untuk proyek dengan menjalankan perintah berikut. Ganti <service-instance-name> dengan nama layanan yang Anda buat sebelumnya. Nilai default untuk nama instans layanan yang Anda tetapkan di mulai cepat sebelumnya tidak berfungsi dengan perintah ini.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/Azure-Samples/azure-spring-apps-samples \
    --search-paths steeltoe-sample/config

Perintah ini memberi tahu Server Konfigurasi untuk menemukan data konfigurasi dalam folder steeltoe-sample/config dari repositori aplikasi sampel. Karena nama aplikasi yang mendapatkan data konfigurasi adalah planet-weather-provider, file yang digunakan planet-weather-provider.yml.

Prasyarat

• JDK 17
• Langganan Azure. Jika Anda tidak memiliki langganan, buat akun gratis sebelum memulai.
• Secara opsional, Azure CLI versi 2.45.0 atau yang lebih tinggi. Instal ekstensi Azure Spring Apps dengan perintah berikut: az extension add --upgrade --name spring
• Secara opsional, Azure Toolkit untuk IntelliJ.

Prosedur Server Konfigurasi

Portal Azure

Prosedur berikut menyiapkan Server Konfigurasi menggunakan portal Microsoft Azure untuk menyebarkan sampel PetClinic.

1. Buka halaman Ringkasan layanan dan pilih Server Konfigurasi.

2. Di bagian Repositori default, atur URI menjadi https://github.com/azure-samples/spring-petclinic-microservices-config.

3. Pilih Validasi. Validasi memeriksa skema dan aksesibilitas repositori git Anda untuk memastikannya benar.

   

4. Setelah validasi selesai, klik Terapkan untuk menyimpan perubahan Anda.

   

Diperlukan waktu beberapa menit untuk memperbarui konfigurasi. Anda harus mendapatkan pemberitahuan saat konfigurasi selesai.

Azure CLI

Prosedur berikut menggunakan Azure CLI untuk menyiapkan Server Konfigurasi untuk menyebarkan sampel Pet Clinic.

Jalankan perintah berikut untuk mengatur repositori Default.

az spring config-server git set \
    --name <service-instance-name> \
    --uri https://github.com/azure-samples/spring-petclinic-microservices-config

Tip

Untuk informasi tentang menggunakan repositori privat untuk Config Server, lihat Mengonfigurasi Spring Cloud Config Server terkelola di Azure Spring Apps.

Pemecahan masalah terkait Server Konfigurasi Azure Spring Apps

Prosedur berikut menjelaskan cara memecahkan masalah pengaturan Config Server.

1. Di portal Microsoft Azure, buka halaman Ringkasan layanan dan pilih Log.

2. Di panel Kueri di bawah Tampilkan log aplikasi yang berisi istilah "kesalahan" atau "pengecualian", pilih Jalankan.

   

   Kesalahan berikut dalam log menunjukkan bahwa layanan Spring Apps tidak dapat menemukan properti dari Config Server: java.lang.illegalStateException

3. Buka halaman Ringkasan layanan.

4. Pilih Diagnosis dan selesaikan masalah.

5. Di bawah Ketersediaan dan Performa, pilih Pemecahan Masalah.

   

   portal Azure menampilkan Halaman Ketersediaan dan Performa, yang menyediakan berbagai informasi tentang status kesehatan Config Server.

Membersihkan sumber daya

Jika Anda berencana untuk terus bekerja dengan mulai cepat dan tutorial berikutnya, biarkan sumber daya ini tetap di tempatnya. Saat Anda tidak lagi membutuhkannya, hapus grup sumber daya, yang menghapus sumber daya di grup sumber daya. Untuk menghapus grup sumber daya, masukkan perintah berikut di Azure CLI:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Langkah berikutnya

Mulai Cepat: Membangun dan menyebarkan aplikasi ke Azure Spring Apps