Menyambungkan ke Server Eureka terkelola untuk Spring di Azure Container Apps

Eureka Server for Spring adalah registri layanan yang memungkinkan layanan mikro mendaftarkan diri mereka dan menemukan layanan lain. Eureka Server for Spring tersedia sebagai komponen Azure Container Apps. Anda dapat mengikat aplikasi kontainer Anda ke Eureka Server untuk Spring untuk pendaftaran otomatis dengan server Eureka.

Dalam tutorial ini, Anda akan mempelajari cara:

Prasyarat

• Akun Azure dengan langganan aktif. Jika Anda belum memilikinya, Anda dapat membuatnya secara gratis.
• Azure CLI.

Pertimbangan

Saat Anda menjalankan Eureka Server untuk Spring di Container Apps, ketahui detail berikut:

Siapkan

Sebelum Anda mulai bekerja dengan komponen Eureka Server for Spring, Anda harus terlebih dahulu membuat sumber daya yang diperlukan.

Membuat komponen Eureka Server for Spring Java

Mengikat aplikasi kontainer Anda ke komponen Eureka Server for Spring Java

Kembali ke aplikasi kontainer di portal. Salin URL aplikasi Anda ke editor teks sehingga Anda dapat menggunakannya di langkah mendatang.

/allRegistrationStatus Buka rute untuk melihat semua aplikasi yang terdaftar di komponen Eureka Server for Spring.

Pengikatan menyuntikkan beberapa konfigurasi ke dalam aplikasi sebagai variabel lingkungan, terutama eureka.client.service-url.defaultZone properti . Properti ini menunjukkan titik akhir internal komponen Eureka Server Java.

Pengikatan juga menyuntikkan properti berikut:

"eureka.client.register-with-eureka":    "true"
"eureka.client.fetch-registry":          "true"
"eureka.instance.prefer-ip-address":     "true"

eureka.client.register-with-eureka Properti diatur ke true untuk memberlakukan pendaftaran dengan server Eureka. Pendaftaran ini menimpa pengaturan lokal di application.properties, dari server konfigurasi dan sebagainya. Jika Anda ingin mengaturnya ke false, Anda dapat menimpanya dengan mengatur variabel lingkungan di aplikasi kontainer Anda.

Properti eureka.instance.prefer-ip-address diatur ke true karena aturan resolusi sistem nama domain tertentu di lingkungan aplikasi kontainer. Jangan ubah nilai ini agar Anda tidak memutus pengikatan.

Opsional: Batalkan ikatan aplikasi kontainer Anda dari komponen Eureka Server for Spring Java

az containerapp update \
    --name $APP_NAME \
    --unbind $JAVA_COMPONENT_NAME \
    --resource-group $RESOURCE_GROUP

Menampilkan aplikasi melalui dasbor

1. Buat definisi peran kustom.

   az role definition create --role-definition '{
       "Name": "<YOUR_ROLE_NAME>",
       "IsCustom": true,
       "Description": "Can access managed Java Component dashboards in managed environments",
       "Actions": [
           "Microsoft.App/managedEnvironments/write"
       ],
       "AssignableScopes": ["/subscriptions/<SUBSCRIPTION_ID>"]
   }'
   

   Pastikan untuk mengganti <SUBSCRIPTION_ID> tempat penampung dalam AssignableScopes nilai dengan ID langganan Anda.

2. Tetapkan peran kustom ke akun Anda pada sumber daya lingkungan terkelola.

   Dapatkan ID sumber daya lingkungan terkelola:

   export ENVIRONMENT_ID=$(az containerapp env show \
       --name $ENVIRONMENT --resource-group $RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. Tetapkan peran ke akun Anda.

   Sebelum Anda menjalankan perintah ini, ganti tempat penampung - yang ditunjukkan oleh tanda <> kurung - dengan ID pengguna atau perwakilan layanan Anda dan nama peran Anda.

   az role assignment create \
       --assignee <USER_OR_SERVICE_PRINCIPAL_ID> \
       --role "<ROLE_NAME>" \
       --scope $ENVIRONMENT_ID
   

   Catatan

   Nilai <USER_OR_SERVICE_PRINCIPAL_ID> biasanya harus menjadi identitas yang Anda gunakan untuk mengakses portal Azure. Nilainya <ROLE_NAME> adalah nama yang Anda tetapkan di langkah 1.

4. Dapatkan URL dasbor Eureka Server for Spring.

   az containerapp env java-component eureka-server-for-spring show \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $EUREKA_COMPONENT_NAME \
       --query properties.ingress.fqdn \
       --output tsv
   

   Perintah ini mengembalikan URL yang dapat Anda gunakan untuk mengakses dasbor Eureka Server for Spring. Dengan dasbor, Anda juga dapat melihat aplikasi kontainer Anda, seperti yang ditunjukkan pada cuplikan layar berikut.

   

Opsional: Mengintegrasikan Server Eureka untuk Spring dan Admin untuk komponen Spring Java

Jika Anda ingin mengintegrasikan Server Eureka untuk Spring dan Admin untuk komponen Spring Java, lihat Mengintegrasikan Admin terkelola untuk Spring dengan Eureka Server untuk Spring.

Membersihkan sumber daya

Sumber daya yang dibuat dalam tutorial ini berpengaruh pada tagihan Azure Anda. Jika Anda tidak akan menggunakan layanan ini dalam jangka panjang, jalankan perintah berikut untuk menghapus semua yang Anda buat dalam tutorial ini.

az group delete --resource-group $RESOURCE_GROUP

Daftar konfigurasi yang diizinkan untuk Server Eureka Anda untuk Spring

Bagian berikut menjelaskan konfigurasi yang didukung. Untuk informasi selengkapnya, lihat Spring Cloud Eureka Server.

Opsi konfigurasi

Perintah az containerapp update menggunakan --configuration parameter untuk mengontrol bagaimana Eureka Server for Spring dikonfigurasi. Anda dapat menggunakan beberapa parameter sekaligus selama dipisahkan oleh spasi. Untuk informasi selengkapnya, lihat Spring Cloud Eureka Server.

Pengaturan konfigurasi berikut tersedia pada eureka.server properti konfigurasi:

Konfigurasi umum

• Konfigurasi terkait pengelogan:
  • logging.level.*
  • logging.group.*
  • Konfigurasi lain di bawah logging.* namespace harus dilarang - misalnya, menulis file log dengan menggunakan logging.file harus dilarang.

Panggilan antar aplikasi

Contoh ini menunjukkan kepada Anda cara menulis kode Java untuk memanggil antara aplikasi yang terdaftar dengan komponen Eureka Server for Spring. Ketika aplikasi kontainer terikat dengan Eureka, mereka berkomunikasi satu sama lain melalui server Eureka.

Contohnya membuat dua aplikasi, pemanggil dan penerima panggilan. Kedua aplikasi berkomunikasi satu sama lain menggunakan komponen Eureka Server for Spring. Aplikasi callee mengekspos titik akhir yang dipanggil oleh aplikasi pemanggil.

1. Buat aplikasi callee. Aktifkan klien Eureka di aplikasi Spring Boot Anda dengan menambahkan @EnableDiscoveryClient anotasi ke kelas utama Anda.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CalleeApplication {
     public static void main(String[] args) {
       SpringApplication.run(CalleeApplication.class, args);
     }
   }
   

2. Buat titik akhir di aplikasi callee yang dipanggil oleh aplikasi pemanggil.

   @RestController
   public class CalleeController {
   
       @GetMapping("/call")
       public String calledByCaller() {
           return "Hello from Application callee!";
       }
   }
   

3. Atur nama aplikasi callee dalam file konfigurasi aplikasi - misalnya, di application.yml.

   spring.application.name=callee
   

4. Buat aplikasi pemanggil.

   @EnableDiscoveryClient Tambahkan anotasi untuk mengaktifkan fungsionalitas klien Eureka. Selain itu, buat WebClient.Builder kacang dengan @LoadBalanced anotasi untuk melakukan panggilan seimbang beban ke layanan lain.

   @SpringBootApplication
   @EnableDiscoveryClient
   public class CallerApplication {
     public static void main(String[] args) {
       SpringApplication.run(CallerApplication.class, args);
     }
   
     @Bean
     @LoadBalanced
     public WebClient.Builder loadBalancedWebClientBuilder() {
       return WebClient.builder();
     }
   }
   

5. Buat pengontrol di aplikasi pemanggil yang menggunakan WebClient.Builder untuk memanggil aplikasi callee menggunakan nama aplikasinya, callee.

   @RestController
   public class CallerController {
       @Autowired
       private WebClient.Builder webClientBuilder;
   
       @GetMapping("/call-callee")
       public Mono<String> callCallee() {
           return webClientBuilder.build()
               .get()
               .uri("http://callee/call")
               .retrieve()
               .bodyToMono(String.class);
       }
   }
   

Sekarang Anda memiliki aplikasi penelepon dan callee yang berkomunikasi satu sama lain menggunakan komponen Eureka Server for Spring Java. Pastikan kedua aplikasi berjalan dan mengikat dengan server Eureka sebelum menguji /call-callee titik akhir di aplikasi pemanggil.

Batasan

• Komponen Eureka Server Java dilengkapi dengan konfigurasi default, eureka.server.enable-self-preservation, diatur ke false. Konfigurasi default ini membantu menghindari waktu ketika instans tidak dihapus setelah pemeliharaan mandiri diaktifkan. Jika instans dihapus terlalu dini, beberapa permintaan mungkin diarahkan ke instans yang tidak ada. Jika Anda ingin mengubah pengaturan ini menjadi true, Anda dapat menimpanya dengan mengatur konfigurasi Anda sendiri di komponen Java.
• Dasbor Eureka tidak tersedia di Azure China 21Vianet.

Langkah berikutnya

Konten terkait

Mengintegrasikan Admin terkelola untuk Spring dengan Eureka Server untuk Spring