From 1c91d778fca86dbd1e80d6d56e8b3d6dec17a4d9 Mon Sep 17 00:00:00 2001
From: star <1563232784@qq.com>
Date: Sun, 8 Aug 2021 16:51:47 +0800
Subject: [PATCH] Nginx
---
.../SpringCloud.md" | 696 +++++++++++++++++-
.../img/Snipaste_2021-07-31_23-47-10.png" | Bin 0 -> 50302 bytes
.../img/Snipaste_2021-08-01_01-41-01.png" | Bin 0 -> 27300 bytes
.../img/Snipaste_2021-08-01_18-40-53.png" | Bin 0 -> 39389 bytes
.../img/wwianshen.jpg" | Bin 0 -> 24065 bytes
.../1183448-20180210145226654-1347579045.png" | Bin 0 -> 23345 bytes
...\234\215\345\212\241\345\231\250-Nginx.md" | 462 +++++++++---
.../Jenkins.md" | 4 -
8 files changed, 1041 insertions(+), 121 deletions(-)
create mode 100644 "notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/Snipaste_2021-07-31_23-47-10.png"
create mode 100644 "notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/Snipaste_2021-08-01_01-41-01.png"
create mode 100644 "notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/Snipaste_2021-08-01_18-40-53.png"
create mode 100644 "notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/wwianshen.jpg"
create mode 100644 "notes/\344\270\255\351\227\264\344\273\266/Web\345\272\224\347\224\250\346\234\215\345\212\241\345\231\250/Image/1183448-20180210145226654-1347579045.png"
diff --git "a/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/SpringCloud.md" "b/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/SpringCloud.md"
index 7e5ba87..9ef21f3 100644
--- "a/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/SpringCloud.md"
+++ "b/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/SpringCloud.md"
@@ -6,13 +6,705 @@
#### 1.微服务概述
+在过去，企业的应用程序一般以传统的单体应用为主，随着互联网的不断发展，单体应用逐渐出现了下面的问题：
+
+1. 系统间（例如：订单系统、库存系统）通常以 API 的形式互相访问，耦合紧密导致难以维护；
+2. 各业务领域需要采用相同的技术栈，难以快速应用新技术；
+3. 对系统的任何修改都必须整个系统一起重新部署/升级，系统更新成本高；
+4. 在系统负载增加时，难以进行水平扩展；
+5. 当系统中一处出现问题，可能会影响到整个系统；
+
+这些原因导致了微服务架构风格的出现。
+
+
+
什么是微服务？
+微服务的概念最早由来自于英格兰的 Martin Fowler 提出，它是一种 "**架构模式**"，原博文地址：https://martinfowler.com/articles/microservices.html。它提倡将单⼀应⽤程序划分成⼀组⼩的服务，每个服务运⾏在自己独⽴的进程中，甚至不同服务还可以使用不同的语言进行开发；服务之间采用轻量级的通信机制（RESTful API）互相协调、互相配合，为⽤户提供最终价值。
+
+> :oncoming_taxi: 通俗地讲，微服务化就是将传统的一站式应用 根据业务拆分 成一个一个的服务，彻底地去耦合。每一个微服务只做一件事，能够单独地启动或销毁，并且拥有自己独立的数据库。
+
+
+
+微服务的优点：
+
+1. **单一职责**：每个微服务足够内聚，足够小，只聚焦一个指定的业务功能，开发简单。
+2. **松耦合**：一个微服务就是一个独立的实体，它可以独立地进行开发、部署、升级和扩展。
+
+微服务的缺点：
+
+1. **技术栈复杂**：微服务间通过 REST、RPC 等形式交互，需要考虑被调用方故障、过载、消息丢失等各种异常情况，代码逻辑更加复杂；同时，微服务的事务机制也更加复杂。
+2. **运维复杂**：运行多个独立的微服务使运维的难度增加，需要运维人员对各个微服务的运行状态进行监控，运维压力增大。
+
+
+
+---
+
+#### 2.SpringCloud
+
+作为一种流行的架构思想，微服务诞生了很多的落地实现，其中 Dubbo 和 SpringCloud 最为流行。
+
+Dubbo 和 SpringCloud 的区别：
+
+1. Dubbo 主要是提供服务通信与微服务治理两大关键能力，还需要结合其他组件进行使用（如：Zookeeper 等）；而 SpringCloud 是一整套的微服务架构解决方案。
+
+2. 服务调用方式：Dubbo 使用 RPC 方式进行远程调用，而 SpringCloud 使用 RESTful API 进行远程调用。
+
+ > RPC（Remote Procedure Call）：远程过程调用，就是像调用本地方法一样调用远程方法，即通过接口进行远程调用，耦合性较强，但性能较好。
+ >
+ > RESTful API：即 HTTP 调用，不用关心接口实现细节，耦合性较低，但性能不如 RPC 高。
+
+Dubbo 和 SpringCloud 如何抉择：
+
+1. RPC 适用于内网服务调用，对外提供服务需要使用 RESTful API。
+2. RPC 适用于服务调用密集与复杂的系统（如大型电商系统），如果服务频次较低则使用 RESTful API。
+
+> :card_index: 目前，阿里巴巴开源中间件与 SpringCloud 体系进行融合诞生了 **SpringCloud Alibaba**，一个以 Dubbo 的 RPC 调用为基础的微服务一站式解决方案。
+
+
+
+SpringCloud 微服务技术实现：
+
+| 微服务技术栈 | SpringCloud 技术实现 |
+| ------------------------------------------------------------ | --------------------------------------- |
+| 服务注册与发现 | Netflix Eureka |
+| 服务调用 | Rest、Feign(接口化调用) |
+| 服务熔断 | Hystrix |
+| 云端负载均衡 | Ribbon、Feign |
+| 配置中心 | Spring Cloud Config(小规模场景)、Apollo |
+| 数据流处理（封装了 Redis、Rabbit、Kafka 等数据流操作） | Spring Cloud Stream |
+| 服务路由（提供动态路由，监控，弹性，安全等边缘服务） | Zuul、Spring Cloud Gateway(新) |
+| 服务监控 | Turbine |
+| 事件、消息总线（用于在集群中传播事件，如：配置文件发生改变等） | Spring Cloud Bus |
+| 安全工具包 | Spring Cloud OAuth2 |
+
+
+
+> :bullettrain_side: SpringCloud 官网：https://spring.io/cloud
+>
+> :blue_car: SpringCloud 中文网：https://www.springcloud.io
+
+
+
+---
+
+#### 3.SpringCloud 项目搭建
+
+SpringCloud 的总体架构就是一个父 Project 带着多个 Module 子模块，每个子模块就是一个微服务；
+
+父 Project 主要用来管理整个微服务项目的 jar 包，它定义一个父工程的 POM 文件，用来聚合工程和管理依赖。
+
+> SpringCloud 各种实例代码：https://github.com/spring-cloud-samples/
+
+
+
+1. 使用 Spring Initialzr 构建一个空的 Maven 父工程，打包方式选择 pom，完整 pom.xml 文件如下：
+
+ ~~~xml
+
+
+ 4.0.0
+ com.star
+ cloud
+ 0.0.1-SNAPSHOT
+ cloud
+ Demo project for Spring Cloud
+ pom
+
+
+ 1.8
+ 2020.0.3
+ 2.5.3
+
+
+
+
+
+ org.springframework.cloud
+ spring-cloud-dependencies
+ ${spring-cloud.version}
+ pom
+ import
+
+
+ org.springframework.boot
+ spring-boot-dependencies
+ ${spring-boot.version}
+ pom
+ import
+
+
+
+
+ ~~~
+
+ 使用 dependencyManagement 节点来管理子模块的 SpringBoot 版本和 SpringCloud 版本。
+
+
+
+2. 创建公共 API 模块，用来保存都会用到的公共组件（如：统一返回类 Result、工具类、及其他组件）：
+
+ 在父项目上右键添加 Module，创建 Maven 子模块，在 pom.xml 中添加常用的功能（如：lombok、hutool 等）。
+
+ ~~~xml
+
+
+ cn.hutool
+ hutool-all
+ 5.7.6
+
+
+ org.projectlombok
+ lombok
+
+ false
+
+
+ ~~~
+
+ 创建好公共 API 模块后，再创建一个 Dept 实体类供后续使用（注意：微服务中实体类需要实现 Serializable 接口）。
+
+
+
+3. 创建服务提供者 cloud-provider：
+
+ 在父项目上使用 Spring Initialzr 创建子模块，勾选需要的功能（如：web，MySQL、MyBatis、Druid 等）。
+
+ 修改子模块的 parent 并且在父工程的 modules 标签中添加此模块。
+
+ 进行 application.properties 配置（端口、数据库、连接池、MyBatis 等），配置如下：
+
+ ~~~properties
+ # 服务端口号
+ server.port=8001
+ # 服务名称，部署至 Eureka 时需要用到
+ spring.application.name=cloud-provider
+ # 数据库连接信息
+ spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
+ spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
+ spring.datasource.url=jdbc:mysql://192.168.253.128:3306/cloud?serverTimezone=UTC
+ spring.datasource.username=root
+ spring.datasource.password=TinyStar0920
+ # MyBatis 配置信息
+ mybatis.mapper-locations=classpath:mapper/**
+ mybatis.configuration.map-underscore-to-camel-case=true
+ #热部署生效
+ spring.devtools.restart.enabled=true
+ #设置重启的目录
+ spring.devtools.restart.additional-paths=src/main/java
+ ~~~
+
+ 配置完成后，创建相应的数据库、controller、service、mapper 并进行初步测试。
+
+
+
+4. 创建服务消费者模块 cloud-consumer：
+
+ 在父项目上使用 Spring Initialzr 创建子模块，并勾选 web 功能。
+
+ 修改子模块的 parent 并且在父工程的 modules 标签中添加此模块。
+
+ 进行 application.properties 配置（端口、数据库、连接池、MyBatis 等），配置如下：
+
+ ~~~properties
+ # 服务端口号
+ server.port=9001
+ # 服务名称，部署至 Eureka 时需要用到
+ spring.application.name=cloud-consumer
+ ~~~
+
+ 向容器中注入一个 **RestTemplate**：
+
+ ~~~java
+ @Configuration
+ public class BeanConfig {
+ @Bean
+ public RestTemplate restTemplate() {
+ return new RestTemplate();
+ }
+ }
+ ~~~
+
+ > :rescue_worker_helmet: RestTemplate 提供了多种便捷访问远程 Http 服务的方法，它是一种简单便捷的访问 restful 服务的模板类。是 Spring 封装的用于访问 Rest 服务的客户端模板工具。
+
+ 编写 Controller，通过 RestTemplate 从 cloud-provider 获取 Dept 信息：
+
+ ~~~java
+ @RestController
+ @RequestMapping("/dept")
+ public class DeptConsumerController {
+
+ private static final String REST_URL_PREFIX = "http://localhost:8001";
+
+ @Autowired
+ private RestTemplate restTemplate;
+
+ @GetMapping("/{id}")
+ public Dept getDeptById(@PathVariable int id) {
+ return restTemplate.getForObject(REST_URL_PREFIX + "/dept/" + id, Dept.class);
+ }
+ }
+ ~~~
+
+ 搭建完成后，在 cloud-consumer 发起请求，如果能接收到 cloud-provider 提供的正确查询结果，则项目初步搭建成功。
+
+
+
+---
+
+#### 4.Eureka 服务注册与发现
+
+Eureka 是 Netflix 的一个子模块，也是核心模块之一。它基于 REST 服务来注册和发现服务，以实现云端中间层服务发现和故障转移。
+
+系统启动时，服务提供方将自身服务注册到 Eureka，而服务消费方从 Eureka 获取注册的服务列表，从而消费服务。
+
+
+
+Eureka 包含了 EurekaServer 和 EurekaClient 两个组件，它们的运行逻辑如下：
+
+- Eureka 采用了 C-S 的设计架构。EurekaServer 作为服务注册功能的服务器，它是服务注册中心。
+- 系统中的其他微服务，使用 Eureka 的客户端连接到 EurekaServer 并维持心跳连接。
+
+> :tophat: 通过 EurekaServer 和 EurekaClient 的连接，系统的维护人员就可以通过 EurekaServer 来监控系统中各个微服务是否正常运行。系统中的其他一些模块（如：Zuul）也可以通过 EurekaServer 来发现系统中的其他微服务，并执行相关的逻辑。
+>
+> :horse_racing: EurekaClient 具备一个内置的、使用轮询负载算法的负载均衡器，它在应用启动后将会向 EurekaServer 发送心跳（默认周期为 30 秒），如果EurekaServer 在多个心跳周期内没有接收到某个节点的心跳，EurekaServer 将会从服务注册表中把这个节点移除（默认 90 秒）。
+
+
+
+搭建 Eureka 服务注册中心：
+
+1. 搭建 EurekaServer：
+
+ 在父项目上使用 Spring Initialzr 创建子模块，并勾选 Eureka Server、web 功能。
+
+ 修改子模块的 parent 并且在父工程的 modules 标签中添加此模块。
+
+ 配置 eureka-server 的 application.properties 文件：
+
+ ~~~properties
+ # Eureka Server 端口
+ server.port=7001
+ # Eureka Server 实例名称
+ spring.application.name=eureka-server
+ # 单机版本时，由于本服务就是服务注册中心，所以不向服务注册中心注册自己
+ eureka.client.register-with-eureka=false
+ # 单机版本时，本服务就是服务注册中心，不需要向服务注册中心获取服务列表
+ eureka.client.fetch-registry=false
+ # Eureka Server 启动后会不断地与服务中心进行连接，所以需要指明服务注册中心地址(本服务)，否则将一直打印日志错误(不影响服务)
+ eureka.client.service-url.defaultZone=http://localhost:${server.port}/eureka
+ ~~~
+
+ 主启动类上标注注解：**@EnableEurekaServer**
+
+ ~~~java
+@EnableEurekaServer
+ @SpringBootApplication
+public class EurekaServerApplication {
+ public static void main(String[] args) {
+ SpringApplication.run(EurekaServerApplication.class, args);
+ }
+ }
+ ~~~
+
+ 启动项目后，访问 http://localhost:7001/ 将会看到 Eureka 服务注册中心。
+
+ 
+
+2. 将 cloud-provider 注册到 EurekaServer 中：
+
+ 向 cloud-provider 的 pom.xml 中添加依赖：
+
+ ~~~xml
+
+ org.springframework.cloud
+ spring-cloud-starter-netflix-eureka-client
+
+ ~~~
+
+ 在 cloud-provider 中加入 Eureka Client 配置：
+
+ ~~~properties
+ # 将此服务注册到 Eureka Server 中
+ eureka.client.service-url.defaultZone=http://localhost:7001/eureka
+ ~~~
+
+ 在主启动类上标注注解：**@EnableEurekaClient**。
+
+ 先启动 eureka-server，再启动 cloud-provider 即可在配置中心的服务列表上查看到 cloud-provider 服务。
+
+ 
+
+
+
+
+
+
+
+服务注册完善：
+
+1. 默认服务名称的修改（服务列表中 Status 栏下面的名称）：
+
+ ```properties
+ # 服务实例名称，将会展示到 Eureka Server 的服务列表
+ eureka.instance.instance-id=cloud-provider-8001
+ ```
+
+2. 在服务列表的链接 hover 中显示具体的 IP 地址：
+
+ ```properties
+ # 在 Eureka Server 的服务列表中的名称 hover 时显示具体的 IP 地址
+ eureka.instance.prefer-ip-address=true
+ ```
+
+3. 服务注册信息完善（点击服务列表的超链接即可跳转显示）：
+
+ 添加 spring-boot-starter-actuator 依赖（用于监控服务以及管理服务信息）。
+
+ ~~~xml
+
+ org.springframework.boot
+ spring-boot-starter-actuator
+
+ ~~~
+
+ 在 cloud-provider 暴露 actuator 接口，配置服务信息：
+
+ ~~~properties
+ # 暴露 actuator 监控的接口
+ management.endpoints.web.exposure.include=health,info
+ # 添加此微服务的详细信息
+ info.app-name=cloud-provider
+ ~~~
+
+ 重启后，在点击服务列表中的超链接，即可看到配置文件中配置的服务信息。
+
+
+
+> :european_castle: Eureka 自我保护机制:
+>
+> 默认情况下，如果 EurekaServer 在一定时间内没有接收到某个微服务实例的心跳，EurekaServer 将会注销该实例（默认90秒）。但是当网络分区故障发生时，在短时间内 EurekaServer 可能会丢失过多客户端，此时 Eureka 将会开启 "自我保护模式"。
+>
+> 进入自我保护模式后，EurekaServer 就会保护服务注册表中的信息，不再删除服务注册表中的数据（也就是不会注销任何微服务）。
+>
+> 当 EurekaServer 收到的心跳数重新恢复到阈值以上时会自动退出自我保护模式。
+>
+> 在 SpringCloud 中，可以配置 eureka.server.enable-self-preservation=false 来禁用自我保护模式（不推荐）。
+
+
+
+在代码中如何获取注册中心的服务列表？
+
+当主启动类上标注了注解 **@EnableEurekaClient** 时，此服务即可被其他服务所发现。同时 SpringCloud 支持在代码中获取服务注册中心的服务列表：
+
+~~~java
+@Autowired
+private EurekaDiscoveryClient discoveryClient;
+
+@GetMapping("/discovery")
+public List getDiscovery() {
+ List services = discoveryClient.getServices();
+ return services.stream()
+ .map(service -> discoveryClient.getInstances(service))
+ .flatMap(Collection::stream)
+ .collect(Collectors.toList());
+}
+~~~
+
+在 SpringCloud 中，通过 EurekaDiscoveryClient 组件对 "服务发现" 相关业务进行操作。
+
+
+
+> :currency_exchange: Eureka 服务器没有后端存储，但注册中心中的服务实例都必须发送心跳以保持其注册最新。
+>
+> Eureka 客户端也有一个 Eureka 注册的内存缓存（因此他们不必为每个服务请求都去注册中心）。
+
+
+
+---
+
+#### 5.Eureka 集群配置
+
+为了保证注册中心的高可用，往往需要搭建 Eureka 集群进行使用。
+
+
+
+Eureka 集群搭建：
+
+1. 复制 application.properties 文件配置不同的 3 个节点。
+
+ application-node-1.properties、application-node-2.properties、application-node-3.properties
+
+2. 修改 application-node-1.properties 文件内容：
+
+ ```properties
+ # Eureka Server 端口
+ server.port=7001
+ # Eureka Server 实例名称
+ spring.application.name=eureka-server-1
+ # Eureka Server 实例 IP 地址
+ eureka.instance.hostname=eureka-01
+ # 配置 Eureka Server 集群中的其他 Server
+ eureka.client.service-url.defaultZone=http://eureka-02:7002/eureka,http://eureka-03:7003/eureka
+ ```
+
+ > 一般来说，在搭建 Eureka 集群时，**hostname** 和 **defaultZone** 都直接写 IP 地址，如：
+ >
+ > `eureka.instance.hostname=192.168.253.127`、`eureka.client.service-url.defaultZone=http://192.168.253.128:7001/eureka`
+ >
+ > 集群中每一个 hostname 都不一样（集群搭建在不同的服务器上）。
+ >
+ > 但是在搭建单机集群时（集群搭建在一个服务器上），由于 Eureka 集群是通过 hostname 来区分彼此，所以我们需要配置不同的 hostname 并且在 hosts 文件中映射至本机 IP，然后在配置文件中进行使用。
+
+ 按照实例继续修改 application-node-2.properties、application-node-3.properties 的内容。
+
+3. 在 Linux 中创建 3 个集群节点运行目录，编写服务启动脚本
+
+ ~~~shell
+ [root@localhost cloud]# cd /srv/cloud
+ [root@localhost cloud]# mkdir server-01
+ [root@localhost cloud]# mkdir server-02
+ [root@localhost cloud]# mkdir server-03
+ ~~~
+
+ 编写 shell 脚本：
+
+ ~~~shell
+ #!/bin/bash
+ jarFile=eureka-server-0.0.1-SNAPSHOT.jar
+ profileConfig=spring.profiles.active=node-1
+ pid=$(ps -ef | grep "$jarFile --$profileConfig" | grep -v grep | awk '{print $2}')
+ if [ -n "$pid" ];then
+ kill -9 $pid
+ fi
+ nohup java -jar ../$jarFile --$profileConfig &
+ ~~~
+
+4. 配置 jenkins，通过 jenkins 将 Eureka 集群发布在虚拟机中：
+
+ 
+
+ 确认防火墙端口开启后，在外部浏览器输入 http://192.168.253.128:7001/ 即可查看集群状况。
+
+5. 配置 cloud-provider 的注册中心地址：
+
+ ~~~properties
+ eureka.client.service-url.defaultZone=http://erueka-01:7001/eureka，http://erueka-02:7002/eureka，http://erueka-03:7003/eureka
+ ~~~
+
+
+
+---
+
+#### 6.Eureka 与 CAP 理论
+
+在传统数据库（如：MySQL、Oracle）中，**ACID** 是常用的设计理念，它追求强一致性模型：
+
+- Atomicity：原子性，一个事务中所有操作都必须全部完成，要么全部不完成。
+- Consistency：一致性，在事务开始或结束时，数据必须保持一致的状态。比如 A 给 B 转账，不论转账是否成功，两者存款的总额不变。
+- Isolation：隔离性，并发的事务之间不会相互影响。
+- Durability：永久性，一旦事务完成，就不能被回滚。
+
+ACID 模型要求一个事务必须满足上面的四点，这是对关系型传统数据库的指导性依据。
+
+
+
+在如今的分布式系统设计中，一般采用 **CAP** 理论作为指导性依据，即：
+
+> :yin_yang: 一个分布式系统最多只能同时满足
+>
+> - **Consistency**：强一致性，数据一旦更新，所有数据变动都是同步的。
+> - **Availability**：高可用性，集群在任何时间内都正常使用。
+> - **Partition tolerance**：分区容错性，当某一部分集群坏掉时，另一部分仍能正常工作。
+>
+> 这三项中的两项。
+
+常见的数据库产品的 CAP 占有图：
+
+
+
+由于传统的数据库追求数据的高一致性，且数据库不具有分区容错性，所以一般是满足 CA 特性的。
+
+在分布式系统中，由于网络之间一定存在着延迟、丢包等现象，所以我们必须保证分布式系统的分区容错性，然后在一致性和可用性之间做出抉择。
+
+> 对于大多数互联网应用来说（如：淘宝、微博），因为机器数量庞大，部署节点分散，网络故障是常态，可用性 A 是必须需要保证的，所以一般选择设置弱一致性来保证服务的 AP，如：淘宝双 11 时账单功能会出现延迟。
+>
+> 对于需要确保强一致性的场景（如：银行），通常会权衡 CA 和 CP 模型，CA 模型网络故障时完全不可用，CP 模型具备部分可用性，实际的选择需要通过业务场景来权衡，有时只能查看信息不能更新信息有时候从产品层面还不如直接拒绝服务。
+
+
+
+在 CAP 理论的基础上，架构师 Dan Pritchett 对大规模分布式系统的实践进行总结得出了 BASE 理论：
+
+> :anger: 在保证分区容错性的前提下，系统即使无法做到强一致性，但可以采用适合的方式达到最终一致性。
+
+根据 BASE 理论，设计良好的分布式系统具有以下特性：
+
+1. 基本可用（Basically Available）：例如系统可以忍受响应时间上的损失，也可以使用服务降级来保证系统的基本可用。
+ - 响应时间上的损失：例如在正常情况下，一个在线搜索引擎需要 0.5 秒内返回给用户相应的查询结果，但由于出现部分机房断电或断网故障，查询结果的响应时间增加到了 1~2 秒，此时系统仍然可以被看作是基本可用的。
+ - 功能上的损失：正常情况下，在一个电子商务网站上进行购物，消费者几乎能够顺利地完成每一笔订单，但是在一些节日大促购物高峰的时候，由于消费者的购物行为激增，为了保护购物系统的稳定性，部分消费者可能会被引导到一个降级页面，这种情况也可以被看作是基本可用的。
+2. 软状态（Soft state）：允许系统存在中间状态，而该中间状态不会影响系统整体可用性。分布式存储中一般一份数据至少会有三个副本，允许不同节点间副本同步的延时就是软状态的体现。
+3. 最终一致性（Eventually consistent）：指系统中的所有数据副本经过一定时间后，最终能够达到一致的状态。
+
+
+
+Eureka 与 Zookeeper 在 CAP 理论中的区别：Eureka 保证 AP，Zookeeper 保证 CP。
+
+> Eureka 在网络发生故障时可能会延迟更新服务注册中心的服务列表，即丢弃了高一致性。
+>
+> Zookeeper 在网络发生故障时如果 master 掉线将会重新进行选举，选举期间（1-2 分钟）服务不可用，即丢弃了高可用性。
+
+
+
+---
+
+#### 7.SpringCloud 负载均衡
+
+负载均衡（Load Banlance，LB）分类：
+
+1. 集中式负载均衡：在服务的消费方和提供方之间使用独立的 LB 设施(可以是硬件如：F5, 也可以是软件如：Nginx)，由该设施负责把访问请求通过某种策略转发至服务的提供方。
+2. 进程内负载均衡：将 LB 逻辑集成到消费方，消费方从服务注册中心获知有哪些地址可用，然后自己再从这些地址中选择出一个合适的服务器。
+
+
+
+:articulated_lorry: **LoadBalancer** 负载均衡：
+
+在 Spring Cloud 2020 之前，Spring Cloud 一般采用 Netflix 的 Ribbon 作为一个负载均衡组件，而在这之后已经被删除。
+
+现在，Spring Cloud 团队建议用 Spring Cloud Loadbalancer 替换 Ribbon。
+
+LoadBalancer 属于进程内 LB，它只集成于消费方，是一套 **客户端** 负载均衡的工具。
+
+POM 引用如下：
+
+~~~xml
+
+ org.springframework.cloud
+ spring-cloud-starter-loadbalancer
+
+~~~
+
+cloud-consumer 模块集成 Loadbalancer：
+
+1. 为 cloud-consumer 模块添加 EurekaClient 和 LoadBalancer 依赖。
+
+2. 修改 application.properties 配置:
+
+ ```properties
+ # 由于此服务为消费方，所以不向服务配置中心注册
+ eureka.client.register-with-eureka=false
+ # Eureka Server 集群地址
+ eureka.client.service-url.defaultZone=http://eureka-01:7001/eureka,http://eureka-02:7002/eureka,http://eureka-03:7003/eureka
+ ```
+
+3. 在 RestTemplate 注入时加入负载均衡逻辑：
+
+ ~~~java
+ @Bean
+ @LoadBalanced
+ public RestTemplate restTemplate() {
+ return new RestTemplate();
+ }
+ ~~~
+
+4. 将 RestTemplate 的 url 换成微服务名，通过生产者配置的 `spring.application.name` 访问具体的微服务：
+
+ ~~~java
+ private static final String REST_URL_PREFIX = "http://CLOUD-PROVIDER";
+ ~~~
+
+5. 测试联通后，复制 3 份 cloud-provider 到不同的端口进行启动，测试负载均衡。
+
+
+
+:crossed_swords: **SpringCloud Open Feign** 负载均衡
+
+SpringCloud Open Feign 是一个声明式的 REST 客户端，它是在 LoadBalancer 上的进一步封装，使其支持声明式调用, 做到使用 HTTP 请求远程服务时就像调用本地方法一样的体验。
+
+它的使用方法是定义一个接口，然后在上面添加注解（面向接口编程）。
+
+POM 引用如下：
+
+```xml
+
+ org.springframework.cloud
+ spring-cloud-starter-openfeign
+
+```
+
+注：引入 openfeign 就无需引入 loadbalancer 了。
+
+其次，在主配置类上添加注解：`@EnableFeignClients`。
+
+创建 Feign 接口：
+
+~~~java
+@FeignClient(value = "CLOUD-PROVIDER")
+public interface DeptFeignService {
+ @RequestMapping(method = RequestMethod.GET, value = "/dept/{id}")
+ Dept getDeptById(@PathVariable(value = "id") int id);
+}
+~~~
+
+在 Controller 中进行使用：
+
+~~~java
+@RestController
+@RequestMapping("/dept")
+public class DeptConsumerController {
+
+ @Autowired
+ private DeptFeignService service;
+
+ @GetMapping("/{id}")
+ public Dept getDeptById(@PathVariable int id) {
+ return service.getDeptById(id);
+ }
+}
+~~~
+
+将原来的 RestTemplate 切换为了接口调用。
+
+
+
+切换负载均衡策略：
+
+默认情况下，LoadBalancer 采用轮询的负载均衡模式`org.springframework.cloud.loadbalancer.core.RoundRobinLoadBalancer`。
+
+除此之外，LoadBalancer 还提供了随机的负载均衡模式`org.springframework.cloud.loadbalancer.core.RandomLoadBalancer`，切换方式如下：
+
+~~~java
+// 这里一定不能加 @Configuration 注解
+public class CustomLoadBalancerConfiguration {
+ @Bean
+ ReactorLoadBalancer randomLoadBalancer(Environment environment, LoadBalancerClientFactory loadBalancerClientFactory) {
+ String name = environment.getProperty(LoadBalancerClientFactory.PROPERTY_NAME);
+ return new RandomLoadBalancer(loadBalancerClientFactory.getLazyProvider(name, ServiceInstanceListSupplier.class), name);
+ }
+}
+~~~
+
+第二步，在某个配置类上添加负载均衡客户端配置到容器中（这里加在了 BeanConfiguration 配置类中）：
+
+~~~java
+@Configuration
+@LoadBalancerClient(value = "CLOUD-PROVIDER", configuration = CustomerLoadBalancerConfiguration.class)
+public class XxxConfiguration {
+
+}
+~~~
+
+同样的，SpringCloud 还支持自定义其他负载均衡模式（通过 ServiceInstanceListSupplier 来进行定义）。
+
+##### TODO
+
+
+
+---
+#### 8.SpringCloud 断路器
-微服务的技术栈有哪一些？
-SpringCloud 和 Dubbo 的区别？
+许多以前处于维护模式的Netflix-related模块在Spring Cloud2020 中被删除。这包括您正在使用的Ribbon和Zuul。Spring Cloud团队建议用Spring Cloud Loadbalancer替换Ribbon，用Spring Cloud Gateway替换Zuul。
\ No newline at end of file
diff --git "a/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/Snipaste_2021-07-31_23-47-10.png" "b/notes/Java\350\257\255\350\250\200/\345\274\200\346\272\220\346\241\206\346\236\266/img/Snipaste_2021-07-31_23-47-10.png"
new file mode 100644
index 0000000000000000000000000000000000000000..955765c95433f5f571d79c5816cd3ad8a7377a90
GIT binary patch
literal 50302
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