Vert.x Microservice Blueprint：微服务架构的另一种走法

vertx-blueprint-microservice 在 GitHub 上拿到 789 Star。

sczyh30 开源了这个蓝图项目，基于 Vert.x 实现一套完整的微服务架构示例。从异步 RPC 到 API 网关，从服务发现到熔断器，常见微服务该有的组件这里都摆好了。

1、 这玩意儿是干嘛的

一个用 Vert.x 写的 Micro Shop 微服务参考实现。重点不在那个微型电商业务上，而在它怎么用 Vert.x 把一套微服务架构搭起来。

Vert.x 3.4.1 是它的运行基线。整套蓝图覆盖了从通信、持久化到网关、监控的各个环节，作者把它定位为设计与实现 Vert.x 微服务应用的范本。仓库里也注明正在重构整体架构，新版本打算在五月末放出。

2、 它把哪些东西拼到一起

Vert.x 这套工具箱的关键能力，蓝图里基本都示范了一遍。

异步开发模型和响应式编程模式是底座，服务之间通过集群化 Event Bus 做异步 RPC。事件溯源模式用来记录状态变化。服务形态上区分了 REST、消息源、Event Bus Service 几种，按场景挑着用。

外围设施这块也齐：Configuration Retriever 统一拉配置，Service Discovery 处理服务注册与发现，Circuit Breaker 防止级联失败。多语言持久化支持让不同服务选不同的存储。

进到接入层，API Gateway 做统一入口，全局认证把 Local 和 OAuth 2 都覆盖了。运维侧用 ELK 做集中日志，配套监控看运行状态。

3、 怎么跑起来

前端依赖要先装。api-gateway 和 monitor-dashboard 这两个组件需要在 src/main/resources/webroot 目录下用 bower 拉前端依赖：

bower install

然后是构建：

mvn clean install -Dmaven.test.skip=true

Docker Compose 的运行方式作者放在了文档里，跟着教程走就行。中文版本的开发篇和 API Gateway 篇作者都写了，照着读比直接看代码上手快。

4、 适合谁看

想用 Vert.x 做微服务但不知道组件怎么搭的人，这份蓝图就是作者给的现成答案。从 Event Bus 到 Service Discovery 的串联方式，从事件溯源到熔断器的接入点，图里能看清整条链路。

学 Java 微服务架构的人也合适。Spring Cloud 之外另一种思路就在这，基于 Vert.x 的异步流派走法。读源码能看出每个组件的契约，比硬啃 Vert.x 官方文档直观得多。

Star 数不到一千不算热门，但蓝图类项目的价值不在热度，在于它把零散的能力拼成了能跑的整体。组件单独看都简单，拼起来才是架构。

但蓝图类项目的价值不在热度，在于它把零散的能力拼成了能跑的整体。组件单独看都简单，拼起来才是架构。