FigJam 是一个很适合“边想边说”的地方。团队打开一个白板,贴上便利贴,画几个方框和箭头,二十分钟后,大家就新服务该如何与旧服务通信达成了一致。问题出现在一周之后:那张草图不知不觉成了“架构图”,而总得有人让它保持准确。
本文讲的就是这第二件事。如果你的团队现在用 FigJam 画架构图,下面会说明为什么 Archboard 更适合存放这些图、日常工作中会有哪些变化,以及如何在不开展大型迁移项目的情况下完成切换。
简要结论
- FigJam 是一块白板。 它为实时会议而生:便利贴、贴纸印章、投票、计时器和光标聊天。架构只是你能在上面画的众多内容之一。
- Archboard 是一个架构工作区。 节点知道自己是什么(Kubernetes 的
Service、C4 的Container、防火墙),连线连接到端口上,每张图都对应一个自动保存并保留修订版本的链接。 - Archboard 两头都能兼顾。 笔记、贴纸和思维导图就在架构节点包旁边,头脑风暴和需要长期保留的图都在同一块画布上。
为什么架构图会“装不下” FigJam
矩形只是一个矩形
在白板上,含义只存在于标签里。一个写着“orders-api”、旁边贴了 Kubernetes 图标的方框看起来没问题,但白板并不知道它是 Deployment、Service 还是外部系统。FigJam 的形状库确实包含 AWS、Azure、Google Cloud 和 Kubernetes 图标,但图标并不带类型,所以同一个团队里的两个人仍然会用两种不同的方式画同一样东西。几个月后,图例就只存在于某个人的脑子里了。
图被埋没在研讨会里
FigJam 白板天生就会越变越大:便利贴、投票、复盘笔记、截图,还有某人尝试过的第二种方案。开会时这是优点。会后,真正对入职培训或事故响应有用的那一部分,只是大白板某个角落里的一个 frame,旁边还摆着团队否决掉的方案。新同事根本分不清哪个 frame 才是当前的系统。
工程师最终住进了设计工具
FigJam 文件存放在 Figma 中,和产品设计工作放在一起;要编辑它们,需要一个包含 FigJam 的 Figma 席位(Collab、Dev 或 Full 席位)。权限跟随 Figma 的团队和项目,而这些通常是围绕设计而不是服务来组织的。在 Figma 免费的 Starter 计划中,一个团队只有 3 个 FigJam 文件;一旦每个服务、环境和决策都需要自己的图,这点额度很快就不够用了。
这些都不说明 FigJam 是个糟糕的工具,只说明它是一个开会用的工具。而架构图必须在会议结束后继续存活。
Archboard 的做法
Archboard 是一个托管的工作区,专为下个季度仍需保持准确的图而设计。用 Google 或 GitHub 登录,无需信用卡,就可以在画布上开始。
为系统打造的节点包
目录中有 27 个节点包和 223 种节点类型,包括 Kubernetes(33 种节点)、C4 Model、Cloud、Network、Security、Data、DevOps、Docker、Sequence、UML、Entity Relation 和 BPMN。你放下一个 Namespace frame,再把 Deployment、Service 和 Ingress 节点放进去。C4 视图则在边界内使用 Person、Software System 和 Container 节点。类型是节点本身的一部分,而不是根据标签做出的猜测。
用端口和 frame,而不是松散的箭头
连线连接到节点的端口上,因此移动元素时连接不会断开,读起来也是真实的依赖关系:从 Ingress 到 Service 的流量,从一个容器到另一个容器的调用。frame 用来表示边界,例如 namespace、VPC、信任区域或 C4 系统边界,并把其中的内容组织在一起。
一个始终最新的链接
每张图都会自动保存并保留修订快照,所以“哪个版本才是对的?”只有一个答案。你不必再把 PNG 贴进文档,而是分享一个链接(Free 计划带 Archboard 品牌标识),或者在 Pro 计划中把实时的图嵌入文档站点。系统变化时,只需更新一次图,所有引用它的页面都会同步为最新。
头脑风暴依然有位置
白板那部分功能并不会丢。Archboard 在架构节点包旁边还提供便利贴、文本、贴纸、思维导图和看板。一次设计讨论可以从画布上的笔记开始,最后变成一张带类型的图,无需在工具之间复制任何内容。
你的图就是数据
图可以以结构化 JSON 的形式导入和导出,所有计划都支持 SVG 和 PNG 导出。Pro 计划还增加了 PDF、JPEG 以及动画 GIF/WebM 导出。把 JSON 导出文件和代码一起提交,就能得到一份可审查的架构变更记录。
FigJam 与 Archboard 一览
| FigJam | Archboard | |
|---|---|---|
| 主要用途 | 实时白板和研讨会 | 保持最新的架构图 |
| 基本构件 | 通用形状、连接线和便利贴 | 27 个节点包,223 种带端口的类型化节点 |
| 架构节点包 | AWS、Azure、Google Cloud 和 Kubernetes 图标形状;没有类型化节点 | Kubernetes、C4 Model、Cloud、Network、Security、Data、DevOps 等 |
| 图存放在哪里 | Figma 文件和项目中,与设计工作放在一起 | Archboard 工作区,每张图一个链接 |
| 历史记录 | Figma 版本历史 | 自动保存和修订快照 |
| 图的语义 | 含义只存在于标签中 | 节点类型、端口和边界都是图的一部分 |
| 免费计划 | Starter 计划 3 个 FigJam 文件 | 1 个席位、3 张图,每张图 15 个图表节点 + 150 个便签、文本、贴纸和思维导图主题,全部节点包 |
各计划的详细信息(包括 Free 和 Pro 包含的内容)请参见 /pricing 页面。
典型的切换过程:平台团队的集群地图
设想一个平台团队,他们把集群总览保存在去年规划会上的一个 FigJam 白板里。白板上有三种 ingress 层方案、一列复盘便利贴,以及一个名为“current”的 frame——自从两个服务改名之后就没人动过它。
在 Archboard 中,同样的内容会变成:
- 一个问题一张图。 “流量如何到达集群?”和“哪个服务拥有哪些数据?”各有自己的图,而不是挤在同一个白板上。
- 类型化的构件。 一个 Cloud 节点包中的 Kubernetes Cluster 节点,下方是
Namespaceframe,以及通过端口连接的Service、Deployment节点和 ingress 控制器的Pod。 - 用链接代替截图。 入职文档和事故处理手册都指向实时的图。
- 一个简单的习惯。 当某个 pull request 修改了清单文件时,有人更新这张图,修订历史会显示它是何时变化的。
图表内容
- Planning workshop
- prod-cluster
- ingress-nginx
- ingress-nginx-controller
- checkout
- payments
- becomes
- /checkout
- /payments
- charge
FigJam 白板不必删除,它依然是那次规划会的记录。集群地图则放在 Archboard 里。如果想要一个现成的起点,可以看看 /use-cases/kubernetes 页面。
从 FigJam 迁移到 Archboard
迁移比听起来更快:你只需重画值得保留的部分,而不是整个白板,类型化节点也让每一步都更快。
- 选出打开次数最多的图,通常是入职文档或事故处理手册里链接的那张。
- 从示例开始。 /examples 图库中有 Kubernetes、C4、云和网络方面的图,可以作为起始结构。
- 用类型化节点重画。 用真正的节点替换带标签的矩形,用 frame 替换虚线框,用端口到端口的连线替换松散的箭头。
- 用链接替换截图。 让文档和工单指向 Archboard 的分享链接,或在 Pro 计划中直接嵌入,并把 FigJam 白板留作历史记录。
用 Free 计划就足以拿第一张图试一试。若要绘制完整的生产环境地图,Pro 提供无限的图和节点、嵌入功能以及无水印导出。
常见问题
Archboard 是免费的 FigJam 替代工具吗? 对个人来说是的。Free 计划包含 1 个席位、3 张图和全部内置节点包,每张图可以使用 15 个节点,外加 150 条笔记、文本、贴纸和思维导图主题。需要一起实时编辑,或需要不限数量的图和节点的团队会使用 Pro。
Archboard 如何定价? Free 计划包含 1 个席位和全部节点包。Pro 适用于 1–5 个席位,每席位每月 10 美元,提供无限的图和节点、角色权限、嵌入功能和修订历史。Enterprise 面向 6 个及以上席位,增加 SLA、安全审查和专属支持。只需为编辑图的人购买席位,其他人可以通过分享链接查看。
可以把 FigJam 白板导入 Archboard 吗? 不能直接导入。Archboard 可以导入自己的 JSON,以及 Kubernetes YAML 和 Docker Compose 文件,因此集群地图可以从你的清单文件开始;其他值得保留的图,从团队最常打开的那张开始重画即可。借助类型化节点和端口,这个过程很快,最终得到的图也会比原来的白板更清晰。
Archboard 有像 FigJam 那样的实时光标吗? 有。所有拥有编辑权限的人都能即时看到实时光标和更改,通过 MCP 接入的 AI 智能体也会以同样的方式显示。没有计时器或投票:所有更改自动保存,修订版本会被保留,Pro 和 Enterprise 计划还可以通过角色控制谁能编辑。想在同一块画布上做头脑风暴时,便利贴、贴纸和思维导图随时可用。
Archboard 是否包含 AWS、Azure 或 Google Cloud 的官方图标?
Archboard 的 Cloud 节点是类型化、与厂商无关的节点,而不是官方图标集;需要时,插入搜索中的品牌图标可以添加 AWS Route 53 等厂商 logo。给每个节点标上服务名称,例如 Route 53 或 Cloud SQL,图在不同云之间都能保持清晰一致。