从零搭建实战索引：按目标选出下一套要搭的环境，而不是在 36 篇教程里逐个翻

使用方式

这页把教程分支的 build-* 页面按“搭什么”重新分组。每组先给最小可用路径，再给生产化补充页；同一组内按依赖顺序排列，前一篇的产物通常是后一篇的输入。

• 第一次搭：先读组内前 2–3 篇，完成一个能启动、能验证、能清理的最小环境。
• 准备上线：补同组的可用性、备份、可观测性和安全页，不要跳过验证章节。
• 排障时：先回到对应教程的「验证」和「常见问题」，再进入排障分支，不要直接改生产参数。

每篇教程都应在一次性环境或测试集群执行；涉及存储、证书和密钥的步骤，先在本地验证恢复路径。

Kubernetes 基础与网络

• build-k8s-cluster — 从零搭建 Kubernetes 集群。
• build-cilium-network — 用 Cilium 搭建 Kubernetes 网络与可观测性。
• build-istio-mesh — 从零搭建 Istio 服务网格。
• build-external-dns — 用 ExternalDNS 自动维护 DNS 记录。
• build-cert-manager — 用 cert-manager 自动签发和续期证书。

交付与 GitOps

• build-argocd-gitops — 用 Argo CD 搭建 GitOps 持续交付。
• build-flux — 搭建 Flux GitOps 持续交付。
• build-argo-rollouts — 用 Argo Rollouts 做渐进式发布。
• build-argo-workflows — 搭建 Argo Workflows 工作流引擎。
• build-tekton — 搭建 Tekton CI/CD 流水线。
• build-cicd-pipeline — 搭建 CI/CD 流水线。

可观测性

• build-observability-stack — 搭建可观测性基础栈。
• build-prometheus-ha — 搭建 Prometheus 高可用与长期存储。
• build-loki-ha — 搭建 Loki 高可用日志平台。

数据与消息

• build-kafka-cluster — 从零搭建 Kafka 集群。
• build-kafka-connect — 搭建 Kafka Connect 数据同步管道。
• build-clickhouse — 搭建 ClickHouse 分析集群。
• build-starrocks — 搭建 StarRocks 分析集群。
• build-postgresql-ha — 搭建 PostgreSQL 高可用集群。
• build-postgresql-pitr — 搭建 PostgreSQL 时间点恢复（PITR）。
• build-mysql-ha — 搭建 MySQL 高可用集群。
• build-mongodb-replica-set — 搭建 MongoDB 副本集。
• build-redis-cluster — 从零搭建 Redis Cluster。
• build-temporal — 搭建 Temporal 工作流集群。
• build-airflow — 搭建 Airflow 调度平台。
• build-minio — 搭建 MinIO 对象存储。
• build-ceph — 用 Rook 搭建 Ceph 存储。

安全、密钥与策略

• build-vault — 从零搭建 HashiCorp Vault 密钥管理。
• build-openbao — 搭建 OpenBao 密钥管理。
• build-keycloak-sso — 用 Keycloak 搭建统一单点登录。
• build-sealed-secrets — 用 Sealed Secrets 管理 Git 中的密钥。
• build-gatekeeper — 搭建 OPA Gatekeeper 策略中心。
• build-kyverno-policies — 用 Kyverno 建立 Kubernetes 策略基线。
• build-falco — 搭建 Falco 运行时安全检测。

镜像与备份

• build-harbor — 搭建 Harbor 企业镜像仓库。
• build-velero-backup — 用 Velero 搭建 Kubernetes 备份与恢复。

选型建议

• 只想验证 Kubernetes 基础：build-k8s-cluster → build-cilium-network → build-cert-manager。
• 要做 GitOps：build-argocd-gitops 或 build-flux，再用 build-argo-rollouts 做渐进式发布。
• 要搭数据平台：先 build-postgresql-ha 或 build-mysql-ha，再按需加 build-kafka-cluster、build-clickhouse、build-starrocks。
• 要补安全基线：build-openbao/build-vault → build-sealed-secrets → build-gatekeeper/build-kyverno-policies → build-falco。

常见误区

1. 把“容器 Up”当成“平台可用”。每篇教程的验证章节都要求检查副本、探针、存储挂载或实际读写。
2. 跳过证书和密钥的恢复演练。自动签发不等于能恢复，必须验证 CA、备份和轮换路径。
3. 在生产集群直接照抄本地单节点参数。存储副本、资源请求、反亲和和备份策略都要按生产规模重算。

参考链接

• Kubernetes: Production environment
• CNCF: Cloud Native Landscape
• PostgreSQL: High Availability

读完自测

1. 搭建 Kubernetes 集群后，为什么不能只用 kubectl get nodes 判断环境可用？
2. GitOps 方案中，Argo CD 和 Flux 的选型应优先比较哪些能力？
3. 搭建数据库高可用时，为什么必须先验证备份恢复，再接入业务？

相关条目

• migration-index — 迁移与升级索引
• lab-learning-path — 用故障演练验证搭建结果
• technology-selection-map — 技术选型决策树
• k8s-production-checklist — Kubernetes 上线检查