跳到主要内容

阅读路线

文档分成三条阅读线：先看项目和架构，再按命令复现，最后回到代码和排障记录理解细节。

快速理解项目​

适合先建立全局印象：

  1. 项目介绍
  2. 架构设计
  3. 后续演进

看完后应该能说清楚：

  • Terraform、kubeadm、WireGuard、Cilium 分别负责哪一层。
  • 为什么当前阶段先用低成本双云双集群。
  • 完全体会如何扩展到高可用、GitOps、监控和日志。

从零复现项目​

适合边看边执行：

  1. 环境准备
  2. 快速开始
  3. 从零实现过程
  4. 根目录 plan.md

复现时每个阶段都要保留命令输出和问题记录。遇到不通时不要跳步骤，按 Terraform、SSH、WireGuard、Kubernetes、Cilium、Cluster Mesh 的顺序收敛。

审阅代码细节​

适合理解实现边界：

  1. 代码走读
  2. Terraform 模块说明
  3. 阿里云部署
  4. 腾讯云部署
  5. Kubernetes 与 Cilium

重点看这些问题：

  • root module 为什么只做编排，不做系统初始化。
  • generated/*/terraform-output.json 为什么是 Terraform 和脚本的边界。
  • WireGuard、Cilium tunnel、Cluster Mesh 分别解决哪一层网络问题。
  • Makefile target 如何把命令顺序固定下来。

排障阅读路线​

如果环境已经创建但没有跑通，按下面顺序看：

  1. 问题定位与实战经验
  2. 故障排查
  3. 安全与成本

排障记录建议包含：

现象
影响范围
已执行命令
命令输出摘要
判断依据
下一步处理
最终结论

可以用 AI 辅助整理假设和命令清单，但每个判断都要回到实际输出验证。