kubernetes-handbook

rootsongjc活跃维护 有专家点评

系统讲解 Kubernetes 架构与云原生生态的中文手册,覆盖容器编排、服务网格到 AI 原生基础设施的构建实践。

Kubernetes 架构与生态:从云原生到 AI 原生基础设施的构建指南

v2026.11.10发布于 2026-11-10 13:27 UTC11,646star +6 / 7 天2,935fork同步于 2026-11-10 23:29 UTC

专家点评

上手难度:入门更新于 2026-11-11

中文 Kubernetes 体系化读物,用来补架构概念和生态全景,不产出任何可运行组件

适用场景

  • 团队新人上手 K8s 前的统一读物:比零散博客成体系,比官方文档更贴国内实践语境,省掉自己拼学习路径的时间
  • 设计服务网格或边缘方案前的横向扫盲:需要快速判断 Istio、Serverless 这些方向各自解决什么问题,再决定要不要引入
  • 做内部培训材料或技术分享底稿:CC BY-NC-SA 允许非商业改编,比从零写 PPT 快
  • 排查概念性困惑时当索引用:比如 Pause 容器、ConfigMap 更新语义这类问题,先看它怎么讲,再去官方文档确认细节

踩坑

  • 克隆下来发现没有可执行程序:这是 GitBook 文档仓库,不是工具也不是 demo 环境,想要能跑的东西得另找
  • 跟着书中操作章节做实验时容易卡在环境差异上:issue 里 flannel 网络未启用、kube-dns 无法解析 service 名这类问题被反复提出,说明按步骤复现时对版本和网络环境敏感,别指望照抄就能通
  • 商业场景直接引用内容会撞协议:CC BY-NC-SA 4.0 禁止商业使用,公司内部收费培训或对外付费材料需要另行处理授权

同类对比

想要官方权威且随版本更新的内容,直接看 kubernetes.io 文档;想要可动手的实验环境,用 kind、minikube 或 k3s 起集群,这本手册只作为概念补充。

怎么上手

由 README 提炼,执行前请确认
git clone https://github.com/rootsongjc/kubernetes-handbook.git
硬件要求按 README 说明

README 未说明

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

一本中文开源的 Kubernetes 实战手册,从容器编排讲到服务网格与 AI 原生基础设施

系统讲解 Kubernetes 架构与云原生生态的中文手册,覆盖容器编排、服务网格到 AI 原生基础设施的构建实践。

核心能力

  • 系统讲解 Kubernetes 核心架构与关键组件
  • 覆盖服务网格、Serverless、边缘计算等生态领域
  • 基于 Kubernetes v1.31+ 持续更新概念与 API
  • 提供在线网站阅读与 Release 页面 PDF 下载
  • 以经验总结和最佳实践为主的实战导向内容

容易踩的坑

这是电子书文档仓库而非可运行软件,克隆后没有可执行程序;内容采用 CC BY-NC-SA 4.0 协议,禁止商业使用

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v2026.11.10
  1. v2026.11.10最新正式版2026-11-10 · 2026-11-10 13:27 UTC

    本次发布距上一版本 v2025.11.05 已有一年,聚焦云原生架构演进、Kubernetes 新特性与 AI 基础设施,全书内容结构与图表体系全面升级。

    主要新增内容

    • DRA(动态资源分配)文档 新增 Kubernetes Dynamic Resource Allocation 专题,覆盖 GPU 等加速设备的动态分配与调度,面向 AI 工作负载场景。
    • 无 Sidecar 服务网格架构对比 新增 Istio Ambient、Cilium、Linkerd 等无 Sidecar 架构的原理对比与选型建议,紧跟服务网格的扁平化演进趋势。
    • Downward API、投射卷与临时卷专题 详细介绍 Downward API 的使用方式、投射卷的多种来源,以及临时卷的类型与资源管理策略。
    • 自定义 Pod 自动伸缩 新增 custom-autoscaler 实践文章,讲解超越 HPA 的自定义伸缩方案。
    • Kubernetes AI 工作组介绍 新增 Kubernetes 社区 AI 工作组文档,涵盖标准化、网络治理与生产级集成方向。
    • 矢量图解体系升级 新增云原生角色分工、应用架构分层、后 Kubernetes 时代演进、Helm 3 架构等一系列原创矢量图,关键概念一图读懂。

    重要修订与优化

    • 存储章节更新:补充存储特性说明与使用示例。
    • 章节结构优化:服务网格与存储章节调整权重、描述与索引结构,补充别名便于检索;引入 part 层级,全书骨架更清晰。
    • AI Native 章节重构:HAMi 本地推理文档与脚本面向 macOS 重构,KAITO、KubeFleet 等 AI 推理基础设施内容增强。
    • 书单页更新:收录多本云原生书籍的翻译进度与导读信息。

    内容质量提升

    • 补全缺失的 front matter 描述字段,修复多处失效链接。
    • 全站内链统一中文语言前缀,保证访问一致性。
    • 域名迁移收尾:所有 cloudnativecn.com 引用统一替换为 cloudnative.jimmysong.io。
    • 移除指向不存在资源的封面字段,更新 hello-world 示例镜像并补充国内镜像说明。
    • 术语格式统一,SVG 图片迁移至 CDN 并统一远程引用。
  2. v2025.11.08v2025.11.052025-11-07 · 2025-11-07 17:11 UTC
    查看更新说明

    本次更新聚焦 AI Native、边缘计算、安全合规等 Kubernetes 生态热点,内容深度与实用性全面提升。

    主要新增内容

    • AI Native 专章完善 系统补充了 AI Native 架构、推理优化、模型部署、推理网关等前沿主题,覆盖从云原生到 AI Native 的技术演进与落地实践。
    • 边缘计算专题扩展 增加了主流边缘方案与落地案例,包括 K3s、OpenYurt、SuperEdge 等,帮助读者理解 Kubernetes 在边缘场景的应用。
    • 安全与合规专题增强 补充了 Kubernetes 安全最佳实践、合规建议,提升集群安全防护能力。
    • 多集群与服务网格内容完善 介绍了多集群管理、服务网格最新进展与实战经验。

    重要修订与优化

    • 架构与原理章节重构 理论深度提升,案例更丰富,便于系统性学习 Kubernetes 架构设计。
    • 控制器与扩展机制优化 补充最新 API 扩展、Operator 开发模式,紧跟社区技术演进。
    • 开发者指南升级 增加源码分析、实战案例,助力开发者深入理解 Kubernetes 内部机制。

    内容质量提升

    • 全面校对 Front Matter,统一格式与必填字段。
    • 优化图片引用与尺寸,提升页面加载性能。
    • 增强章节间逻辑衔接,补充过渡段落与术语解释。
    • 补充参考文献与外链,提升内容权威性与可查性。
  3. v2025.08.042025-08-04 · 2025-08-04 11:01 UTC
    查看更新说明

    本次更新对项目进行了全面升级与优化,主要包括:

    • 🚀 前端架构切换至 Hugo:全面采用 Hugo 渲染静态页面,原 GitBook 架构已废弃,提升性能与可维护性。
    • 🔗 修复失效链接与图片资源:修复了部分页面中无法访问的链接及图片显示问题,提升阅读体验。
    • 🛠 优化 Hugo Front Matter:重构 front matter 元信息结构,增强对 Hugo 主题的适配能力,便于分类与前端展示。
    • 📄 重新导出 PDF 文档:使用 Pandoc 与 LuaLaTeX 全面优化排版效果,提供更专业的 PDF 格式离线版本。
    • 📦 内容更新至最新 Kubernetes 版本:同步最新 Kubernetes 特性,更新过时内容,确保读者获取最新实践。
  4. v20220301v2022.03.012022-03-01 · 2022-03-01 14:31 UTC
    查看更新说明

    该版本更新包括:

    • 该版本更新了封面设计
    • 修复了所有破损链接
    • 删除了部分过时内容
  5. v20210409四周年纪念版2021-04-09 · 2021-04-09 14:21 UTC
    查看更新说明

    Kubernetes Handbook 四周年纪念版,详见发布说明。

    在线浏览:https://jimmysong.io/kubernetes-handbook

    PDF 请见附件。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Kubernetes 手册

    GitHub stars GitHub forks License

    Kubernetes 基础教程 - 全面介绍容器编排技术的实战手册,涵盖核心架构、关键组件和实际应用。

    关于本教程

    本教程内容涵盖容器、Kubernetes、服务网格、Serverless 等云原生的多个领域,以及 AI 原生基础设施。

    本书采用署名 - 非商业性使用 - 相同方式共享 4.0 (CC BY-NC-SA 4.0) 协议共享。

    什么是云原生

    云原生是一种行为方式和设计理念,其本质是通过一系列技术和方法论来提高云上资源利用率和应用交付效率。云计算的发展史就是一部云原生化的历史。

    从技术发展历程来看:

    • Kubernetes 开启了云原生的序幕,提供了容器编排的标准
    • 服务网格(如 Istio) 引领了后 Kubernetes 时代的微服务治理
    • Serverless 技术使云原生从基础设施层向应用架构层深入发展
    • AI 原生 技术使云原生从应用架构层向智能化平台发展

    我们正处于一个云原生技术快速演进的新时代。

    Kubernetes 简介

    Kubernetes 是 Google 于 2014 年 6 月基于其内部使用的 Borg 系统开源的容器编排调度引擎。Google 将其作为初始和核心项目贡献给 CNCF(云原生计算基金会),现已成为云原生生态的核心基石。

    Kubernetes 的使命

    Kubernetes 的目标不仅仅是一个编排系统,而是:

    • 提供规范来描述集群架构
    • 定义服务的最终状态
    • 使系统自动达到并维持该状态
    • 作为云原生应用的操作系统

    云原生技术栈

    根据 CNCF 定义,云原生技术有利于各组织在公有云、私有云和混合云等新型动态环境中,构建和运行可弹性扩展的应用。

    核心技术包括:

    • 容器:应用打包和运行的标准单元
    • 服务网格:微服务间通信的基础设施层
    • 微服务:应用架构的设计模式
    • 不可变基础设施:基础设施的管理理念
    • 声明式 API:系统配置和管理的方式

    这些技术能够构建容错性好、易于管理和便于观察的松耦合系统,结合可靠的自动化手段,使工程师能够轻松地对系统作出频繁和可预测的重大变更。

    关于本书

    Kubernetes Handbook 项目始于 2016 年底,开源于 2017 年 3 月,作为第一本系统介绍 Kubernetes 的中文电子书,经过多年持续完善和更新。

    本书记录了从零开始学习和使用 Kubernetes 的完整历程,具有以下特点:

    • 实战导向:着重于经验总结和最佳实践分享
    • 深入浅出:详细解析 Kubernetes 核心概念
    • 生态完整:涵盖微服务、DevOps、服务网格、Serverless、边缘计算、AI 原生等相关领域
    • 持续更新:跟进最新技术发展和社区动态

    本书基于 Kubernetes v1.31+ 编写,持续更新最新的概念和 API,确保内容的时效性和准确性。

    在线阅读与下载

    你可以通过以下方式阅读本书:

    参与贡献

    欢迎提交 Issue 和 Pull Request 来改进本书!

    贡献方式:

    • Fork 本仓库
    • 创建特性分支(git checkout -b feature/amazing-feature)
    • 提交更改(git commit -m 'Add some amazing feature')
    • 推送到分支(git push origin feature/amazing-feature)
    • 创建 Pull Request

    作者

    Jimmy Song

    许可证

    本项目采用 CC BY-NC-SA 4.0 许可证。

    致谢

    感谢所有为本项目做出贡献的朋友们!