1、升级原则

• 隔离性：v1升级到v2时，相互独立，互不不干扰。
• 稳定性：服务不停止，完成升级。接口保持畅通。

2、具体实现

2.1 eureka项目

搭建eureka，网上很多，就省略了。

2.2 feign接口项目

2.2.1 依赖

<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><parent><groupId>com.spring.cloud.pro</groupId><artifactId>com.spring.cloud.pro</artifactId><version>1.0.0.RELEASE</version></parent><artifactId>com.spring.cloud.pro.facade</artifactId><description>接口</description><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency></dependencies>
</project>

2.2.2 接口定义

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;import com.spring.pro.model.User;/**   * @Title: UserFacade.java * @ProjectName com.spring.cloud.pro.facade* @Description:  * @author ybwei   * @date 2019年1月11日 下午4:18:09    */
@FeignClient("eureka-provider${version}") //name等于服务提供者的spring.application.name
public interface UserFacade {/**  * @Description: * @Param: @param id* @Param: @return* @Param: @throws Exception* @return: User* @Author: ybwei* @Date: 2019年1月11日 下午4:20:59*/ @GetMapping("/getUser")public User getUser(@RequestParam("id") Integer id) throws Exception;
}

import lombok.Data;/**   * @Title: User.java * @ProjectName com.spring.cloud.pro.facade* @Description:  * @author ybwei   * @date 2019年1月11日 下午4:18:49    */
@Data
public class User {private Integer id;private String name;private Integer age;}

2.3 生产者

2.3.1 依赖

<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><parent><groupId>com.spring.cloud.pro</groupId><artifactId>com.spring.cloud.pro</artifactId><version>1.0.0.RELEASE</version></parent><artifactId>com.spring.cloud.provider</artifactId><version>1.0.1.RELEASE</version><description>服务提供者</description><dependencies><dependency><groupId>${project.parent.groupId}</groupId><artifactId>com.spring.cloud.pro.facade</artifactId><version>${project.parent.version}</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><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-actuator</artifactId></dependency></dependencies><build><finalName>${project.artifactId}</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><executions><execution><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins></build>
</project>

2.3.2 application.yml配置

version: '@project.version@' #项目版本
server:port: 8083
spring:application:name: eureka-provider${version}
eureka:client:service-url:defaultZone: http://localhost:8761/eureka
hystrix:command:default:execution:timeout:enabled: false #hystrix禁止超时设置 

2.3.3 代码

package com.spring.pro.controller;import org.springframework.web.bind.annotation.RestController;import com.spring.pro.facade.UserFacade;
import com.spring.pro.model.User;/**   * @Title: UserController.java * @ProjectName com.spring.cloud.provider* @Description:  * @author ybwei   * @date 2019年1月11日 下午4:25:19    */
@RestController
public class UserController implements UserFacade {@Overridepublic User getUser(Integer id) throws Exception {User user=new User();user.setId(id);user.setName("李四");user.setAge(21);return user;}}

2.4 消费者

2.4.1 依赖

<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><parent><groupId>com.spring.cloud.pro</groupId><artifactId>com.spring.cloud.pro</artifactId><version>1.0.0.RELEASE</version></parent><artifactId>com.spring.cloud.pro.consumer</artifactId><version>1.0.1.RELEASE</version><description>消费者</description><dependencies><dependency><groupId>${project.parent.groupId}</groupId><artifactId>com.spring.cloud.pro.facade</artifactId><version>${project.parent.version}</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><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-actuator</artifactId></dependency></dependencies><build><finalName>${project.artifactId}</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><executions><execution><goals><goal>repackage</goal></goals></execution></executions></plugin></plugins></build>
</project>

2.4.2 application.yml配置

version: '@project.version@' #项目版本
server:port: 8084
spring:application:name: eureka-consumer${version}
eureka:client:service-url:defaultZone: http://localhost:8761/eureka
feign: hystrix:enabled: true #启用hystrix
hystrix:command:default:execution:timeout:enabled: false #hystrix禁止超时设置 

2.4.3 代码

package com.spring.pro.controller;import javax.annotation.Resource;import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;import com.spring.pro.facade.UserFacade;
import com.spring.pro.model.User;/*** @Title: UserController.java* @ProjectName com.spring.cloud.pro.consumer* @Description:* @author ybwei* @date 2019年1月11日 下午4:27:14*/
@RestController
public class UserController {@Resourceprivate UserFacade userFacade;@GetMapping("/getUser")public User getUser(Integer id) throws Exception {return userFacade.getUser(id);}
}

3、说明

3.1 核心逻辑

消费者调用的的生产者是spring.application.name+版本号。

3.2 升级过程

当系统进行从v1升级到v2：

1. 项目的生产者、消费者项目版本号升级。v1升为v2。项目的生产者、消费者项目版本号保持一致。
2. 生产者的50%升级到v2版本。如果全部升级，v1版本消费者都会失败。
3. 消费者全部升级到v2版本。
4. 生产者全部升级到v2版本。

注意：示例中生产者、消费者项目使用的pom.xml中的版本号，也可以使用常量（如1.0），只要保持两者一致即可。

3.3 适用场景

• 接口v1版本与v2版本不兼容时，app强制更新，适用。
• 接口v1版本与v2版本兼容，app不需要更新，适用。

3.4 版本控制

3.4.1 命名规范

参考软件版本命名规范

3.4.2 注意

多团队开发时，版本号尽量由一个人来控制，避免冲突。同一天上线，为统一版本号。不同时间上线为不同版本号。