6.4.3. 集群配置参考

主机配置。

主机配置对象的数组。

主机名.覆盖从动态主机配置协议(DHCP)或反向 DNS 查找中获取的主机名。每个主机必须具有由这些方法提供的唯一主机名，尽管通过此参数配置主机名是可选的。

字符串.

为主机上的接口提供名称和 MAC 地址映射表。如果在 nodes-config.yaml 文件中提供了 NetworkConfig 部分，则必须包括此表，值必须与 NetworkConfig 部分中提供的映射匹配。

主机配置对象的数组。

主机上接口名称。

字符串.

主机上接口的 MAC 地址。

一个 MAC 地址，如以下示例：00-B0-D0-63-C2-26。

启用将 Red Hat Enterprise Linux CoreOS (RHCOS)镜像置备到特定设备。node-adding 工具会按照发现设备的顺序检查设备，并将发现的值与 hint 值进行比较。它使用第一个与 hint 值匹配的发现设备。

键值对字典。如需更多信息，请参阅"为 OpenShift 安装设置环境"页面中的"Root 设备提示"。

RHCOS 镜像置备为的设备的名称。

字符串.

主机网络定义。配置必须与 nmstate 文档中定义的 Host Network Management API 匹配。

主机网络配置对象的字典。

可选。指定您要添加的节点架构。如果需要，此参数允许您覆盖集群中的默认值。

字符串.

可选。包含 SSH 密钥的文件，用于验证对集群机器的访问。

字符串.

可选。指定在生成 iPXE 脚本时将 Preboot Execution Environment (PXE) 资产上传到的服务器的 URL。您还必须将 --pxe 标志设置为生成 PXE 资产而不是 ISO 镜像。

字符串.

--certificate-authority

与受管容器镜像 registry 通信时使用的证书颁发机构捆绑包的路径。如果使用 --insecure 标志，则忽略这个标志。

字符串

--dir

如果提供，则包含配置文件的路径。此路径也用于存储生成的工件。

字符串

--insecure

允许通过 HTTP 对 registry 进行推送和拉取操作。

布尔值

-o, --output-name

生成的输出镜像的名称。

字符串

p, --pxe

生成 Preboot Execution Environment (PXE) 资产，而不是可引导 ISO 文件。

当设置此标志时，您还可以使用 nodes-config.yaml 文件中的 bootArtifactsBaseURL 参数来指定您将上传 PXE 资产的服务器的 URL。

布尔值

-a, --registry-config

到 registry 凭证的路径。或者，您可以指定 REGISTRY_AUTH_FILE 环境变量。默认路径为 ${XDG_RUNTIME_DIR}/containers/auth.json, /run/containers/${UID}/auth.json, ${XDG_CONFIG_HOME}/containers/auth.json, ${DOCKER_CONFIG}, ~/.docker/config.json, ~/.dockercfg.可以通过已弃用的 REGISTRY_AUTH_PREFERENCE 环境变量更改为"docker"值来更改顺序，以便优先选择使用 Podman 的 Docker 凭据。

字符串

-r, --report

无论进程是成功还是不成功，都生成节点创建进程的报告。如果没有指定此标志，则仅会在失败时生成报告。

布尔值

--skip-verification

用于跳过验证检索内容的完整性的选项。不建议这样做，但在从旧镜像 registry 导入镜像时可能需要这样做。只有在 registry 已知可以被信任时才绕过验证。

布尔值

-c, --cpu-architecture

用于安装节点的 CPU 架构。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串

--hostname

为节点设置的主机名。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串

-m, --mac-address

用于标识要应用配置的主机的 MAC 地址。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串

--network-config-path

包含要应用到节点的 NMState 配置的 YAML 文件的路径。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串

--root-device-hint

用于指定镜像根文件系统存储位置的提示。接受的格式是 <hint_name>:<value>。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串

-k, --ssh-key-path

用于访问节点的 SSH 密钥的路径。此标志可用于仅创建单一节点，并且必须定义 --mac-address 标志。

字符串