5.11. 修改主机
添加主机后,根据需要修改主机。最常见的修改是 host_name 和 host_role 参数。
您可以使用 /v2/infra-envs/{infra_env_id}/hosts/{host_id} 端点修改主机。如需了解在修改主机时您可以设置的字段的详情,请参阅 API viewer 中的 host-update-params 模型。
主机可能是以下角色之一:
-
Master- 将 control plane 角色分配给主机,允许主机管理和协调集群。 -
仲裁程序- 为主机分配仲裁角色,为需要仲裁的组件提供经济有效的解决方案。 -
worker- 将 compute 角色分配给主机,使主机能够运行应用程序工作负载。 -
auto-assign- Automatically 确定主机是否为master、worker或 'arbiter' 节点。
使用以下步骤设置主机的角色。如果省略 host_role 设置,主机默认为 auto-assign。
先决条件
- 您已将主机添加到集群中。
流程
刷新 API 令牌:
$ source refresh-token获取主机 ID:
$ curl -s -X GET "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" \ --header "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jq '.host_networks[].host_ids'使用以下示例修改主机设置:
$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ -X PATCH \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d ' { "host_role":"worker" "host_name" : "worker-1" } ' | jq将
<host_id>替换为主机的 ID。
5.11.1. 修改存储磁盘配置 复制链接链接已复制到粘贴板!
主机发现期间检索到的每个主机都可能有多个存储磁盘。您可以选择更改每个磁盘的默认配置。
- 从 OpenShift Container Platform 4.14 开始,您可以在 CPU (VROC)上使用 Intel® Virtual RAID 配置节点来管理 NVMe RAID。详情请参阅在 CPU (VROC)数据卷上配置 Intel® 虚拟 RAID。
- 从 OpenShift Container Platform 4.15 开始,您可以使用 Assisted Installer 在单一或多路径 iSCSI 引导设备上安装集群。
先决条件
- 配置集群并发现主机。详情请查看 其它资源。
5.11.1.1. 查看存储磁盘 复制链接链接已复制到粘贴板!
您可以查看集群中的主机,以及每个主机上的磁盘。然后,您可以对特定磁盘执行操作。
流程
刷新 API 令牌:
$ source refresh-token获取集群的主机 ID:
$ curl -s "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" \ -H "Authorization: Bearer $API_TOKEN" \ | jq '.host_networks[].host_ids'输出示例
"1022623e-7689-8b2d-7fbd-e6f4d5bb28e5"注意这是单个主机的 ID。多个主机 ID 用逗号分开。
获取特定主机的磁盘:
$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ -H "Authorization: Bearer ${API_TOKEN}" \ | jq '.inventory | fromjson | .disks'将
<host_id>替换为相关主机的 ID。输出示例
[ { "by_id": "/dev/disk/by-id/wwn-0x6c81f660f98afb002d3adc1a1460a506", "by_path": "/dev/disk/by-path/pci-0000:03:00.0-scsi-0:2:0:0", "drive_type": "HDD", "has_uuid": true, "hctl": "1:2:0:0", "id": "/dev/disk/by-id/wwn-0x6c81f660f98afb002d3adc1a1460a506", "installation_eligibility": { "eligible": true, "not_eligible_reasons": null }, "model": "PERC_H710P", "name": "sda", "path": "/dev/sda", "serial": "0006a560141adc3a2d00fb8af960f681", "size_bytes": 6595056500736, "vendor": "DELL", "wwn": "0x6c81f660f98afb002d3adc1a1460a506" } ]注意这是一个磁盘的输出。它具有磁盘的
disk_id和installation_eligibility属性。
5.11.1.2. 更改安装磁盘 复制链接链接已复制到粘贴板!
辅助安装程序默认随机分配一个安装磁盘。如果主机有多个存储磁盘,您可以选择一个不同的磁盘作为安装磁盘。这会自动取消之前磁盘的分配。
您可以选择任何其 installation_eligibility 属性为 eligible: true 的磁盘为安装磁盘。
Red Hat Enterprise Linux CoreOS (RHCOS)支持安装磁盘上的光纤通道进行多路径,从而对硬件故障具有更强大的弹性,以实现更高的主机可用性。在代理 ISO 镜像中默认启用多路径,带有 /etc/multipath.conf 配置。详情请查看 修改 DM 多路径配置文件。
流程
- 获取主机和存储磁盘 ID。详情请参阅 查看存储磁盘。
可选:识别当前安装磁盘:
$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ -H "Authorization: Bearer ${API_TOKEN}" \ | jq '.installation_disk_id'将
<host_id>替换为相关主机的 ID。分配一个新的安装磁盘:
注意多路径设备会自动发现并列在主机的清单中。要将多路径光纤通道磁盘指定为安装磁盘,选择一个磁盘,
"drive_type"设置为"Multipath"而不是"FC"(表示单个路径)。$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ -X PATCH \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${API_TOKEN}" \ { "disks_selected_config": [ { "id": "<disk_id>", "role": "install" } ] }-
将
<host_id>替换为主机的 ID。 -
将
<disk_id>替换为新安装磁盘的 ID。
-
将
5.11.1.3. 禁用磁盘格式化 复制链接链接已复制到粘贴板!
辅助安装程序在安装过程中默认将所有可引导磁盘标记为进行格式化,无论它们是否已被定义为安装磁盘。格式化会导致数据丢失。
您可以选择禁用特定磁盘的格式化。请谨慎禁用格式化,因为可引导磁盘可能会干扰安装过程,特别是引导顺序。
您无法禁用对安装磁盘的格式化。
流程
- 获取主机和存储磁盘 ID。详情请参阅 查看存储磁盘。
运行以下命令:
$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ -X PATCH \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${API_TOKEN}" \ { "disks_skip_formatting": [ { "disk_id": "<disk_id>", "skip_formatting": true } ] }-
将
<host_id>替换为主机的 ID。 -
将
<disk_id>替换为磁盘的 ID。如果有多个磁盘,使用逗号将 ID 分开。
-
将
-
要重新启用格式化,请将
skip_formatting值更改回false。