Csatlakozás felügyelt Spring-átjáróhoz az Azure Container Appsben (előzetes verzió)

A Spring-átjáró hatékony és hatékony módot kínál az API-kérések irányítására, kezelésére és kezelésére a mikroszolgáltatás-architektúra részeként. API-átjáróként szolgál, amely a külső kéréseket különböző szolgáltatásokhoz irányítja, és különböző képességeket, például szűrést, terheléselosztást és egyebeket ad hozzá. Ebből a cikkből megtudhatja, hogyan hozhat létre átjárót, amely a kéréseket a tárolóalkalmazásokhoz irányítja.

Eben az oktatóanyagban az alábbiakkal fog megismerkedni:

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha még nincs ilyenje, ingyenesen létrehozhat egyet.
• Azure parancssori felület (CLI).

Megfontolások

Amikor a Gateway for Springben fut az Azure Container Appsben, vegye figyelembe az alábbi részleteket:

Beállítás

Mielőtt elkezdené használni a Spring-átjárót, először létre kell hoznia a szükséges erőforrásokat.

Hajtsa végre az alábbi parancsokat az erőforráscsoport és a Container Apps-környezet létrehozásához.

1. Hozzon létre változókat az alkalmazáskonfiguráció támogatásához. Ezeket az értékeket a lecke céljaira biztosítjuk. Ebben a leckében a rendszergazda aktuátorvégpontját használjuk a spring mintaalkalmazáshoz.

   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"
   

   Változó	Leírás
   LOCATION	Az Azure-régió helye, ahol a tárolóalkalmazást és a Java-összetevőt hozza létre.
   ENVIRONMENT	A bemutató alkalmazás Azure Container Apps-környezetének neve.
   RESOURCE_GROUP	A bemutató alkalmazás Azure-erőforráscsoportjának neve.
   JAVA_COMPONENT_NAME	A tárolóalkalmazáshoz létrehozott Java-összetevő neve. Ebben az esetben létrehoz egy átjárót a Spring Java-összetevőhöz.
   IMAGE	A tárolóalkalmazásban használt tárolórendszerkép.

2. Jelentkezzen be az Azure-ba az Azure CLI-vel.

   az login
   

3. Hozzon létre egy erőforráscsoportot.

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

4. Hozza létre a tárolóalkalmazás-környezetet.

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

   Ez a környezet a Gateway for Spring összetevő és a tárolóalkalmazás üzemeltetésére szolgál.

A Spring Java-átjáró összetevő használata

Most, hogy rendelkezik Container Apps-környezettel, létrehozhat egy átjárót a spring Java-összetevőkhöz a kérések átirányításához.

1. Hozza létre a Spring Java-átjáró összetevőt.

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

2. Hozza létre a teljes tartománynevet (FQDN) tartalmazó tárolóalkalmazást.

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

   Ez a parancs a konfigurációs adatokat használó tárolóalkalmazás URL-címét adja vissza. Másolja az URL-címet egy szövegszerkesztőbe, hogy a következő lépésben használhassa.

Az átjáróútvonalak frissítése a kérések átirányításához

1. Hozzon létre egy YAML-fájlt a következő tartalommal. Cserélje le <MYAPP_URL> a tárolóalkalmazás teljes tartománynevét az előző lépésben.

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

2. Futtassa a következő parancsot a Gateway for Spring összetevőnek az útvonalkonfigurációval való frissítéséhez.

   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
   

   Ez a parancs frissíti az átjáró útvonalát, és visszaadja a konfigurációs adatokat használó átjáró URL-címét.

   A parancs visszaadja az átjáró URL-címét. Ennek az URL-címnek az elérési úttal /myapp/health való felkeresésével a kérésnek az alkalmazás végpontjára kell irányítania actuator/health , és vissza kell térnie {"status":"UP","groups":["liveness","readiness"]}.

Az erőforrások eltávolítása

Az oktatóanyagban létrehozott erőforrások hatással vannak az Azure-számlára. Ha nem fogja hosszú távon használni ezeket a szolgáltatásokat, futtassa a következő parancsot az oktatóanyagban létrehozott összes eltávolításához.

az group delete --resource-group $RESOURCE_GROUP

Útvonalfájl formátuma

A Spring-átjáró összetevő támogatja az útvonalak azonosítóval, URI-val, predikátumokkal és szűrőkkel rendelkező tulajdonságokon keresztüli meghatározását. További információkért tekintse meg a Spring Cloud Gateway dokumentációját. Az alábbi példa YAML-fájl, amely bemutatja, hogyan konfigurálhatja ezeket a tulajdonságokat.

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

A Spring-átjáró engedélyezett konfigurációs listája (#configurable-properties)

Az alábbi táblázat az alkalmazáshoz konfigurálható átjáróösszetevő-tulajdonságokat ismerteti. További információ: Spring Cloud Gateway – Gyakori alkalmazástulajdonságok.

Gyakori konfigurációk

Az alábbi lista a gyakori konfigurációkat ismerteti:

• Naplózással kapcsolatos konfigurációk:
  • logging.level.*
  • logging.group.*
  • A névtérben lévő logging.* egyéb konfigurációknak tilosnak kell lenniük. Például a naplófájlok használatát logging.file tiltani kell.