Ribbon是Netflix公司開源的一個負載均衡組件,將負載均衡邏輯封裝在客戶端中,運行在客戶端的進程裏。html
本例子是在搭建好eureka的基礎上進行的,可參考spring boot 2.0.3+spring cloud (Finchley)一、搭建Eureka 以及構建高可用Eureka Server集羣java
在eureka-client工程中添加一個API接口,來提供服務,新建一個類HiControllergit
@RestController public class HiController { @Value("${server.port}") String port; @GetMapping("/hi") public String Home(@RequestParam String name){ return "hi "+name+",i am from port:"+port; } }
啓動eureka-server,端口8761.啓動兩個eureka-client實例,端口分別爲8762和8763,瀏覽器訪問http://localhost:8761/,顯示兩個實例已成功註冊github
啓動多個實例的方法爲:打開Run|Edit Configurations 選中spring boot下EurekaClientApplication,去掉右邊的勾選項Single instance only。在配置文件中設置不一樣的端口號,分別啓動便可。web
新建一個Module工程eureka-ribbon-client,做爲服務消費者,經過RestTemplate來遠程調用eureka-client服務API接口的"/hi",消費服務。spring
在pom文件中引入相關依賴,包括主maven工程的pom文件,eureka client起步依賴,因爲已經引入了eureka的依賴會自動導入ribbon的起步依賴,web的起步依賴(已在主maven工程pom中配置)apache
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.cralor</groupId> <artifactId>eureka-ribbon-client</artifactId> <version>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>eureka-ribbon-client</name> <description>Demo project for Spring Boot</description> <parent> <groupId>com.cralor</groupId> <artifactId>chap6-3-ribbon</artifactId> <version>0.0.1-SNAPSHOT</version> <relativePath/> <!-- lookup parent from repository --> </parent> <properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding> <java.version>1.8</java.version> </properties> <dependencies> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project>
在配置文件中作相關配置瀏覽器
server: port: 8764 spring: application: name: eureka-ribbon-client eureka: client: serviceUrl: defaultZone: http://localhost:8761/eureka/
啓動類默認便可。緩存
@SpringBootApplication public class EurekaRibbonClientApplication { public static void main(String[] args) { SpringApplication.run(EurekaRibbonClientApplication.class, args); } }
寫一個RESTful API接口,調用eureka-client的API接口「/hi」,即消費服務。因爲eureka-client爲兩個實例(端口876二、8763),在調用時但願作到輪流訪問這兩個實例,這時須要將RestTemplate和Ribbon結合進行負載均衡。只須要在程序的IOC容器中注入一個restTemplate的Bean,並加上@LoadBalanced註解,此時RestTemplate就結合了Ribbon開啓了負載均衡功能。app
@Configuration public class RibbonConfig { @Bean @LoadBalanced RestTemplate restTemplate(){ return new RestTemplate(); } }
編寫一個RibbonService類,在該類的hi()方法用restTemplate調用eureka-client的API接口,uri上不須要使用硬編碼(如IP地址),只需寫服務名eureka-client便可
@Service public class RibbonService { @Autowired RestTemplate restTemplate; public String hi(String name){ return restTemplate.getForObject("http://eureka-client/hi?name="+name,String.class); } }
編寫一個RibbonController類
@RestController public class RibbonController { @Autowired private RibbonService ribbonService; @GetMapping("/hi") public String hi(@RequestParam(required = false,defaultValue = "cralor") String name){ return ribbonService.hi(name); } }
啓動eureka-ribbon-client工程,訪問http://localhost:8761,顯示服務已註冊
在瀏覽器屢次訪問http://localhost:8764/hi?name=cralor,瀏覽器會輪流顯示以下
此時負載均衡器已經起了做用。
LoadBalancerClient 簡介
負載均衡的核心類爲LoadBalancerClient,LoadBalancerClient能夠獲取負載均衡服務提供者的實例信息,在RibbonController中重寫一個接口「/testRibbon」,經過LoadBalancerClient去選擇一個eureka-client的實例
@RestController public class RibbonController { ...//略 @Autowired private LoadBalancerClient loadBalancer; @GetMapping("/testRibbon") public String testRibbon(){ ServiceInstance instance=loadBalancer.choose("eureka-client"); return instance.getHost()+":"+instance.getPort(); } }
重啓工程,屢次訪問http://localhost:8764/testRibbon,瀏覽器會輪流顯示
localhost:8762
localhost:8763
可見LoadBalancerClient的choose("eureka-client")方法能夠輪流獲得eureka-client的兩個實例。
查看官方文檔可知,負載均衡器LoadBalancerClient是從eureka client獲取服務註冊列表信息的,並將該信息緩存了一份,在調用choose()方法時,根據負載均衡策略選擇一個服務實例的信息,從而維護了負載均衡。LoadBalancerClient能夠不從eureka client獲取註冊列表信息,這時須要本身維護一份信息。
新建一個工程ribbon-client,同eureka-ribbon-client相似,在配置文件中經過ribbon. eureka. enabled爲false來禁止調用eureka client獲取註冊列表信息,有一個程序名爲stores的服務,有兩個不一樣Url地址(example.com和google.com)的服務實例,經過stores. ribbon.listOfServers來配置這些服務實例的Url
server: port: 8767 ribbon: eureka: enabled: false stores: ribbon: listOfServers: example.com,google.com
新建一個RestController類
@RestController public class RibbonController { @Autowired private LoadBalancerClient loadBalancer; @GetMapping("/testRibbon") public String testRibbon(){ ServiceInstance instance=loadBalancer.choose("stores"); return instance.getHost()+":"+instance.getPort(); } }
啓動工程,屢次訪問http://localhost:8767/testRibbon,瀏覽器會交替顯示以下內容
如今能夠知道,在Ribbon中的負載均衡客戶端爲LoadBalancerClient 。在spring cloud項目中,負載均衡器Ribbon會默認從Eureka Client 的服務註冊列表中獲取服務的信息,並緩存一份,根據緩存的信息,經過LoadBalancerClient來選擇不一樣的服務實例,從而實現負載均衡,若是禁止Ribbon從Eureka獲取註冊列表信息,則須要本身去維護一份服務註冊列表信息。根據本身維護的信息,Ribbon也能夠實現負載均衡。
案例代碼地址:https://github.com/cralor7/springcloud