Single Group to Multi-Group

尽管默认情况下 KubeBuilder v2 不会在同一存储库中搭建与多个 API 组兼容的项目结构，但可以修改默认项目结构以支持它。

让我们迁移下CronJob 示例。

通常，我们使用 API 组的前缀作为目录名称。 查看 api/v1/groupversion_info.go，我们可以看到：

// +groupName=batch.tutorial.kubebuilder.io
package v1

为了让 api 结构更清晰，我们将 api 重命名为 apis，并将现有的 API 移动到新的子目录 batch 中：

mkdir apis/batch
mv api/* apis/batch
# 确保所有文件都成功移动后，删除旧目录 `api`
rm -rf api/ 

将 API 移至新目录后，控制器也需要做相同的处理：

mkdir controllers/batch
mv controllers/* controllers/batch/

接下来，我们将需要更新所有对旧软件包名称的引用。 对于 CronJob，我们需要更新 main.go 和 controllers/batch/cronjob_controller.go。

如果你已经在项目中添加了其他文件，那么也需要更新这些文件中的引用。

最后，我们将运行在项目中启用 Multi-group 模式的命令：

kubebuilder edit --multigroup=true

执行 kubebuilder edit --multigroup=true 命令后，KubeBuilder 将会在 PROJECT 中新增一行，标记该项目是一个 Multi-group 项目:

version: "2"
domain: tutorial.kubebuilder.io
repo: tutorial.kubebuilder.io/project
multigroup: true

请注意，multigroup: true 表示这是一个 Multi-group 项目。

通过上述操作将项目标记为 Multi-group 项目后，原本已经实现的 API 仍旧保持原来的目录结构。该命令并不会自动帮你做调整。 请注意，在 Multi-group 项目中，Kind API 的文件被生成在 apis/<group>/<version>，而不是在 api/<version>。 另外，请注意控制器将在 controllers/<group> 目录下创建，而不是在 controllers。 这就是为什么我们在前面的步骤中使用脚本移动之前生成的 API。 请记住，之后要更新引用。

CronJob教程更详细地解释了每个更改（在 KubeBuilder 为 Single-group 项目生成这些更改的上下文中）。