1. Helm 与网络拓扑概述
在 Kubernetes 集群中，网络拓扑的声明式管理长期依赖 YAML 清单的手工维护。Helm 作为 Kubernetes 的包管理工具，通过 Chart 结构、模板引擎和 values.yaml 参数化机制，将网络拓扑的配置从“硬编码”提升为“可复用、可校验、可追溯”的工程化交付物。本章从 Helm 在 K8s 网络管理中的角色出发，梳理 values.yaml 与网络拓扑的关系，并明确课程目标与前置知识。
1.1 Helm 在 K8s 网络管理中的角色
Helm 并非网络插件（如 Calico、Cilium），也不是 Service Mesh 控制面；它解决的是网络资源的编排与交付问题。在典型的 K8s 网络场景中，Helm 承担以下职责：
| 角色 | 说明 | 典型资源 |
|---|---|---|
| 参数化模板 | 将 Service、Ingress、NetworkPolicy 等网络对象的字段抽象为 values.yaml 变量 | Service.ports、Ingress.hosts、NetworkPolicy.ingress |
| 多环境复用 | 通过不同的 values 文件（values-dev.yaml / values-prod.yaml）切换网络拓扑 | ClusterIP vs LoadBalancer、Ingress 域名、网络策略白名单 |
| 依赖管理 | 通过 Chart 依赖自动部署网络中间件（如 Ingress Controller、Gateway API CRD） | nginx-ingress、cert-manager、metallb |
| 版本化发布 | helm upgrade 记录每次网络拓扑变更的 revision，支持回滚 | helm list、helm rollback |
| Schema 校验 | 通过 values.schema.json 在安装/升级前拦截非法网络参数 | 端口范围、CIDR 格式、协议枚举 |
1.2 values.yaml 与网络拓扑的关系
values.yaml 是 Helm Chart 的“控制面板”。网络拓扑的每个关键节点——从 Service 类型到 NetworkPolicy 规则——都在 values.yaml 中有对应的参数路径。以下是一个典型的网络拓扑 values 结构：
# values.yaml 网络拓扑相关片段
global:
network:
dnsDomain: cluster.local
podCIDR: "10.244.0.0/16"
serviceCIDR: "10.96.0.0/12"
service:
type: ClusterIP # ClusterIP | NodePort | LoadBalancer
ports:
- name: http
port: 80
targetPort: 8080
protocol: TCP
ingress:
enabled: true
host: app.example.com
tls:
enabled: true
secretName: app-tls
networkPolicy:
enabled: true
ingressRules:
- from:
- namespaceSelector:
matchLabels:
name: monitoring
ports:
- port: 9090
protocol: TCP
values.yaml 中的网络参数与最终生成的 K8s 资源之间存在一对多的映射关系。例如，一个 service.type: LoadBalancer 可能同时触发 Service 资源、Cloud Provider 的 LB 配置、以及 ExternalName 的 DNS 记录。这种映射的准确性，正是 Schema 校验要保障的核心。
1.3 课程目标与前置知识
本课程面向已经掌握 Helm 基础操作、但希望深入理解 values.schema.json 校验机制和 Helm 发布差异分析的工程师。完成本课程后，你将能够：
- 设计网络拓扑专用的 values.schema.json，对 CIDR、端口范围、协议枚举等字段做精确校验
- 诊断 helm install/upgrade 过程中因网络参数错误导致的校验失败
- 分析 helm diff 输出，识别网络拓扑变更对集群连通性的潜在影响
- 构建可复用的网络拓扑 Chart 模板，支持多环境差异化部署
前置知识要求：
| 领域 | 具体要求 |
|---|---|
| Kubernetes 网络基础 | 理解 Service、Ingress、NetworkPolicy、Pod 网络模型 |
| Helm 基础操作 | 能使用 helm install/upgrade/rollback，理解 Chart 结构 |
| YAML/JSON 语法 | 熟悉 YAML 缩进规则、JSON Schema 基本类型 |
| 命令行工具 | 能使用 helm diff plugin、kubectl 进行调试 |
1.4 Helm 网络拓扑管理全景图
下图展示了 Helm 在 K8s 网络拓扑管理中的核心流程：从 values.yaml 参数化输入，经过模板渲染、Schema 校验，最终生成可发布的网络资源集合。