教程：在 Azure 容器应用中连接到托管 Eureka Server for Spring

Eureka Server for Spring 是一种服务注册表，允许微服务自行注册和发现其他服务。 Eureka Server for Spring 可用作 Azure 容器应用组件。 可以将容器应用绑定到 Eureka Server for Spring，以便自动注册到 Eureka Server。

本教程介绍如何执行下列操作：

先决条件

• 具有活动订阅的 Azure 帐户。 如果你没有，可以免费创建一个。
• Azure CLI。

注意事项

在容器应用中运行 Eureka Server for Spring 时，请注意以下详细信息：

安装

在开始使用 Eureka Server for Spring 组件之前，首先需要创建所需的资源。

创建适用于 Spring 的 Eureka 服务器 Java 组件

将容器应用绑定到适用于 Spring 的 Eureka 服务器 Java 组件

在门户中返回到容器应用。 将你的应用的 URL 复制到文本编辑器，以便在下一步中使用。

转至 /allRegistrationStatus 路由，查看注册到 Eureka Server for Spring 组件的所有应用程序。

绑定将多个配置以环境变量的形式注入应用程序，这些配置主要是 eureka.client.service-url.defaultZone 属性。 此属性指示 Eureka Server Java 组件的内部终结点。

绑定还会注入以下属性：

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

eureka.client.register-with-eureka 属性设置为 true 以强制注册到 Eureka Server。 此注册会覆盖 application.properties 中来自配置服务器等的本地设置。 如果要将其设置为 false，可以通过在容器应用中设置环境变量来覆盖它。

由于容器应用环境中的特定域名系统解析规则，eureka.instance.prefer-ip-address 属性被设置为 true。 不要修改此值，以免破坏绑定。

可选：从 Eureka Server for Spring Java 组件取消绑定容器应用

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

通过仪表板查看应用程序

1. 创建自定义角色定义。

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

   请务必将 AssignableScopes 值中的 <SUBSCRIPTION_ID> 占位符替换为你的订阅 ID。

2. 将自定义角色分配给托管环境资源上的帐户。

   获取托管环境的资源 ID：

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

3. 将角色分配给帐户。

   运行此命令之前，请将 <> 括号指示的占位符替换为用户或服务主体 ID 以及角色名称。

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

   注意

   <USER_OR_SERVICE_PRINCIPAL_ID> 值通常是用于访问 Azure 门户的标识。 <ROLE_NAME> 值是在第 1 步中分配的名称。

4. 获取适用于 Spring 的 Eureka 服务器仪表板的 URL。

   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
   

   此命令会返回可用来访问 Eureka Server for Spring 仪表板的 URL。 使用该仪表板，还可查看容器应用，如以下屏幕截图所示。

   

可选：将适用于 Spring 的 Eureka 服务器和适用于 Spring 的控制台 Java 组件集成

若要将适用于 Spring 的 Eureka 服务器与适用于 Spring 的控制台 Java 组件集成，请参阅将适用于 Spring 的管理控制台与适用于 Spring 的 Eureka 服务器集成。

清理资源

本教程中创建的资源会影响 Azure 帐单。 如果不打算长期使用这些服务，请运行以下命令来删除你在本教程中创建的所有内容。

az group delete --resource-group $RESOURCE_GROUP

Eureka Server for Spring 的允许配置列表

以下各部分描述了支持的配置。 有关详细信息，请参阅 Spring Cloud Eureka 服务器。

配置选项

az containerapp update命令使用--configuration参数控制 Eureka Server for Spring 的配置方式。 只要多个参数被空格分隔，就可以一次性使用它们。 有关详细信息，请参阅 Spring Cloud Eureka 服务器。

eureka.server 配置属性上提供了以下配置设置：

常见配置

• 日志记录相关配置：
  • logging.level.*
  • logging.group.*
  • 应禁止使用 logging.* 命名空间下的任何其他配置，例如，应禁止使用 logging.file 写入日志文件。

应用程序之间的调用

此示例演示如何编写 Java 代码，以便在使用 Eureka Server for Spring 组件注册的应用程序之间进行调用。 当容器应用与 Eureka 绑定时，它们通过 Eureka 服务器相互通信。

该示例创建两个应用程序，即调用方和被调用方。 两个应用程序都使用 Eureka Server for Spring 组件相互通信。 被调用方应用程序公开由调用方应用程序调用的终结点。

1. 创建被调用方应用程序。 将@EnableDiscoveryClient注释添加到主类，以在 Spring Boot 应用程序中启用 Eureka 客户端。

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

2. 在被调用方应用程序调用的被调用方应用程序中创建终结点。

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

3. 在应用程序配置文件中设置被调用方应用程序的名称，例如，在 application.yml 中。

   spring.application.name=callee
   

4. 创建调用方应用程序。

   添加@EnableDiscoveryClient注释以启用 Eureka 客户端功能。 此外，使用@LoadBalanced注释创建WebClient.Builder豆，以执行对其他服务的负载均衡调用。

   @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. 在调用方应用程序中创建控制器，该控制器使用WebClient.Builder通过其应用程序名称被调用方调用方应用程序。

   @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);
       }
   }
   

现在，你有一个使用 Eureka Server for Spring Java 组件相互通信的调用方和被调用方应用程序。 在调用方应用程序中测试/call-callee终结点之前，请确保这两个应用程序都在运行并绑定到 Eureka 服务器。

限制

Eureka Server Java 组件附带默认配置，eureka.server.enable-self-preservation设置为false。 此默认配置有助于避免启用自保存后未删除实例的时间。 如果实例太早删除，则一些请求可能会定向到不存在的实例。 如果要将此设置更改为true，可以在 Java 组件中设置自己的配置以覆盖此设置。

后续步骤

相关内容

教程：将适用于 Spring 的管理控制台与适用于 Spring 的 Eureka 服务器集成