Kubernetes 官方文档

一、网站简介

Kubernetes 官方文档（kubernetes.io/docs/）是学习和管理 Kubernetes 容器编排平台的终极权威指南，由云原生计算基金会（CNCF）托管维护。它系统性地覆盖了 K8s 的核心概念、架构原理、工作负载管理、服务发现、存储编排、安全策略及运维最佳实践，并提供简体中文等 10 余种语言的完整翻译，是目前全球容器编排领域访问量最大的技术文档站点。

二、公司背景

Kubernetes 源自 Google 内部使用了十余年的 Borg 集群管理系统，由 Joe Beda、Brendan Burns 和 Craig McLuckie 于 2014 年开源。2015 年 Google 将其捐赠给新成立的 CNCF（Cloud Native Computing Foundation），成为该基金会第一个毕业项目。Kubernetes 已成为云原生技术栈的核心，全球所有主流云厂商（AWS EKS、Azure AKS、Google GKE、阿里云 ACK 等）均提供托管的 K8s 服务。文档由来自全球数百家公司的社区贡献者共同维护，CNCF 提供翻译与发布基础设施。

三、核心功能

• 核心概念详解：系统阐述 Pod、Service、Deployment、ReplicaSet、StatefulSet、DaemonSet、Job、CronJob、ConfigMap、Secret、Ingress、PVC 等所有核心资源对象的定义、行为规范、YAML 配置示例及使用场景。
• 架构与组件文档：深入解析 kube-apiserver、etcd、kube-scheduler、kube-controller-manager、kubelet、kube-proxy 等控制平面与节点组件的职责、通信机制和扩展接口（CNI、CSI、CRI）。
• 任务型指南（Tasks）：按实际操作归类，如“配置 Pod 的资源请求与限制”、“设置 Ingress 进行 HTTP(S) 路由”、“使用 NetworkPolicy 实现网络隔离”、“升级集群版本”、“备份 etcd”等，是日常运维工作的操作手册。
• API 参考文档：完整的 Kubernetes REST API 规范，包含所有资源类型的 API 版本、字段说明、请求/响应示例，支持通过 Swagger UI 在线交互式浏览。
• kubectl 命令参考：详述 kubectl 命令行工具的所有子命令、全局标志和输出格式，包括 get、describe、logs、exec、apply、rollout、top 等高频命令的完整用法。
• 安装与部署指南：覆盖 kubeadm、minikube、kind、kops、Kubespray 等多种集群部署工具的安装步骤和最简配置，适配本地学习、测试环境到生产级高可用集群。

四、网站特点

• 中文翻译高度完善：kubernetes.io/zh-cn/ 提供了几乎所有核心文档的简体中文翻译，翻译质量经过社区严格审核，术语统一且语句流畅，国内开发者阅读无障碍。
• 版本管理精细：文档右上角提供版本选择器，支持从 v1.22 至最新的 v1.32+ 版本切换，每个页面的内容严格对应所选版本的 API 规范和行为。
• 互动式教程（Tutorials）：提供 Katacoda 在线实验环境（已迁移至 Killercoda），读者可直接在浏览器中操作真实的 K8s 集群完成教程任务。
• 社区贡献友好：每个页面右侧提供“Edit this page”链接，可直接跳转 GitHub 提交修改 PR，文档内容的开放性和更新速度远超传统商业产品文档。

五、适用人群

• 云原生运维工程师（SRE）：负责 K8s 集群的部署、扩缩容、升级、监控和故障排查，官方文档是其日常工作中最频繁查阅的参考源。
• DevOps 工程师：设计和维护 CI/CD 流水线，使用 K8s 作为应用部署平台，需要查阅各种资源对象的配置字段和 API 规范。
• 应用开发工程师：理解 Pod、Service、ConfigMap、Secret 等基础概念，编写符合 K8s 规范的 Deployment YAML 配置文件和 Helm Chart。
• 平台工程师：基于 K8s 构建内部开发者平台（IDP），需要使用 CRD 扩展 API、编写 Operator、配置准入控制器和 RBAC 策略。

六、应用场景

• 集群故障排查：Pod 一直处于 Pending 状态，查阅“Pod 生命周期”和“调度器”文档理解 Pod 被调度的条件，结合 kubectl describe 输出定位是资源不足还是节点选择器不匹配。
• 应用滚动更新：需要零停机更新线上应用，翻阅 Deployment 的“滚动更新策略”章节，配置 maxSurge 和 maxUnavailable 参数，并通过 rollout status 监控更新进度。
• 安全策略加固：按照“Pod 安全标准”和“NetworkPolicy”文档为生产命名空间配置 Pod 安全上下文（非 root 运行、只读根文件系统）和网络隔离规则。
• 集群容量规划：使用“资源指标管道”文档部署 Metrics Server，结合 HPA（水平自动扩缩）文档配置基于 CPU/内存的自动扩缩策略，确保业务高峰期的服务质量。

七、常见问题（FAQ）

Q：国内能否直接访问 Kubernetes 官方文档？
A：可以。kubernetes.io 在国内网络环境下可正常访问，中文文档页面加载流畅。部分引用的外部资源（如 Google 的镜像）可能加载较慢，但核心文档浏览不受影响。

Q：Kubernetes 文档有中文版吗？翻译质量如何？
A：有，且翻译质量很高。kubernetes.io/zh-cn/ 提供了完整的中文文档，由 CNCF 下的中文本地化 SIG（特别兴趣小组）维护，术语统一，同步更新及时，是国内开发者学习 K8s 的首选资源。

Q：学习 Kubernetes 需要先掌握 Docker 吗？
A：根据官方文档的学习路径建议，理解容器（Docker/containerd）的基本概念有助于更快上手 Kubernetes，但并非绝对必要。官方入门教程会从零开始引导，初学者可同步学习 Docker 和 K8s。

Q：Kubernetes 多久发布一个新版本？如何升级？
A：Kubernetes 每年发布 3 个版本（约 4 个月一个周期）。官方文档的“版本偏差策略”规定 kube-apiserver、kubelet 等核心组件需按特定顺序升级，且集群版本偏差不得超过一个次版本号。升级前务必查阅对应版本的 Release Notes 和升级指南。

八、类似网站

• Docker Swarm 文档：Docker 原生的轻量级容器编排工具，适合小规模集群和简单场景，与 K8s 功能重叠但复杂度更低。
• K3s 官方文档：Rancher 出品的轻量级 K8s 发行版，专为边缘计算和 IoT 场景设计，文档简洁实用，部署仅需一条命令。
• KubeVela 官方文档：基于 OAM（开放应用模型）的现代化应用交付平台，文档聚焦于应用抽象层，降低直接使用 K8s 的复杂度。