Kubernetes 的负载均衡器

本项目包含 Spring Cloud Load Balancer,用于基于 Kubernetes Endpoints 或 Kubernetes Service 进行负载均衡。要将其包含到您的项目中,请添加以下依赖项。Fabric8 实现

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes-fabric8-loadbalancer</artifactId>
</dependency>

Kubernetes Java Client 实现

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-kubernetes-client-loadbalancer</artifactId>
</dependency>

负载均衡器有两种工作“模式”:PODSERVICE,由属性指定(默认为 POD

spring.cloud.kubernetes.loadbalancer.mode=SERVICE

spring.cloud.kubernetes.loadbalancer.mode=POD

POD 模式下,我们将使用 DiscoveryClient 来查找与您的负载均衡器名称匹配的所有服务。例如,如果您有以下配置

@Bean
@LoadBalanced
WebClient.Builder client() {
	return WebClient.builder();
}

并使用该 WebClientservice-a 发出请求,我们将使用 service-a 作为值来调用 DiscoveryClient::getInstances。由于使用了 DiscoveryClient,所有与其相关的配置都将生效,这些配置在文档的相关部分中进行了解释。

另一方面,如果您使用 SERVICE 模式,情况略有不同,但与发现客户端的设置非常相似。例如,为了回答在哪个命名空间中查找名为 service-a 的服务的问题,我们将使用以下设置之一

spring.cloud.kubernetes.discovery.all-namespaces
spring.cloud.kubernetes.discovery.namespaces

以在所有命名空间或所谓的“选择性命名空间”中进行搜索。如果以上均未指定,则 命名空间解析 将生效。

找到所有服务后,我们需要知道使用哪个端口调用它们。如果相关服务定义了单个端口,无论其名称如何,我们都将使用该端口。如果没有定义端口,则该服务将不会被考虑用于负载均衡并会被跳过。

如果定义了多个端口,我们将尝试将其名称与属性值匹配(默认为 http

spring.cloud.kubernetes.loadbalancer.portName

如果找到匹配项,则使用该端口号。否则,将使用列表中的“第一个”端口。后一种选项是非确定性的,必须谨慎使用。

一旦知道端口,我们就知道如何调用该服务了。URL 的形式将是

service-a.<SERVICE_NAMESPACE>.svc.<DOMAIN>:<FOUND_PORT>

<SERVICE_NAMESPACE> 是服务所在的命名空间,DOMAIN 是属性值(默认为 cluster.local

spring.cloud.kubernetes.loadbalancer.clusterDomain

<FOUND_PORT> 是我们在上述过程中选择的服务端口。

如果需要通过 HTTPS 访问服务,则需要明确进行配置。其规则与发现实现的规则完全相同,可在关于 discovery-client 的文档相关部分中找到。