Azure Container Apps'te Spring için yönetilen ağ geçidine bağlanma (önizleme)

Spring için Gateway, mikro hizmet mimarisinin bir parçası olarak API isteklerini yönlendirmek, yönetmek ve işlemek için verimli ve güçlü bir yol sunar. Dış istekleri farklı hizmetlere yönlendiren, filtreleme, yük dengeleme ve daha fazlası gibi çeşitli özellikler ekleyen bir API Gateway işlevi görür. Bu makalede, istekleri kapsayıcı uygulamalarınıza yönlendiren bir ağ geçidi oluşturmayı öğreneceksiniz.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

Önkoşullar

• Etkin aboneliği olan bir Azure hesabı. Henüz bir hesabınız yoksa ücretsiz olarak oluşturabilirsiniz.
• Azure CLI.

Dikkat edilmesi gereken noktalar

Azure Container Apps'te Spring için Gateway'de çalışırken aşağıdaki ayrıntılara dikkat edin:

Ayarlama

Spring için Ağ Geçidi ile çalışmaya başlamadan önce gerekli kaynakları oluşturmanız gerekir.

Kaynak grubunuzu ve Container Apps ortamınızı oluşturmak için aşağıdaki komutları yürütebilirsiniz.

1. Uygulama yapılandırmanızı desteklemek için değişkenler oluşturun. Bu değerler, bu dersin amaçları doğrultusunda size sağlanır. Bu derste spring sample uygulaması için yöneticinin aktüatör uç noktasını kullanacağız.

   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"
   

   Değişken	Açıklama
   LOCATION	Kapsayıcı uygulamanızı ve Java bileşenini oluşturduğunuz Azure bölgesi konumu.
   ENVIRONMENT	Tanıtım uygulamanızın Azure Container Apps ortam adı.
   RESOURCE_GROUP	Tanıtım uygulamanızın Azure kaynak grubu adı.
   JAVA_COMPONENT_NAME	Kapsayıcı uygulamanız için oluşturulan Java bileşeninin adı. Bu durumda Spring Java için bir Ağ Geçidi bileşeni oluşturursunuz.
   IMAGE	Kapsayıcı uygulamanızda kullanılan kapsayıcı görüntüsü.

2. Azure CLI ile Azure'da oturum açın.

   az login
   

3. Kaynak grubu oluşturun.

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

4. Kapsayıcı uygulamaları ortamınızı oluşturun.

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

   Bu ortam hem Spring için Ağ Geçidi bileşenini hem de kapsayıcı uygulamanızı barındırmak için kullanılır.

Spring Java için Ağ Geçidi bileşenini kullanma

Artık bir Container Apps ortamınız olduğuna göre, kapsayıcı uygulamanızı oluşturarak spring java bileşenlerinin isteği onlara yönlendirmesi için bir ağ geçidi kullanabilirsiniz.

1. Spring Java için Ağ Geçidi bileşenini oluşturun.

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

2. Tam etki alanı adına (FQDN) sahip kapsayıcı uygulamasını oluşturun.

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

   Bu komut, yapılandırma verilerini kullanan kapsayıcı uygulamanızın URL'sini döndürür. Sonraki adımda kullanabilmek için URL'yi bir metin düzenleyicisine kopyalayın.

Ağ Geçidi Yollarını yönlendirme isteklerine güncelleştirme

1. Aşağıdaki içeriğe sahip bir YAML dosyası oluşturun. değerini önceki adımda yer alan kapsayıcı uygulaması FQDN'siyle değiştirin <MYAPP_URL> .

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

2. Spring için Ağ Geçidi bileşenini rota yapılandırmanızla güncelleştirmek için aşağıdaki komutu çalıştırın.

   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
   

   Bu komut ağ geçidi yolunu güncelleştirir ve ağ geçidinizin yapılandırma verilerini kullanan URL'sini döndürür.

   Komut, ağ geçidinin URL'sini döndürür. Bu URL'yi yol /myapp/health ile ziyaret etmek isteği uygulamanızın actuator/health uç noktasına yönlendirerek döndürmelidir {"status":"UP","groups":["liveness","readiness"]}.

Kaynakları temizleme

Bu öğreticide oluşturulan kaynakların Azure faturanız üzerinde etkisi vardır. Bu hizmetleri uzun süreli kullanmayacaksanız, bu öğreticide oluşturulan her şeyi kaldırmak için aşağıdaki komutu çalıştırın.

az group delete --resource-group $RESOURCE_GROUP

Yol dosyası biçimi

Spring için Ağ Geçidi bileşeni, kimlik, URI, koşul ve filtrelere sahip özellikler aracılığıyla yolların tanımlanmasını destekler. Daha fazla bilgi için Spring Cloud Gateway belgelerine bakın. Aşağıda, bu özelliklerin nasıl yapılandırıldığını gösteren örnek bir YAML dosyası verilmiştir.

  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}"

Spring için Ağ Geçidiniz için izin verilen yapılandırma listesi(#configurable-özellikler)

Aşağıdaki tabloda, uygulamanız için yapılandırabileceğiniz ağ geçidi bileşeni özellikleri açıklanmaktadır. Daha fazla bilgi için bkz . Spring Cloud Gateway Ortak uygulama özellikleri.

Ortak yapılandırmalar

Aşağıdaki listede yaygın yapılandırmalar açıklanmaktadır:

• İlgili yapılandırmaları günlüğe kaydetme:
  • logging.level.*
  • logging.group.*
  • Ad alanı altındaki logging.* diğer yapılandırmalar yasak olmalıdır. Örneğin, kullanarak logging.file günlük dosyalarını yazmak yasak olmalıdır.