8.2. 可用的代理配置配置参数

下表指定您可以在基于 Agent 的安装过程中设置的必要和可选代理配置参数。

这些值在 agent-config.yaml 文件中指定。

注意

这些设置仅用于安装，无法在安装后修改。

8.2.1. 所需的配置参数
复制链接

下表描述了所需的代理配置参数：

Expand

表 8.7. 所需的参数
参数	描述
`apiVersion:` Copy to Clipboard Toggle word wrap	`agent-config.yaml` 内容的 API 版本。当前版本是 `v1beta1`。安装程序可能还支持旧的 API 版本。值：字符串
`metadata:` Copy to Clipboard Toggle word wrap	Kubernetes 资源 `ObjectMeta`，其中只消耗 `name` 参数。值：对象
`metadata: name:` Copy to Clipboard Toggle word wrap	集群的名称。集群的 DNS 记录是 `{{.metadata.name}}.{{.baseDomain}}` 的子域。在 `agent-config.yaml` 文件中输入的值将被忽略，而是使用 `install-config.yaml` 文件中指定的值。当您没有通过 `install-config.yaml` 或 `agent-config.yaml` 文件提供 `metadata.name` 时，例如只使用 ZTP 清单时，集群名称被设置为 `agent-cluster`。值：包括小写字母和连字符 (`-`) 的字符串，如 `dev`。

8.2.2. 可选的配置参数
复制链接

下表描述了可选的 Agent 配置参数：

Expand

表 8.8. 可选参数
参数	描述
`rendezvousIP:` Copy to Clipboard Toggle word wrap	执行 bootstrap 进程的节点的 IP 地址，以及运行 `assisted-service` 组件。当您没有在 `networkConfig` 参数中指定至少一个主机的 IP 地址时，您必须提供 rendezvous IP 地址。如果没有提供此地址，则会从提供的主机的 `networkConfig` 中选择一个 IP 地址。值： IPv4 或 IPv6 地址。
`bootArtifactsBaseURL:` Copy to Clipboard Toggle word wrap	当您使用基于代理的安装程序生成最小 ISO 镜像时，此参数指定可在集群安装过程中从中检索 rootfs 镜像文件的 URL。对于连接环境中的引导最小 ISO 镜像，这个参数是可选的。当您使用基于代理的安装程序生成 iPXE 脚本时，此参数指定要将 Preboot Execution Environment (PXE)资产上传到的服务器 URL。如需更多信息，请参阅"为 OpenShift Container Platform 准备 PXE 资产"。值：字符串。
`additionalNTPSources:` Copy to Clipboard Toggle word wrap	要添加到所有集群主机的网络时间协议 (NTP) 源列表，这些源被添加到通过其他方法配置的任何 NTP 源中。值：主机名或 IP 地址列表。
`hosts:` Copy to Clipboard Toggle word wrap	主机配置。可选的主机列表。定义的主机数量不能超过 `install-config.yaml` 文件中定义的主机总数，这是 `compute.replicas` 和 `controlPlane.replicas` 参数的值的总和。值：主机配置对象的数组。
`hosts: hostname:` Copy to Clipboard Toggle word wrap	主机名.覆盖从动态主机配置协议(DHCP)或反向 DNS 查找中获取的主机名。每个主机必须具有由这些方法提供的唯一主机名，尽管通过此参数配置主机名是可选的。值：字符串。
`hosts: interfaces:` Copy to Clipboard Toggle word wrap	为主机上的接口提供名称和 MAC 地址映射表。如果在 `agent-config.yaml` 文件中提供了 `NetworkConfig` 部分，则必须包含此表，值必须与 `NetworkConfig` 部分中提供的映射匹配。值：主机配置对象的数组。
`hosts: interfaces: name:` Copy to Clipboard Toggle word wrap	主机上接口名称。值：字符串。
`hosts: interfaces: macAddress:` Copy to Clipboard Toggle word wrap	主机上接口的 MAC 地址。值：一个 MAC 地址，如以下示例：`00-B0-D0-63-C2-26`。
`hosts: role:` Copy to Clipboard Toggle word wrap	定义主机是 `master` 节点还是 `worker` 节点。如果在 `agent-config.yaml` 文件中没有定义角色，则会在集群安装过程中随机分配角色。值： `master` 或 `worker`。
`hosts: rootDeviceHints:` Copy to Clipboard Toggle word wrap	启用将 Red Hat Enterprise Linux CoreOS (RHCOS)镜像置备到特定设备。安装程序会按照发现设备的顺序检查设备，并将发现的值与 hint 值进行比较。它使用第一个与 hint 值匹配的发现设备。这是操作系统在安装过程中写入的设备。值：键值对的字典。如需更多信息，请参阅"为 OpenShift 安装设置环境"页面中的"Root 设备提示"。
`hosts: rootDeviceHints: deviceName:` Copy to Clipboard Toggle word wrap	RHCOS 镜像置备为的设备的名称。值：字符串。
`hosts: networkConfig:` Copy to Clipboard Toggle word wrap	主机网络定义。配置必须与 nmstate 文档中定义的 Host Network Management API 匹配。值：主机网络配置对象的字典。
`minimalISO:` Copy to Clipboard Toggle word wrap	定义基于代理的安装程序是否生成完整的 ISO 镜像或最小 ISO 镜像。当此参数设为 `True` 时，基于代理的安装程序会生成一个没有 rootfs 镜像文件的 ISO，并包含有关从中拉取 rootfs 文件的详情。当您生成最小 ISO 时，如果您没有通过 `bootArtifactsBaseURL` 参数指定 rootfs URL，则基于代理的安装程序会嵌入一个默认 URL，该 URL 可通过互联网连接的环境中访问。默认值为 `False`。值：布尔值。

返回顶部

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat