第 8 章 带有 SiteConfig 资源的高级受管集群配置
您可以使用 SiteConfig
自定义资源 (CR) 在安装时在受管集群中部署自定义功能和配置。
8.1. 在 GitOps ZTP 管道中自定义额外的安装清单
您可以定义一组额外的清单,以包含在 GitOps Zero Touch Provisioning (ZTP) 管道的安装阶段。这些清单链接到 siteConfig
自定义资源(CR),并在安装过程中应用到集群。在安装时包括 MachineConfig
CR 可提高安装过程的效率。
先决条件
- 创建一个 Git 存储库,在其中管理自定义站点配置数据。该存储库必须可从 hub 集群访问,并定义为 Argo CD 应用程序的源仓库。
流程
- 创建 GitOps ZTP 管道用于自定义集群安装的一组额外清单 CR。
在自定义
/siteconfig
目录中,为您的额外清单创建一个子目录/custom-manifest
。以下示例演示了一个带有/custom-manifest
文件夹的/siteconfig
示例:siteconfig ├── site1-sno-du.yaml ├── site2-standard-du.yaml ├── extra-manifest/ └── custom-manifest └── 01-example-machine-config.yaml
注意整个使用的子目录名称
/custom-manifest
和/extra-manifest
只是示例名称。不需要使用这些名称,并且对如何命名这些子目录没有限制。在本例中,/extra-manifest
是指从ztp-site-generate
容器存储/extra-manifest
的内容的 Git 子目录。-
将自定义额外清单 CR 添加到
siteconfig/custom-manifest
目录中。 在
SiteConfig
CR 中,在extraManifests.searchPaths
字段中输入目录名称,例如:clusters: - clusterName: "example-sno" networkType: "OVNKubernetes" extraManifests: searchPaths: - extra-manifest/ 1 - custom-manifest/ 2
-
保存
SiteConfig
、/extra-manifest
和/custom-manifest
CR,并将它们推送到站点配置存储库。
在集群置备过程中,GitOps ZTP 管道会将 /custom-manifest
目录中的 CR 附加到存储在 extra-manifest/
中的默认额外清单集合中。
从版本 4.14 extraManifestPath
开始,会受弃用警告。
虽然 extraManifestPath
仍然被支持,但我们建议您使用 extraManifests.searchPaths
。如果您在 SiteConfig
文件中定义 extraManifests.searchPaths
,GitOps ZTP 管道不会在站点安装过程中从 ztp-site-generate
容器获取清单。
如果您在 Siteconfig
CR 中定义 extraManifestPath
和 extraManifests.searchPaths
,则为 extraManifests.searchPaths
定义的设置具有优先权。
强烈建议您从 ztp-site-generate
容器中提取 /extra-manifest
的内容,并将它推送到 GIT 存储库。