15.5. 原仓库索引

本站不是原仓库的镜像，而是一次「从代码仓库到学习手册」的重构。这张表保证每个原始目录都能找到去处，也说明我们新增了哪些内容。

层级:: L5 · 参考
难度:: 全阶段
用途:: 溯源
前置:: 无

15.5.1. 改造原则

原仓库 iKubernetes/learning-k8s 是课程配套的代码与清单仓库，特点是：

以目录组织组件，README 偏「操作步骤」；
大量 YAML 直接可跑，但缺少概念铺垫与排错说明；
部分 API 版本较旧（如 batch/v1beta1）；
目录之间没有统一的学习顺序。

本站做了四件事：

按学习路径重组：开始 → 核心 → 平台 → 交付 → 附录，而不是按组件平铺。
每章补齐结构：概念、架构图、实验、验证、排错表、进阶挑战。
修正过时内容：标注旧 API，给出 Kubernetes v1.31 的写法。
增加缺失章节：架构与对象模型、环境准备、命令速查、排错手册、术语表。

原始清单仍可从 GitHub 仓库获取。本站正文中的命令与资源名尽量与仓库保持一致，便于对照。

15.5.2. 目录映射

原目录	原内容	本站章节	处理方式
`ansible-k8s-install/`	Ansible + kubeadm 集群部署	集群部署、CNI 网络	保留 playbook 流程，补充手工对照与验收
`tutorials/`	Pod、ConfigMap、存储卷实验	Pod 与容器、配置与密钥、存储与持久化	修正 YAML 缩进错误，扩展为完整实验
`examples/`	核心对象示例清单	核心部分全部章节	按对象类型拆分，补充原理与排错
`examples/pods/`	探针、Init、Sidecar、资源	Pod 与容器	选取代表性清单，补充安全上下文
`examples/deployments/`	Deployment / ReplicaSet	工作负载	增加滚动更新与回滚实验
`examples/statefulsets/`	StatefulSet / MySQL	工作负载、WordPress	补充 Headless 与卷模板说明
`examples/jobs_and_cronjobs/`	Job / CronJob	工作负载	标注 `batch/v1beta1` 已移除
`examples/configmaps_and_secrets/`	ConfigMap / Secret	配置与密钥	增加热更新与 subPath 边界
`examples/volumes/`	emptyDir/hostPath/NFS/PVC	存储与持久化	增加 PV/PVC 生命周期与扩容
`examples/services/`	Service / DNS / EndpointSlice	服务与网络	增加 Headless、NetworkPolicy
`examples/network-policy-examples/`	NetworkPolicy 示例	服务与网络	解释默认拒绝与 CNI 依赖
`examples/authn_and_authz/`	CSR、RBAC	认证与安全	补充 CSR API 完整流程
`examples/wordpress/`	WordPress 全对象示例	WordPress 实战	整理 01–07 部署顺序
`ansible-k8s-install/install-k8s-calico.yaml`	Calico 部署	CNI 网络	补充 BGP RR 与模式选择
`ansible-k8s-install/install-k8s-cilium.yaml`	Cilium 部署	CNI 网络	补充 kube-proxy replacement
`ansible-k8s-install/install-k8s-flannel.yaml`	Flannel 部署	CNI 网络	作为入门 CNI 对比
`ProjectCalico/`	BGP Route Reflector	CNI 网络	保留三步配置流程
`Cilium/`	Cilium 安装与 Hubble	CNI 网络	补充 eBPF 与 Hubble 实验
`MetalLB/`	地址池与 L2 通告	负载均衡与 Ingress	补充 StrictARP 与验证
`OpenELB/`	OpenELB 部署	负载均衡与 Ingress	作为备选方案对比
`ingress-canary-demo/`	Ingress 灰度五种方式	负载均衡与 Ingress	整理为对照实验
`OpenEBS/`	OpenEBS 4.x / 3.x	存储扩展	强调版本差异
`csi-driver-nfs/`	NFS CSI	存储扩展	补充 dnsPolicy 坑与 SC
`MinIO/`	MinIO 部署	存储扩展、日志与 ELK	作为 Loki 后端与对象存储
`Cert-Manager/`	证书管理	证书管理	补充 Issuer/Certificate 实验
`Prometheus/`	Prometheus + Adapter + Blackbox	Prometheus 监控	补充 Helm 完整流程
`kube-prometheus/`	Prometheus Operator	Prometheus 监控	补充 CRD 与 ServiceMonitor
`metrics-server/`	资源指标 API	调度与弹性	补充 HPA 联动
`KEDA/`	事件驱动伸缩	调度与弹性	保留架构讲解，补充 ScaledObject
`Loki-Stack/`	Loki / Promtail / Grafana	日志与 ELK	按部署顺序重组
`eck-operator/`	ECK / Filebeat / Kibana	日志与 ELK	补充索引与检索
`Velero/`	备份恢复与 CSI 快照	备份与恢复	补充安装、调度、演练
`Karmada/`	多集群分发	多集群编排	补充架构与策略对比
`helm-examples/`	Helm values 示例	Helm 包管理	补充 Chart 结构与回滚
`jenkins/`	Jenkins on K8s	Jenkins 流水线	补充 Kubernetes Plugin
`gitlab/`	GitLab 部署	GitLab 平台	补充持久化与初始密码
`Kuboard/`	Kuboard v3	集群面板	补充 RBAC 与 Ingress
`dashboard/`	Dashboard Ingress	集群面板	补充 Token 与最小权限
`wordpress/`	WordPress 部署	WordPress 实战	与 `examples/wordpress` 合并
`Mall-MicroService/`	微服务商城	微服务商城	补充依赖顺序与验收
`MageEdu-Private-Cloud/`	私有云综合案例	私有云案例	补充 OpenStack 与部署顺序
`tutorials/volume-in-practise/`	存储卷实验	存储与持久化	修正清单错误，补充动态供给

15.5.3. 新增内容

原仓库没有、但学习路径必需的内容：

新增章节	为什么需要
学习路线	原仓库没有统一的学习顺序
环境与工具	大量部署失败源于系统预检
架构与对象模型	不理解控制器，后面只能背命令
第一个应用	从零串起 Deployment/Service/Ingress
命令速查	降低日常操作与排错的检索成本
排错手册	原仓库偏「成功路径」，缺少故障处理
术语表	统一中英文概念
平台能力总览	组件之间存在依赖顺序
各章「进阶挑战」	从「照着做」到「真的理解」

15.5.4. 技术栈专题

除了按学习路径组织的正文，本站还按技术域提供了「技术栈专题」：从技术栈总览进入，可分别查看DevOps 工程体系、集群与运行时、网络与 Service Mesh、存储与数据、交付与 GitOps、可观测性、安全与策略、伸缩与平台工程、Serverless 与 AI。

这些页面主要解决「选什么、怎么组合、边界在哪」，具体安装步骤仍放在对应的学习路径章节与实战文章中。

15.5.5. 《Kubernetes 进阶实战》第 2 版

除 learning-k8s 外，本站还整合了《Kubernetes 进阶实战（第 2 版）》的 16 章体系与随书代码。16 章到本站的逐章映射、已有/新增/合并关系见原书章节映射。

本次新增的章节包括：

新增页面	对应原书
Kubernetes 系统基础	第 1 章
资源管理与 API 群组	第 3 章
StatefulSet 与有状态集群	第 8 章
调度策略：亲和、污点与优先级	第 11 章
Kubernetes 系统扩展	第 12 章
Ingress 进阶：Contour 与 HTTPProxy	第 13 章
Kustomize 声明式应用管理	第 14 章
集群日志系统：EFK 与 Fluent Bit	第 16 章
Ceph 与 Longhorn 存储实践	第 5 章

其余章节以「并入既有页面」的方式补充，例如准入控制并入认证与安全，资源指标/HPA 并入调度、资源与弹性与Prometheus 监控，Flannel 并入CNI 网络。

15.5.6. 内容核对

检查项	状态
原仓库 28 个顶层目录均有映射	✅
核心 YAML 示例均可在 v1.31 运行	✅（旧 API 已标注）
每个平台组件都有安装 + 验证步骤	✅
每个章节都有排错表	✅
所有站内链接可解析	构建时校验

15.5.7. 版权与使用

原始代码与文档来自 iKubernetes/learning-k8s 与 Kubernetes_Advanced_Practical_2rd，由马哥教育开发，允许自由转载但需保留标识。本站对其内容进行了结构化重写与补充，仅用于学习与实验；生产使用前请自行验证。