云与容器化部署的PlantUML实践指南

云服务图标集成

现代云原生架构中，使用标准化的云服务图标能显著提升部署图的可读性。PlantUML通过集成AWS/Azure/GCP等主流云平台的图标库，让架构图更专业。

@startuml
!include <aws/common>
!include <aws/Compute/EC2>
!include <azure/Compute/virtualmachine>

node "AWS生产环境" <<EC2>> {
  [订单服务] <<artifact>> 
}

node "Azure开发环境" <<virtualmachine>> {
  [用户服务v1.2] <<artifact>>
}

cloud "GCP备份中心" {
  [数据库副本] <<artifact>>
}
@enduml

实践建议：

1. 通过!include引入官方图标库（需PlantUML 1.2020+版本）
2. 云厂商图标通常作为节点类型标记（<<EC2>>）
3. 混合云场景建议用不同颜色区分不同云平台

Kubernetes部署简化

容器编排系统的复杂拓扑可以通过PlantUML进行抽象表达，重点展示Pod、Service等核心概念的关系。

@startuml
skinparam nodesep 50

folder "K8s集群" {
  node "Worker节点1" {
    [frontend-pod] <<pod>> as pod1
    [redis-pod] <<pod>> as pod2
  }
  
  database "MySQL" <<statefulset>> as db

  pod1 -[#blue]-> pod2 : Service\nClusterIP
  pod2 .[#green]> db : 持久化存储
}

cloud "外部流量" as ext
ext --> pod1 : Ingress
@enduml

关键元素：

• <<pod>>：标注容器组
• <<statefulset>>：有状态工作负载
• 箭头类型：实线表示Service访问，虚线表示存储等特殊依赖

运维提示：

• 使用不同颜色区分网络流量类型（蓝色=内部服务，绿色=存储）
• 对生产环境建议标注副本数（如(replicas=3)）

混合环境建模

企业级部署常涉及本地数据中心与多云资源的混合连接，需要清晰表达网络边界和连接方式。

@startuml
left to right direction

rectangle "本地数据中心" {
  node "物理服务器" <<baremetal>> as srv1 {
    [传统ERP系统] <<artifact>>
  }
}

rectangle "公有云" {
  cloud "AWS VPC" {
    node "EC2实例" <<EC2>> as ec2 {
      [微服务网关] <<artifact>>
    }
  }
}

srv1 -[#red,dashed]-> ec2 : VPN专线\n(10Gbps)
@enduml

连接方式表达：

• 实线：常规网络
• 虚线（dashed）：加密/专线连接
• 颜色区分：红色=跨安全域，黑色=同安全域

架构建议：

1. 明确标注混合环境的网络延迟要求
2. 对跨云通信建议标注加密方式（如IPSec）
3. 使用注释说明数据同步机制（如// 每日增量同步）

实用技巧

1. 版本控制：通过颜色区分不同环境

   node "生产环境" #LightGreen {
     [服务v1.0] <<artifact>>
   }
   node "预发环境" #LightBlue {
     [服务v1.1-RC2] <<artifact>>
   }

2. 资源标注：直接显示硬件配置

   node "DB服务器" <<EC2>> {
     [MySQL主库] <<artifact>>
     note right: 8vCPU/32GB RAM\nEBS 500GB
   }

3. 动态部署：展示滚动更新过程

   @startuml
   group 滚动更新流程 {
     [v1.0 Pod] --> [v1.1 Pod] : 逐步替换
     [v1.1 Pod] --> [健康检查] : 验证通过后\n继续下一批
   }
   @enduml

通过合理运用这些可视化技术，PlantUML能有效降低云原生架构的认知复杂度，特别适合在文档、运维手册和架构评审中使用。建议团队建立统一的绘图规范，确保图表风格的一致性。