我们实践的微服务全家桶，希望能提供帮助

一 背景

创业半年多，中间做过一个app。各种各样的原因，虽然最后上线了，但是没有推广，每天新增百十来个用户，也不打算迭代了。我们后台使用的是基于spring-boot、spring-cloud的微服务框架。框架包含了spring-cloud全家桶的大部分组件，我这两天重新把这些框架类的内容整理了一遍，构建了一个简单的场景，放在github上，希望对那些想学习 或者 快速搭建自己的微服务框架的同学能提供帮助。

代码地址(附上原文地址)：https://github.com/chxfantasy/spring-cloud-demo

代码目录：

如果对微服务本身不太太了解的话，或者不知道为什么需要微服务的话，请参考原来的一篇文章：我也想写篇微服务的文章，以及微服务的优缺点

如果对微服务里面的各个组件不太熟悉的话，可以参考这一篇文章：spring cloud从看不懂到放弃

二 项目介绍

1. 这仅仅是spring-cloud微服务框架的一个demo，可以完整运行。可能你初看到这里，会觉得这个项目目录太tm复杂了，确实，微服务要做的就是解耦、轻量化。这里面包含的组件和内容有:

spring cloud eureka，服务注册和服务发现

spring cloud config，动态配置项

ribbon，客户端负载均衡

feign

hystrix，熔断

turbine

Spring Cloud Starters

同一个服务中的多数据库支持（AOP）

全链路traceId追踪

velocity 前端模板

mybatis, pageHelper (分页), druid (连接池)

redis（序列化采用的是jdk默认序列化方案）

slf4j & logback(及其配置)

国际化配置

全局错误信息catch

线程池

服务健康检查, 服务全链路健康检查

等

2. 代码的业务是：首先有一个登录页面，用户登录以后，能看到一个微博(moment)列表，同时也可以添加微博。在每个微博的最右边，可以看到每个微博的评论列表，也能添加评论。前端代码写的非常粗糙。。。 如果你真的运行了，求不吐槽。

3. 这里不谈根据业务的需求去选择是否微服务化，也不争辩什么时候该用什么样的框架，我这里只是把我们app后端的代码，抽象成一个代码库，希望能为你提供帮助。我们产品上线2个多月，后端基本没有出过问题(也跟量小有关系)。

三 运行

1. 首先，你在本地需要有一个redis和mysql，redis默认启动就可以。数据库表的创建语句见下：

create database test;

CREATE TABLE `account` (

`user_id` varchar(127) NOT NULL DEFAULT '',

`user_name` varchar(127) NOT NULL DEFAULT '',

`password` varchar(127) NOT NULL DEFAULT '',

`gmt_created` datetime NOT NULL,

`gmt_modified` datetime DEFAULT NULL,

`is_deleted` tinyint(1) NOT NULL DEFAULT '0',

PRIMARY KEY (`user_id`),

KEY `index_user_id` (`user_id`) KEY_BLOCK_SIZE=10

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `moment` (

`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,

`user_id` varchar(127) COLLATE utf8mb4_unicode_ci NOT NULL,

`content` text COLLATE utf8mb4_unicode_ci,

`gmt_created` datetime NOT NULL,

`gmt_modified` datetime DEFAULT NULL,

`is_deleted` tinyint(1) DEFAULT '0',

PRIMARY KEY (`id`),

KEY `index_user_id` (`user_id`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

create database test2;

CREATE TABLE `comment` (

`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,

`moment_id` bigint(20) unsigned NOT NULL,

`content` text COLLATE utf8mb4_unicode_ci,

`gmt_created` datetime NOT NULL,

`gmt_modified` datetime DEFAULT NULL,

`is_deleted` tinyint(1) DEFAULT '0',

PRIMARY KEY (`id`),

KEY `index_moment_id` (`moment_id`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

2. 系统环境需要Java 8 和 maven 3及以上

3. 运行命令如下 (需要按顺序运行每个模块):

cd spring-cloud-parent

mvn clean install -DskipTests

cd ../spring-cloud-client

mvn clean install -DskipTests

cd ../spring-cloud-starter

mvn clean install -DskipTests

cd spring-cloud-eureka

mvn clean spring-boot:run

cd spring-cloud-account

mvn clean spring-boot:run

cd spring-cloud-biz

mvn clean spring-boot:run

cd spring-cloud-gateway

mvn clean spring-boot:run

4. 浏览器中打开

四 代码结构

1. 代码中的依赖关系见下图:

2.spring-cloud-parent

是一个空的mvn project, 包含了一些被其他项目所需要的公共的依赖。我这里创建parent，仅仅是因为我不想把很多相同的依赖在spring-cloud-eureka、spring-cloud-biz、spring-cloud-account和spring-cloud-gateway这几个项目中重复写一遍，所以，一般微服务project都集成spring-cloud-parent。嗯，懒惰是人类的第一生产力。

3.spring-cloud-starter

是一个我创建的spring starter, 里面包含的是一些公共的bean，和一些公共的bean配置，比如国际化locle配置、缓存CacheService配置，messageConvertor配置等，spring-cloud-biz、spring-cloud-account和spring-cloud-gateway等微服务都需要依赖和共用这些基础配置。

4.spring-cloud-client

是一个公共依赖，这里包含的是一个util类，以及多个模块需要共同使用的、和数据库表对应的Java model。

5.spring-cloud-eureka

是一个服务注册和服务发现中心，需要集群化。代码里，我把spring-cloud-config动态配置项也集成在这里面了。服务发现的心跳检测时间，也从15s改到了5s，这对于快速发现节点故障很有作用。

6.spring-cloud-account

是整个工程的账号服务模块。对于一个大型的系统来讲，单独的账号服务系统是很有必要解耦出来的。

7.spring-cloud-biz

是实际的业务模块，包括发微博模块和评论模块。整个代码中动态使用了两个数据库，我这里对数据库的切分只是简单从业务上切分，既：微博在一个库中，评论在另外一个库中，同时写了一个@TargetDataSource注解，方便动态切换数据库。其实对于分库、分表、读写分离，代码都是类似的。

8.spring-cloud-gateway

是整个系统的网关服务，所有来自端上的请求，包括app或者web页面，都需要先到网关，由网关做过处理之后再转发给其他服务。比如，网关需要处理登录状态问题，需要处理上传文件问题，需要做一些过滤，以及其他多种切面上的事情。

9. 如果需要停止某个微服务，如spring-cloud-account、spring-cloud-biz或者spring-cloud-gateway, 运行命令:, 这条命令会先让这个微服务在注册中心下掉自己，然后再停掉自己。

五 部署

1. 服务的部署如下图:

2. 需要注意的就是，整个系统只有gateway是可以被端访问到的，其他服务的所有接口，都应该只能在内网访问，这也可以让其他服务不做很强的权限验证。

3. 代码里面细节很多，比如cache如何使用， GlobalCacheHelper，hystrix的自定义设置，全链路traceId的设置，信息的国际化、健康检查(去检查了cache、db等其他项，还检查了每一项的返回时间)，等以后的再写。

4. 非常欢迎提issue、提bug，也非常欢迎star [谄笑脸]