AI 协助说明： 本页由 Codex 协助核验和修复站内链接；正文的技术事实和适用范围未因本次修改而改变，仍以文中来源及当前官方文档为准。
术语修订（2026-09-07，Agent：Codex）：同步 Taint / Toleration 的正文与导航名称，保留原有中文关系说明。此次运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
这组文档不按名词堆叠，而是按读者解决问题时的路径组织：先建立架构，再进入安装、工作负载、网络、安全与运维专题。相近文章会明确区分为“总览 / 资源模型 / 数据链路 / 深读”，避免在多篇文章中重复同一段原理。
官方入口：Kubernetes 中文文档 · 官方教程
从哪里开始
| 你的目标 | 建议阅读顺序 |
|---|---|
| 第一次系统学习 Kubernetes | 系统化学习路线 → 架构全景 → 工作负载与网络专题 |
| 理解一次请求或一次 Pod 创建 | 控制平面组件 → 节点组件 → 网络全景 |
| 自建或维护集群 | Kubeadm 概念 → 单控制面 / HA 搭建 → 升级 |
| 排查服务访问失败 | 网络全景 → Service 转发链路 → Calico 流量走向 |
| 设计发布、扩缩容和节点维护 | Deployment → 滚动更新 → 优雅退出 → 调度与驱逐 |
1. 基础架构与组件
先看宏观协作关系，再按需进入单个组件的配置和排障。
- 系统化学习路线：学习顺序和练习方向。
- Kubernetes 架构全景：组件分类与全局地图。
- 控制平面组件详解：API Server、etcd、Scheduler、Controller Manager 如何协作。
- 节点组件详解：kubelet、kube-proxy 与容器运行时的职责边界。
- API Server 深读、Kubelet 深读、containerd 深读。
2. 集群安装、证书与生命周期
安装文章按部署形态区分，不把单控制面、HA 和云厂商基础设施步骤混在一起。
- Minikube 使用教程：本地学习与试验。
- Kubeadm 详解：
init、join、upgrade等命令的角色。 - 使用 Kubeadm 搭建 Kubernetes 集群：单控制面与高可用：共用前置条件、单控制面路径，以及稳定入口、堆叠式 / 外置 etcd、控制平面 join 与 Worker join 的 HA 差异。
- GCP 与 AWS 高可用实践：云网络、负载均衡、IAM 与实例组差异；通用 kubeadm 步骤以前一篇为准。
- 证书、kubeconfig 与 API Server：TLS、SAN 与
controlPlaneEndpoint。 - 集群版本升级方案：升级前检查、drain、插件兼容性与恢复。
3. 工作负载、调度与存储
这一组区分“声明什么资源”“如何更新副本”和“Pod 可以落在哪里”。
- Deployment 详解：Deployment、ReplicaSet 与资源配置。
- 什么时候用 Service，什么时候用 Deployment：对象选择，而非流量实现细节。
- rollout 与 rolling update：revision、暂停、重启和回滚。
- HPA：指标与水平扩缩容控制循环。
- 调度、Taint、Toleration、Affinity 与 Eviction：节点选择、专用节点池、PDB 与维护 drain。
- Pod 优雅退出：摘流量、
preStop、TERM 和连接排空。 - PersistentVolume 与 PVC：存储抽象、绑定与回收。
4. 服务发现与网络
网络文章按分层拆开：DNS 负责名字、Service 负责稳定入口、数据面负责 Endpoint 转发、CNI 负责到达最终 Pod IP。
- 网络全景：从 DNS、Service 到 Calico：跨层心智图与排查入口。
- Service 详解：Service API、类型、端口和流量策略。
- Service 转发链路：ClusterIP、EndpointSlice、DNAT 与 kube-proxy 数据面。
- CoreDNS 与 kube-proxy：分别深入 DNS 和节点转发实现。
- Calico 流量走向：跨节点路由、封装、策略与 eBPF。
- NetworkPolicy：Pod 级入/出站访问控制。
- 网络与运行时选型速记：Service、RuntimeClass、Overlay 与 kube-proxy 的选型备忘。
5. 入口、安全与身份
- Ingress 详解：Ingress 资源与 Controller。
- Ingress、证书与 cert-manager：业务 TLS、Issuer/Certificate 与续期边界。
- RBAC 与 kubeconfig：身份、Role、Binding、最小权限与 Forbidden 排查。
6. 可观测性、工具与交付
- Kubernetes 可观测性体系：指标、日志、Trace 和审计。
- Kubectl 速查手册：日常查询、变更与排障命令。
- port-forward 命令详解：临时调试连接的工作原理与安全边界。
- Helm 核心概念：Chart、Release、values 与模板模型。
- Helm 常用命令：安装、升级、回滚和仓库操作的 CLI 手册。
阅读与维护约定
- 总览页只保留分层模型、选型和排查入口；逐包路径、对象字段和命令细节归入对应专题。
- 速查文档与概念文档分开：前者便于执行，后者解释为什么；两者互相链接而不复制整段内容。
- 涉及版本、CNI、云厂商或安全策略的命令必须以当前集群版本和官方文档为准，示例中的地址、网段和名称均不可直接用于生产。