1. 课程导论：Operator SDK 概述、集成平台门户概念、集群资源拓扑展示的价值
1.1 课程背景与目标
本课程面向云原生平台工程师、SRE 及 Kubernetes 应用开发者，旨在系统讲解如何利用 Operator SDK 构建一个面向多集群的集成平台门户，并在此基础上实现集群资源拓扑的实时可视化。通过本课程，你将掌握从 Operator 脚手架搭建、自定义资源设计、控制器逻辑编写，到前端门户集成与拓扑数据聚合的完整链路。
核心目标： 使学员具备独立开发“平台级 Operator”的能力，能够将分散的集群资源抽象为统一的门户视图，并通过拓扑图快速定位故障与依赖关系。
1.2 Operator SDK 概述
Operator SDK 是 Red Hat 与社区联合推出的框架，用于简化 Kubernetes Operator 的开发。它提供了脚手架生成、控制器编排、Webhook 管理等核心能力，让开发者无需从零编写底层 API 交互代码。
| 特性 | 说明 | 本课程使用场景 |
|---|---|---|
| 脚手架生成 | 通过 operator-sdk init 快速创建项目骨架 |
初始化门户后端 Operator 项目 |
| API 定义 | 基于 CRD（Custom Resource Definition）声明资源模型 | 定义 PortalTopology 自定义资源 |
| 控制器逻辑 | 使用 Reconciler 模式实现期望状态与当前状态的调和 | 监听集群资源变化，更新拓扑数据 |
| Webhook 管理 | 支持准入控制与默认值注入 | 校验门户配置的合法性 |
版本提示： 本课程基于 Operator SDK v1.36+ 与 Go 1.22+，兼容 Kubernetes 1.28+ 集群。建议使用
golang:1.22 作为基础镜像。
1.3 集成平台门户概念
集成平台门户（Integrated Platform Portal）是一个统一的前端界面，用于聚合多集群的运维数据、资源状态、监控指标与操作入口。它通常包含以下核心模块：
- 集群概览： 展示集群健康度、节点数量、CPU/内存水位。
- 资源目录： 按命名空间、工作负载、存储、网络分类浏览资源。
- 拓扑视图： 可视化展示资源之间的依赖关系与调用链路。
- 操作面板： 提供扩缩容、滚动更新、日志查看等快捷操作。
在本课程中，我们将使用 Operator SDK 构建一个 Topology Operator，它负责从多个集群收集资源关系数据，并通过自定义资源暴露给前端门户消费。
1.4 集群资源拓扑展示的价值
集群资源拓扑展示是将 Kubernetes 中分散的资源（Pod、Service、Ingress、PVC 等）及其依赖关系以图形化方式呈现。其核心价值体现在以下三个维度：
| 维度 | 传统方式痛点 | 拓扑展示优势 |
|---|---|---|
| 故障定位 | 需要手动追踪多个 kubectl get 命令 |
一眼看出 Pod 与 Service 的关联，快速定位断链 |
| 变更影响分析 | 难以评估更新一个 Deployment 会影响哪些上游服务 | 拓扑图清晰展示上下游依赖，辅助变更评审 |
| 资源审计 | 大量 YAML 文件难以梳理整体架构 | 可视化呈现集群资源全貌，发现闲置或异常资源 |
常见误区： 拓扑展示不是简单的“画图”，而是需要 Operator 持续监听资源事件、维护关系图谱、处理资源删除与重建的边界情况。本课程将重点讲解这些工程化细节。
1.5 课程知识体系与学习路径
本课程共 30 章，分为四个阶段：
- 基础篇（第 1-8 章）： Operator SDK 环境搭建、CRD 设计、控制器基础、多集群连接。
- 核心篇（第 9-18 章）： 拓扑数据模型设计、资源关系发现算法、增量更新机制、缓存优化。
- 门户集成篇（第 19-25 章）： 前端拓扑渲染引擎、WebSocket 实时推送、权限模型、API 网关集成。
- 进阶篇（第 26-30 章）： 大规模集群性能调优、拓扑导出与审计、生产级部署与监控。
1.6 预备知识与环境要求
为获得最佳学习体验，请确保已掌握以下技能并准备好运行环境：
- Kubernetes 基础： 熟悉 Pod、Service、Deployment、CRD 等核心概念。
- Go 语言基础： 了解结构体、接口、goroutine 与 channel 的基本用法。
- 环境要求：
- Go 1.22+
- Docker 24+
- Kubernetes 集群（1.28+，推荐 kind 或 minikube）
- Operator SDK CLI（v1.36+）
快速验证： 在终端执行
operator-sdk version 确认 CLI 已正确安装。若未安装，可参考 https://sdk.operatorframework.io/docs/installation/ 完成安装。