概述

Ribbon是一個客戶端負載均衡器， 它可以讓您對HTTP和TCP客戶端的行為有很大的控制權。

   Feign已經使用Ribbon，所以如果您使用的是@FeignClient， 那麼這個部分也適用。 

     Ribbon中一個重要的概念是named client。

    Spring Cloud使用RibbonClientConfiguration根據需要為每個named client建立一個新的集合作為ApplicationContext，

    這包含（除其他外）ILoadBalancer，RestClient和ServerListFilter。

如何引入ribbon

pom.xml

<dependency>
   <groupId>org.springframework.cloud</groupId>
   <artifactId>spring-cloud-starter-ribbon</artifactId>
</dependency>
 

自定義Ribbon Client

你可以使用<client>.ribbon.*屬性來配置ribbon client。

Spring Cloud還允許你通過使用@RibbonClient宣告其他配置（在RibbonClientConfiguration上）來完全控制客戶端。例：

@RibbonClient(name = "user-server", configuration = RibbonConfig.class)
public class TestConfiguration {
}

在這種情況下，ribbon client由已經在RibbonClientConfiguration中的元件和RibbonConfig

組成。

(備註：使用RibbonClientConfiguration中的Bean和自定義的RibbonConfig中的Bean來配置ribbon client, 

RibbonConfig中的Bean會覆蓋RibbonClientConfiguration中的Bean)

注意： 

上面的RibbonConfig必須用@Configuration，但是注意它不能在應用上下文被@ComponentScan掃描到，

否則它將被所有@RibbonClient所共享。如果你使用@ComponentScan或者@SpringBootApplication,你需要避免它被包括在內

(例如：把它放在一個單獨的，不重疊的包或者在@ComponentScan

(備註：我是在src/main/java下新建一個package,將自定義的RibbonConfiguration配置Bean放在這個包下)

Spring Cloud Netflix預設給ribbon提供以下的bean(BeanType beanName: ClassName):

• IClientConfig ribbonClientConfig: DefaultClientConfigImpl
• IRule ribbonRule: ZoneAvoidanceRule
• IPing ribbonPing: NoOpPing
• ServerList<Server> ribbonServerList: ConfigurationBasedServerList
• ServerListFilter<Server> ribbonServerListFilter: ZonePreferenceServerListFilter
• ILoadBalancer ribbonLoadBalancer: ZoneAwareLoadBalancer
• ServerListUpdater ribbonServerListUpdater: PollingServerListUpdater

建立這些型別的bean並將其放置在@RibbonClient配置Bean（例如上面的RibbonConfig）中，可以覆蓋所描述的每個bean。例：

@Configuration
public class RibbonConfig {

    @Bean
    public IPing ribbonPing(){
        return new PingUrl();
    }
}

這將用PingUrl代替NoOpPing。

使用properties來自定義Ribbon Client

Spring Cloud Netflix現在支援使用properties來定製Ribbon client，以便與Ribbon文件相容。

這使你可以在不同的環境啟動時更改行為。

支援的屬性如下所列，並應以<clientName>.ribbon為字首：

• NFLoadBalancerClassName: should implement ILoadBalancer
• NFLoadBalancerRuleClassName: should implement IRule
• NFLoadBalancerPingClassName: should implement IPing
• NIWSServerListClassName: should implement ServerList
• NIWSServerListFilterClassName: should implement ServerListFilter

提示： 在這些屬性中定義的類優先於使用@RibbonClient(configuration=MyRibbonConfig.class)

定義的bean和Spring Cloud Netflix提供的預設類。

要為一個名為user-server的服務設定IRule，可以如下設定：

user-server:
  ribbon:
    NFLoadBalancerRuleClassName: com.netflix.loadbalancer.WeightedResponseTimeRule

Ribbon和Eureka一起使用

當Eureka和Ribbon一起使用(例如，二者都在classpath), ribbonServerList被DiscoveryEnabledNIWSServerList的一個擴充套件覆蓋了，

該擴充套件的server list來自於Eureka。

同時用NIWSDiscoveryPing替代IPing,通過Eureka來判斷服務狀態是否為UP。

預設安裝的ServerList是一個DomainExtractingServerList，

這樣做的目的是在不使用AWS AMI metadata(這是Netflix所依賴的)的情況下為負載均衡器提供物理metadata。

預設情況下，server list將使用例項metadata中提供的“zone”資訊構建（所以在遠端客戶端上設定eureka.instance.metadataMap.zone）,如果沒有設定zone，可以使用伺服器hostname的域名作為zone的代理（如果設定了標誌approximateZoneFromHostname）。

一旦zone資訊可用，就可以在ServerListFilter中使用。

預設情況下，它將用於定位與client位於同一個zone的server，因為預設值是ZonePreferenceServerListFilter。

預設地client的zone的確定方式與遠端例項相同，即通過eureka.instance.metadataMap.zone。

提示：

 如果沒有設定zone資料，則根據client配置（而不是例項配置）進行猜測。

我們把eureka.client.availabilityZones(這是一個從region名稱到zone列表的map)，

並取出例項所在region的第一個zone（即eureka.client.region，預設為“us-east-1“，為了與本地Netflix的相容性）。

Ribbon不和Eureka一起使用

Eureka是一個遠端服務發現的一個簡便實現，所以你不需要在client端硬編碼url，

但是如果你不喜歡使用eureka，Ribbon和Feign仍然很合適。假設你已經為“stores”聲明瞭@RibbonClient, 並且沒有使用eureka。

Ribbon client預設使用一個配置的server list,你可以像這樣提供配置：

application.yml

user-server:
  ribbon:
    listOfServers: xphsc:8002

在Ribbon中禁用Eureka

設定屬性ribbon.eureka.enabled = false將明確禁止在Ribbon中使用Eureka。

application.yml

ribbon:
  eureka:
   enabled: false

直接使用Ribbon API

你可以直接使用LoadBalancerClient，例如：

@RestController
public class UserLoadBalancerController {
    @Autowired
    private LoadBalancerClient loadBalancer;

    @GetMapping("/getloadBalancer")
    public Object getloadBalancer() {
        ServiceInstance instance = loadBalancer.choose("user-server");
              URI userUri = URI.create(String.format("http://%s:%s", instance.getHost(), instance.getPort()));
              // 列印當前選擇的是哪點節點
              System.out.println("列印當前選擇的是哪點節點:{}"+userUri);
              // ... do something with the URI
              return userUri;
    }

}

Ribbon的快取配置

每個named client的Ribbon都有一個Spring Cloud維護的對應子應用程式上下文,這個應用程式的上下文是當對named client第一次請求時懶載入的。可以將此延遲載入行為更改為在啟動時立即載入這些子應用程式上下文，通過指定Ribbon client的名稱來配置。

application.yml

ribbon:
  eager-load:
    enabled: true
    clients: client1, client2, client3