构建混合基础设施的统一视图需要精确的架构文档。当系统跨越公共云环境和私有数据中心时，单一的部署图对利益相关者理解数据流、依赖关系和物理边界变得至关重要。本指南概述了构建准确图表的方法，以清晰地表示两种环境而不会造成混淆。通过遵循标准建模规范，可以确保开发人员、运维团队和安全审计人员都能清晰理解。🛡️
理解混合环境背景 🌐
部署图用于可视化系统的物理或虚拟硬件与软件架构。在混合模型中，这意味着要描绘出在逻辑上独立但在功能上集成的资源。其挑战在于保持视觉一致性的同时，区分云服务的托管性质与本地硬件的管理控制权。若缺乏清晰的区分，图表将无法有效传达风险、延迟或所有权信息。
在建模这些环境时，请牢记以下目标：
- 清晰性：观众必须能立即识别出哪些组件位于哪个环境中。
- 准确性：拓扑结构必须反映实际的网络路径和连接协议。
- 可维护性：随着基础设施随时间变化，图表应保持有效。
- 安全性：防火墙和加密区域等边界必须明确展示。
图表的核心组件 📊
为了构建一个稳健的表示，必须定义UML驱动的部署建模中使用的标准元素。这些元素构成了你图表的词汇基础。
1. 节点与设备
节点代表物理或虚拟的执行环境。在混合设置中，节点根据其位置和管理类型进行分类。
- 云节点：代表由第三方提供商托管的虚拟机、容器或无服务器函数。这些通常是临时的或动态扩展的。
- 本地节点：代表由内部IT团队管理的物理服务器、大型机或本地虚拟化主机。这些通常具有固定的容量和硬件依赖性。
- 网络节点：用于在两个环境之间促进流量的路由器、交换机和负载均衡器。
2. 工件
工件代表部署在节点上的物理软件组件。示例包括可执行文件、库、配置文件或数据库模式。确保工件与它们所在的特定节点相关联。
- 可执行文件：在操作系统上运行的二进制文件。
- 数据库文件：位于存储卷上的数据存储。
- 配置 定义运行时行为的脚本或文件。
区分的视觉惯例 👁️
一致性是可读性的关键。由于不能仅依赖颜色来保证可访问性，因此应使用形状、构造型和边框来区分环境。
使用构造型
将特定的构造型应用于节点形状，以表示其来源。这是在建模标准中表示环境类型最正式的方法。
- 云构造型： 使用类似这样的标签
«云»或«公共»标注在代表云节点的方框上。 - 本地部署构造型： 使用类似这样的标签
«服务器»或«本地»标注在代表本地基础设施的方框上。 - 边界框： 将云节点分组在标有“云环境”的较大边界框内，将本地节点分组在标有“数据中心”的边界框内。
颜色与形状指南
虽然避免使用特定工具，但仍应遵循通用的设计原则来构建视觉层次。
- 形状： 无论位置如何，数据库均使用圆柱体表示，但应在圆柱体周围放置边界框以显示环境。
- 边框样式： 本地连接使用实线，云连接使用虚线，以暗示逻辑网络隔离。
- 图标： 使用图标，例如用机架图标表示本地硬件，用云图标表示远程服务。
建模连接性与协议 📡
连接节点的线条代表通信路径。在混合模型中，这些路径会跨越安全边界和网络段。您必须记录这些链接的协议和安全上下文。
网络协议
用所使用的通信协议标记您的关联线。这有助于开发人员理解延迟要求和兼容性。
- HTTP/HTTPS： 标准网络流量。请注明是否强制使用SSL/TLS。
- gRPC/REST： 内部微服务通信。
- 数据库协议： SQL、NoSQL 或特定的连接字符串。
- 消息队列： AMQP、Kafka 或专有的消息系统。
带宽和延迟
并非所有连接都相同。本地服务器到本地交换机的连接与到公共云区域的连接不同。建议在图中添加定性性能说明。
- 高延迟： 用注释标记跨越互联网的连接，以表明潜在的延迟。
- 高带宽： 使用更高吞吐量指标标记专用线路（如Direct Connect或ExpressRoute等效线路）。
- 冗余： 为关键服务显示多条路径，以表明故障转移能力。
安全边界和区域 🔒
在建模混合系统时，安全至关重要。部署图不应隐藏边界。应明确绘制保护敏感数据的边界。
防火墙和网关
将防火墙节点放置在网络段的边缘。显示流量在进入内部云或本地区域之前被检查的位置。
- 边界防火墙： 保护本地数据中心免受外部威胁。
- 云网关： 保护云环境免受公共互联网流量的威胁。
- DMZ： 一个非军事区，公共访问的服务位于此处，与内部数据库隔离。
加密与合规
标明数据加密的位置。这对合规性审计至关重要。
- 传输中： 使用锁形图标标记线条，以表示传输过程中的加密。
- 静态数据： 使用锁形图标标记存储节点，以表示磁盘上的加密。
- 合规区域： 使用虚线将必须遵守特定法规（例如，GDPR、HIPAA）的节点分组。
分步建模流程 📝
遵循此结构化方法，创建您的图表，确保不遗漏关键细节。
步骤 1：资产清单
绘图前，请列出所有组件。创建一个电子表格或文本列表，列出所有涉及的服务器、数据库和服务。按环境进行区分。
- 列出所有本地服务器及其角色。
- 列出所有云实例及其服务类型（例如，计算、存储）。
- 识别所有第三方集成。
步骤 2：定义拓扑
绘制高层网络布局。确定边界位置。将本地盒子放在左侧，云盒子放在右侧，或根据复杂程度使用垂直分割。
- 绘制主要网络边界。
- 绘制云的次级网络边界。
- 标记它们之间的连接点（例如，VPN、对等连接）。
步骤 3：放置节点和构件
将您的资产清单项目拖放到相应的边界中。确保构件包含在它们部署到的节点内。
- 将应用程序二进制文件放置在计算节点上。
- 将数据文件放置在存储节点上。
- 将配置文件放置在管理节点上。
步骤 4：绘制连接
根据数据流在节点之间绘制线条，并添加协议标签。
- 绘制表示 API 调用的线条。
- 绘制表示数据库复制的线条。
- 绘制表示认证流程的线条。
步骤 5：添加安全注释
审查图表中的安全漏洞。添加加密和防火墙的标签。
- 标记所有面向互联网的端口。
- 标记所有仅限内部的端口。
- 确认敏感数据路径已得到保护。
应避免的常见陷阱 ⚠️
即使经验丰富的架构师在建模混合系统时也会犯错。请注意这些常见错误。
1. 图表过于拥挤
不要试图展示每一台服务器。将相似的服务器分组为集群或逻辑节点。包含50个独立框的图表是无法阅读的。
- 分组： 使用一个标记为“Web服务器集群”的单一节点，而不是五个独立节点。
- 抽象： 除非内部细节与部署上下文相关，否则隐藏服务的内部细节。
2. 忽视数据同步
在混合模型中，数据通常需要在不同环境之间移动。如果不展示复制，图表就不完整。
- 使用双向箭头表示数据同步。
- 标注同步的频率（例如：“实时”、“每小时批量”）。
3. 混合逻辑与物理视图
部署图应为物理或虚拟的。不要将逻辑组件图与部署节点混合。应聚焦于硬件和软件的安装。
- 不要在部署节点内显示类图。
- 除非用户角色由独立的硬件终端表示，否则不要显示用户角色。
4. 信息过时
云基础设施变化迅速。六个月前的图表可能已经过时。
- 版本控制： 在图表标题中添加版本号或日期。
- 审查周期： 安排定期审查架构文档。
建模方法对比 📋
不同团队可能偏好不同详细程度。下表总结了常见的方法。
| 方法 | 详细程度 | 最适合 | 局限性 |
|---|---|---|---|
| 高层次概览 | 低 | 执行摘要 | 缺乏技术细节 |
| 标准部署 | 中 | 开发团队 | 可能忽略安全细节 |
| 详细基础设施 | 高 | 运维与安全 | 长期维护困难 |
| 逻辑混合 | 混合 | 架构规划 | 无法反映物理限制 |
维护图表 🔄
部署图是一个动态文档，需要持续维护才能保持有用。应将其视为代码对待。
自动更新
尽可能从基础设施代码生成图表。这能确保视觉呈现与实际状态一致。
- 基础设施即代码： 使用脚本解析资源定义。
- 监控数据： 与监控工具集成，以显示活跃节点。
文档标准
建立命名和标注的标准。一致性可降低任何阅读图表者的认知负担。
- 命名规范： 使用
env-role-id（例如，生产-web-01). - 图例： 始终包含一个图例，解释符号和颜色的含义。
- 元数据： 包括最后一次更新的日期和作者。
混合建模结论 🏁
在单一部署图中对云系统和本地系统进行建模是现代架构中必不可少的技能。它弥合了物理硬件与虚拟服务之间的差距。通过遵循标准规范，使用清晰的构造型，并保持严格的安全部署边界，您将创建一份既能满足技术需求又能满足业务需求的文档。这种方法确保从首席技术官到初级开发人员的每个人都能够理解系统架构。请记住，要保持图表的更新，并聚焦于您基础设施的物理现实。 🚀
