简单spring cloud服务升级实现

1、升级原则

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

2、具体实现

2.1 eureka项目

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

2.2 feign接口项目

2.2.1 依赖

	4.0.0
	
		com.spring.cloud.pro
		com.spring.cloud.pro
		1.0.0.RELEASE
	
	com.spring.cloud.pro.facade
	接口

	
		
			org.springframework.cloud
			spring-cloud-starter-openfeign
		
	

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 依赖

	4.0.0
	
		com.spring.cloud.pro
		com.spring.cloud.pro
		1.0.0.RELEASE
	
	com.spring.cloud.provider
	1.0.1.RELEASE
	服务提供者

	
		
			${project.parent.groupId}
			com.spring.cloud.pro.facade
			${project.parent.version}
		
		
			org.springframework.boot
			spring-boot-starter-web
		
		
			org.springframework.cloud
			spring-cloud-starter-netflix-eureka-client
		
		
			org.springframework.boot
			spring-boot-starter-actuator
		
	

	
		${project.artifactId}
		
			
				org.springframework.boot
				spring-boot-maven-plugin
				
					
						
							repackage
						
					
				
			
		
	

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 {

	@Override
	public 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 依赖

	4.0.0
	
		com.spring.cloud.pro
		com.spring.cloud.pro
		1.0.0.RELEASE
	
	com.spring.cloud.pro.consumer
	1.0.1.RELEASE
	消费者
	
		
			${project.parent.groupId}
			com.spring.cloud.pro.facade
			${project.parent.version}
		
		
			org.springframework.boot
			spring-boot-starter-web
		
		
			org.springframework.cloud
			spring-cloud-starter-netflix-eureka-client
		
		
			org.springframework.boot
			spring-boot-starter-actuator
		
	

	
		${project.artifactId}
		
			
				org.springframework.boot
				spring-boot-maven-plugin
				
					
						
							repackage
						
					
				
			
		
	

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 {
	@Resource
	private 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 注意

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