我一直在用 draw.io做一些和UML流程图，图表或者曲线图相关的事情。它在丰富的功能和用户的手工控制方面做出了合理的权衡。
但是，接下来我会告诉你如何自动化一些无聊的鼠标点击;）
避免从一开始就犯错
Daniel Woods的 “Microservices: The Right Way” 演讲里其中一张幻灯片
如果它不是这样的话事情也不会变得这么有趣。事实上，这里最好能有一张更清晰地展现组件之间关系和职责的图片。不然的话最终结果就是像上面看到的这样 ;)
诀窍便是在做的时候不断审视它哪个地方不对，这样一来便不太可能做的这么糟了。
在做图的时候 —— 你也在同时给自己一个整体的感觉，它们将会怎么交互，问题域是什么，上下文，边界，等等。
"光纸上谈兵是没用的，长期的战略规划才是无价的。"
― Winston Churchill
行动起来！
假设我们有一个简单的社交应用。当然，这是一个很简单的设定，但是你可以注意到这里面存在许多的关联关系。
客户端：前端应用和浏览器扩展。
API网管：认证API和主服务API。
微服务：照片，图表还有好友这些微服务。
我花了相当长的时间来排列方块，拖放箭头还有调整。而这只是因为我想要以一个更可读的方式来对齐它们。
你可以想象排列50个这样的方块有多无聊吗？100个呢？然后我如果再删除一个？我敢打赌你会放弃这件事情，然后选择回来继续码代码。
和 Graphviz 结缘
我从Terraform获得了灵感 —— 一个创建和维护生产环境基础设施的工具。它支持配置任意和基础设施相关的服务，这里面包含了从AWS EC2的实例到来自于50个云厂商提供的集群和负载均衡。它还提供了一个有趣的 terraform graph 命令，可以根据现有配置生成一个可视化的图表展现。
‘terraform graph’命令的示例输出
因此我决定采用相同的技巧，但是针对的是一个更高层面的微服务架构。以下是一个用DOT编写的Graphviz配置。
digraph architecture {
rankdir=LR;
subgraph client_side_apps {
front_end -> {auth_api, my_app_api};
extension -> {auth_api, my_app_api};
{rank=same; front_end, extension, auth_api};
}
subgraph api_gateways {
my_app_api -> {photos_ms, chats_ms, friends_ms};
}
subgraph microservices {
photos_ms -> {database};
chats_ms -> {database, cache};
friends_ms -> {database, facebook_api};
}
}
- 1.
- 2.
- 3.
- 4.
- 5.
- 6.
- 7.
- 8.
- 9.
- 10.
- 11.
- 12.
- 13.
- 14.
- 15.
- 16.
- 17.
- 18.
- 19.
- 20.
- 21.
- 22.
- 23.
- 24.
- 25.
- 26.
- 27.
- 28.
- 29.
- 30.
- 31.
- 32.
- 33.
- 34.
- 35.
- 36.
- 37.
- 38.
- 39.
你只需要将它渲染成一个.png文件即可。你可以使用在线编辑器或者直接在机器上渲染。为了不弄脏系统，我为此创建了一个Docker镜像：
cat file.dot | docker container run --rm -i vladgolubev/dot2png > file.png
- 1.
通过执行上述这行简单代码，两分钟内你便可以得到这样一个令人惊叹的输出结果！
提示：你可以将代码复制粘贴到一个在线的编辑器： http://dreampuf.github.io/GraphvizOnline/
在微服务之间添加一个新的依赖的想法实现起来从未如此简单。我需要做的只是添加一行新的代码，随即 Graphviz 会很好地将它们组织在一起。
作为最后的点睛之笔，我喜欢添加一些颜色。因此你立马可以看到下面的效果：
- 绿色 — node.js
- 红色 — api gateway
- 黄色 — front-end
- 蓝色 — storage，database
- 灰色 — 3rd-party API
这并不是最优的颜色布局，但是你已经知道可以这样做了 ;)
相信我，有大量图表的情况也很容易做到这一点。
全部代码放在： https://gist.github.com/vladgo ... 70882
小结
我在给一张微服务架构图频繁添加修改时遇到了问题。每一次变更都要用箭头手工修补。如今我可以放心实验，看看新的微服务是如何适配我的系统。当然，你还可以做的更好，将它放到版本控制系统里，这样一来便可以得到架构图的修改变更历史！
但是这取决于你。选择一款最合适的工具吧。Google搜索[微服务可视化]( https://www.google.com/search?q=microservice visualization)的方案，你将会被一大票商业解决方案轰炸的。
可视化的设计会使得检查和调试变得更容易。
― Unix的基本哲学
