Csatlakozás felügyelt Eureka Server for Springhez az Azure Container Appsben

Az Eureka Server for Spring egy szolgáltatásregisztrációs adatbázis, amellyel a mikroszolgáltatások regisztrálhatják magukat, és felfedezhetnek más szolgáltatásokat. Az Eureka Server for Spring Azure Container Apps-összetevőként érhető el. A tárolóalkalmazást az Eureka Server for Springhez kötheti az Eureka-kiszolgálóval való automatikus regisztrációhoz.

Ebben 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

Az Eureka Server for Spring tárolóalkalmazásokban való futtatásakor vegye figyelembe a következő részleteket:

Beállítás

Mielőtt elkezdené használni az Eureka Server for Spring összetevőt, először létre kell hoznia a szükséges erőforrásokat.

Az Eureka Server for Spring Java összetevő létrehozása

A tárolóalkalmazás kötése az Eureka Server for Spring Java összetevőhöz

Térjen vissza a tárolóalkalmazáshoz a portálon. Másolja az alkalmazás URL-címét egy szövegszerkesztőbe, hogy egy közelgő lépésben használhassa.

Lépjen az útvonalra az /allRegistrationStatus Eureka Server for Spring összetevőben regisztrált összes alkalmazás megtekintéséhez.

A kötés számos konfigurációt injektál az alkalmazásba környezeti változókként, elsősorban a eureka.client.service-url.defaultZone tulajdonságként. Ez a tulajdonság az Eureka Server Java-összetevő belső végpontját jelzi.

A kötés a következő tulajdonságokat is injektálja:

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

A eureka.client.register-with-eureka tulajdonság úgy van beállítva, hogy true kényszerítse a regisztrációt az Eureka-kiszolgálón. Ez a regisztráció felülírja a helyi beállítást application.propertiesa konfigurációs kiszolgálóról stb. Ha ezt szeretné beállítani false, felülírhatja egy környezeti változó beállításával a tárolóalkalmazásban.

A eureka.instance.prefer-ip-address tulajdonság a tárolóalkalmazás-környezet adott tartománynévrendszer-feloldási szabálya miatt van beállítva true . Ne módosítsa ezt az értéket, hogy ne szegje meg a kötést.

Nem kötelező: A tárolóalkalmazás leválasztása az Eureka Server for Spring Java összetevőről

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

Az alkalmazás megtekintése irányítópulton keresztül

1. Egyéni szerepkördefiníció létrehozása.

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

   Mindenképpen cserélje le az <SUBSCRIPTION_ID> érték helyőrzőjének helyét az AssignableScopes előfizetés-azonosítóra.

2. Rendelje hozzá az egyéni szerepkört a fiókjához egy felügyelt környezeti erőforráson.

   A felügyelt környezet erőforrás-azonosítójának lekérése:

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

3. Rendelje hozzá a szerepkört a fiókjához.

   A parancs futtatása előtt cserélje le a helyőrzőket – szögletes <> zárójelek jelzik – a felhasználó vagy szolgáltatásnév azonosítójára és a szerepkör nevére.

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

   Feljegyzés

   Az <USER_OR_SERVICE_PRINCIPAL_ID> értéknek általában az az identitásnak kell lennie, amelyet az Azure Portal eléréséhez használ. Az <ROLE_NAME> érték az 1. lépésben hozzárendelt név.

4. Kérje le az Eureka Server for Spring-irányítópult URL-címét.

   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
   

   Ez a parancs az Eureka Server for Spring irányítópult eléréséhez használható URL-címet adja vissza. Az irányítópulton a tárolóalkalmazás is látható, ahogy az alábbi képernyőképen is látható.

   

Nem kötelező: Az Eureka Server for Spring és a Admin for Spring Java összetevőinek integrálása

Ha integrálni szeretné az Eureka Server for Spring-kiszolgálót és a Spring Java-összetevők rendszergazdáit, olvassa el a Spring felügyelt rendszergazdájának integrálása az Eureka Server for Spring szolgáltatással című témakört.

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 az alábbi parancsot az oktatóanyagban létrehozott összes eltávolításához.

az group delete --resource-group $RESOURCE_GROUP

Az Eureka Server for Spring engedélyezett konfigurációs listája

A következő szakaszok a támogatott konfigurációkat ismertetik. További információ: Spring Cloud Eureka Server.

Konfigurációs lehetőségek

A az containerapp update parancs a --configuration paraméterrel szabályozza az Eureka Server for Spring konfigurálását. Egyszerre több paramétert is használhat, ha szóköz választja el őket egymástól. További információ: Spring Cloud Eureka Server.

A konfigurációs tulajdonságban a eureka.server következő konfigurációs beállítások érhetők el:

Gyakori konfigurációk

• 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 írását a használatával logging.file tiltani kell.

Alkalmazások közötti hívás

Ez a példa bemutatja, hogyan írhat Java-kódot az Eureka Server for Spring összetevőben regisztrált alkalmazások közötti híváshoz. Ha a tárolóalkalmazások az Eureka-hoz vannak kötve, az Eureka-kiszolgálón keresztül kommunikálnak egymással.

A példa két alkalmazást hoz létre, egy hívót és egy hívót. Mindkét alkalmazás az Eureka Server for Spring összetevő használatával kommunikál egymással. A hívó alkalmazás egy olyan végpontot tesz elérhetővé, amelyet a hívó alkalmazás hív meg.

1. Hozza létre a hívó alkalmazást. Engedélyezze az Eureka-ügyfelet a Spring Boot-alkalmazásban úgy, hogy hozzáadja a @EnableDiscoveryClient jegyzetet a főosztályhoz.

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

2. Hozzon létre egy végpontot a hívó alkalmazás által hívott híváskezelő alkalmazásban.

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

3. Állítsa be a hívó alkalmazás nevét az alkalmazáskonfigurációs fájlban – például application.yml.

   spring.application.name=callee
   

4. Hozza létre a hívó alkalmazást.

   Adja hozzá a @EnableDiscoveryClient széljegyzetet az Eureka ügyfélfunkcióinak engedélyezéséhez. Emellett hozzon létre egy WebClient.Builder babot a @LoadBalanced széljegyzetekkel, hogy terheléselosztásos hívásokat hajthasson végre más szolgáltatások felé.

   @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. Hozzon létre egy vezérlőt a hívó alkalmazásban, amely a WebClient.Builder hívó alkalmazás meghívására használja annak alkalmazásnevét( 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);
       }
   }
   

Most már rendelkezik egy hívó és hívó alkalmazással, amely az Eureka Server for Spring Java-összetevők használatával kommunikál egymással. Mielőtt tesztelni kezdené a végpontot a /call-callee hívó alkalmazásban, győződjön meg arról, hogy mindkét alkalmazás fut és kapcsolódik az Eureka-kiszolgálóhoz.

Korlátozások

• Az Eureka Server Java-összetevő alapértelmezett konfigurációval rendelkezik, eureka.server.enable-self-preservationamely a következőre falsevan állítva: . Ez az alapértelmezett konfiguráció segít elkerülni azokat az időket, amikor a példányok nem törlődnek az önmegőrzés engedélyezése után. Ha a példányok túl korán törlődnek, előfordulhat, hogy egyes kérések nem létező példányokra irányulnak. Ha módosítani szeretné ezt a beállítást true, felülírhatja azt a Java-összetevő saját konfigurációinak beállításával.
• Az Eureka-irányítópult nem érhető el az Azure China 21Vianetben.

Következő lépések

Kapcsolódó tartalom

A Spring felügyelt rendszergazdájának integrálása az Eureka Server for Spring szolgáltatással