Kubernetes 中 staging 目录的作用

1. 什么是 staging 目录？

staging 目录位于 Kubernetes 源代码的根目录下（例如 kubernetes-1.22.3/staging）。
它的主要作用是存放 Kubernetes 项目自身的模块化代码，用于逐步拆分、独立开发和发布成单独的 Go 模块。

---

2. 为什么需要 staging 目录？

在 Kubernetes 中，有许多代码需要被多个组件（如 kubelet、kube-proxy）复用，例如：

• API 定义
• 客户端工具
• 通用库

为了实现这些代码的模块化开发和独立发布，staging 目录被设计为一个过渡阶段，解决模块拆分和跨依赖管理问题。

背景问题

1. Kubernetes 项目依赖自身的模块（如 k8s.io/apimachinery）。
2. 直接分离模块可能会导致循环依赖问题。
3. 独立模块需要逐步开发和测试，而不是一次性完成。

解决方法

• 将即将独立的模块代码暂时放入 staging 目录。
• 构建时，通过 vendor 机制 伪装成外部依赖，避免循环依赖问题。
• 在模块稳定后，正式发布到独立的仓库和 Go 模块仓库。

---

3. staging 目录的作用

3.1 模块化开发

staging 目录中的子目录对应 Kubernetes 的官方 Go 模块，例如：

• k8s.io/apimachinery
• k8s.io/client-go
• k8s.io/api
• k8s.io/apiserver

这些模块会最终发布到 pkg.go.dev/k8s.io。

3.2 管理跨模块依赖

• staging 目录中的代码被 Kubernetes 主项目和其他组件复用。
• 构建时，这些模块会被同步到 vendor 目录，使 Go 编译器将其视为外部依赖。

3.3 发布和版本化

• 每次 Kubernetes 发布新版本时，staging 中的模块会同步发布到独立的 GitHub 仓库，例如：
  • kubernetes/client-go
  • kubernetes/apimachinery
• 同时发布到 Go 模块仓库，例如 pkg.go.dev/k8s.io。

---

4. staging 的工作原理

4.1 源码结构

staging 目录的结构如下：

staging/
├── src/k8s.io/apimachinery/
├── src/k8s.io/client-go/
├── src/k8s.io/api/
├── src/k8s.io/apiserver/
└── ...

4.2 构建过程

构建 Kubernetes 时：

• staging 中的代码会被复制到 vendor 目录。
• Go 编译器将这些代码识别为外部依赖，避免循环依赖问题。
• 最终，staging 中的模块代码会被用于主项目和其他组件的构建。

4.3 模块发布

在正式发布 Kubernetes 时：

• staging 中的模块被推送到独立的 GitHub 仓库。
• 同时发布为 Go 模块（可通过 go get 使用）。

5. 总结

staging 是 Kubernetes 源码中用于模块化开发的关键目录，其作用包括：

• 暂存即将独立的模块化代码。
• 支持 Kubernetes 主项目与模块间的跨依赖管理。
• 为模块化代码提供独立发布和版本化能力。

它是 Kubernetes 模块化开发的桥梁，是正式发布模块前的重要中间步骤。