Menyambungkan ke Gateway terkelola untuk Spring di Azure Container Apps (pratinjau)

Gateway untuk Spring menawarkan cara yang efisien dan kuat untuk merutekan, mengelola, dan menangani permintaan API sebagai bagian dari arsitektur layanan mikro. Ini berfungsi sebagai API Gateway yang merutekan permintaan eksternal ke layanan yang berbeda, menambahkan berbagai kemampuan seperti pemfilteran, penyeimbangan beban, dan banyak lagi. Dalam artikel ini, Anda mempelajari cara membuat gateway yang mengarahkan permintaan ke aplikasi kontainer Anda.

Dalam tutorial ini, Anda mempelajari caranya:

Prasyarat

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

Pertimbangan

Saat berjalan di Gateway untuk Spring di Azure Container Apps, ketahui detail berikut:

Siapkan

Sebelum Anda mulai bekerja dengan Gateway untuk Spring, Anda harus terlebih dahulu membuat sumber daya yang diperlukan.

Jalankan perintah berikut untuk membuat grup sumber daya dan lingkungan Container Apps Anda.

1. Buat variabel untuk mendukung konfigurasi aplikasi Anda. Nilai-nilai ini disediakan untuk Anda untuk tujuan pelajaran ini. Kami menggunakan titik akhir aktuator admin untuk aplikasi sampel spring dalam pelajaran ini.

   export LOCATION=eastus
   export RESOURCE_GROUP=my-spring-cloud-resource-group
   export ENVIRONMENT=my-spring-cloud-environment
   export JAVA_COMPONENT_NAME=mygateway
   export APP_NAME=myapp
   export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-admin-for-spring-client:latest"
   

   Variabel	Deskripsi
   LOCATION	Lokasi wilayah Azure tempat Anda membuat aplikasi kontainer dan komponen Java.
   ENVIRONMENT	Nama lingkungan Azure Container Apps untuk aplikasi demo Anda.
   RESOURCE_GROUP	Nama grup sumber daya Azure untuk aplikasi demo Anda.
   JAVA_COMPONENT_NAME	Nama komponen Java yang dibuat untuk aplikasi kontainer Anda. Dalam hal ini, Anda membuat komponen Gateway untuk Spring Java.
   IMAGE	Gambar kontainer yang digunakan di aplikasi kontainer Anda.

2. Masuk ke Azure dengan Azure CLI.

   az login
   

3. Buat grup sumber daya.

   az group create --name $RESOURCE_GROUP --location $LOCATION
   

4. Buat lingkungan aplikasi kontainer Anda.

   az containerapp env create \
       --name $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION
   

   Lingkungan ini digunakan untuk menghosting komponen Gateway for Spring dan aplikasi kontainer Anda.

Menggunakan komponen Gateway untuk Spring Java

Setelah memiliki lingkungan Container Apps, Anda dapat membuat aplikasi kontainer menggunakan gateway untuk komponen spring java untuk merutekan permintaan ke aplikasi tersebut.

1. Buat komponen Gateway untuk Spring Java.

   az containerapp env java-component gateway-for-spring create \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \
   

2. Buat aplikasi kontainer yang memiliki nama domain yang sepenuhnya memenuhi syarat (FQDN).

   az containerapp create \
       --name $APP_NAME \
       --resource-group $RESOURCE_GROUP \
       --environment $ENVIRONMENT \
       --image $IMAGE \
       --ingress external \
       --target-port 8080 \
       --query properties.configuration.ingress.fqdn
   

   Perintah ini mengembalikan URL aplikasi kontainer Anda yang menggunakan data konfigurasi. Salin URL ke editor teks sehingga Anda dapat menggunakannya di langkah berikutnya.

Memperbarui Rute Gateway untuk merutekan permintaan

1. Buat file YAML dengan konten berikut. Ganti <MYAPP_URL> dengan FQDN aplikasi kontainer dari langkah sebelumnya.

   springCloudGatewayRoutes:
   - id: "route1"
     uri: "<MYAPP_URL>"
     predicates:
       - "Path=/myapp/{path}"
     filters:
       - "SetPath=/actuator/{path}"
   

2. Jalankan perintah berikut untuk memperbarui komponen Gateway for Spring dengan konfigurasi rute Anda.

   az containerapp env java-component gateway-for-spring update \
       --environment $ENVIRONMENT \
       --resource-group $RESOURCE_GROUP \
       --name $JAVA_COMPONENT_NAME \ 
       --route-yaml <PTAH_TO_ROUTE_YAML_FILE> \
       --query properties.ingress.fqdn
   

   Perintah ini memperbarui rute gateway dan mengembalikan URL gateway Anda yang menggunakan data konfigurasi.

   Perintah mengembalikan URL gateway. Mengunjungi URL ini dengan jalur /myapp/health harus merutekan permintaan ke titik akhir aplikasi actuator/health Anda, mengembalikan {"status":"UP","groups":["liveness","readiness"]}.

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 dibuat dalam tutorial ini.

az group delete --resource-group $RESOURCE_GROUP

Format file rute

Komponen Gateway untuk Spring mendukung menentukan rute melalui properti dengan ID, URI, predikat, dan filter. Untuk informasi selengkapnya, lihat dokumentasi Spring Cloud Gateway. Berikut ini adalah contoh file YAML yang menunjukkan cara mengonfigurasi properti ini.

  springCloudGatewayRoutes:
  - id: "route1"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v1/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"
  - id: "route2"
    uri: "https://otherjavacomponent.myenvironment.test.net"
    predicates:
      - "Path=/v2/{path}"
      - "After=2024-01-01T00:00:00.000-00:00[America/Denver]"
    filters:
      - "SetPath=/{path}"

Daftar konfigurasi yang diizinkan untuk Gateway anda untuk Spring(#configurable-properties)

Tabel berikut ini menjelaskan properti komponen gateway yang bisa Anda konfigurasi untuk aplikasi Anda. Untuk informasi selengkapnya, lihat Properti aplikasi Umum Spring Cloud Gateway.

Konfigurasi umum

Daftar berikut ini menjelaskan 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.