5.11. 修改主机


添加主机后,根据需要修改主机。最常见的修改是 host_namehost_role 参数。

您可以使用 /v2/infra-envs/{infra_env_id}/hosts/{host_id} 端点修改主机。如需了解在修改主机时您可以设置的字段的详情,请参阅 API viewer 中的 host-update-params 模型。

主机可能是以下角色之一:

  • Master - 将 control plane 角色分配给主机,允许主机管理和协调集群。
  • 仲裁程序 - 为主机分配仲裁角色,为需要仲裁的组件提供经济有效的解决方案。
  • worker - 将 compute 角色分配给主机,使主机能够运行应用程序工作负载。
  • auto-assign - Automatically 确定主机是否为 masterworker 或 'arbiter' 节点。

使用以下步骤设置主机的角色。如果省略 host_role 设置,主机默认为 auto-assign

先决条件

  • 您已将主机添加到集群中。

流程

  1. 刷新 API 令牌:

    $ source refresh-token
    Copy to Clipboard Toggle word wrap
  2. 获取主机 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'
    Copy to Clipboard Toggle word wrap
  3. 使用以下示例修改主机设置:

    $ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ 
    1
    
    -X PATCH \
    -H "Authorization: Bearer ${API_TOKEN}" \
    -H "Content-Type: application/json" \
    -d '
        {
          "host_role":"worker"
          "host_name" : "worker-1"
        }
    ' | jq
    Copy to Clipboard Toggle word wrap
    1
    <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. 查看存储磁盘

您可以查看集群中的主机,以及每个主机上的磁盘。然后,您可以对特定磁盘执行操作。

流程

  1. 刷新 API 令牌:

    $ source refresh-token
    Copy to Clipboard Toggle word wrap
  2. 获取集群的主机 ID:

    $ curl -s "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" \
      -H "Authorization: Bearer $API_TOKEN" \
    | jq '.host_networks[].host_ids'
    Copy to Clipboard Toggle word wrap

    输出示例

    "1022623e-7689-8b2d-7fbd-e6f4d5bb28e5"
    Copy to Clipboard Toggle word wrap

    注意

    这是单个主机的 ID。多个主机 ID 用逗号分开。

  3. 获取特定主机的磁盘:

    $ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ 
    1
    
    -H "Authorization: Bearer ${API_TOKEN}" \
    | jq '.inventory | fromjson | .disks'
    Copy to Clipboard Toggle word wrap
    1
    <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"
      }
    ]
    Copy to Clipboard Toggle word wrap

    注意

    这是一个磁盘的输出。它具有磁盘的 disk_idinstallation_eligibility 属性。

5.11.1.2. 更改安装磁盘

辅助安装程序默认随机分配一个安装磁盘。如果主机有多个存储磁盘,您可以选择一个不同的磁盘作为安装磁盘。这会自动取消之前磁盘的分配。

您可以选择任何其 installation_eligibility 属性为 eligible: true 的磁盘为安装磁盘。

注意

Red Hat Enterprise Linux CoreOS (RHCOS)支持安装磁盘上的光纤通道进行多路径,从而对硬件故障具有更强大的弹性,以实现更高的主机可用性。在代理 ISO 镜像中默认启用多路径,带有 /etc/multipath.conf 配置。详情请查看 修改 DM 多路径配置文件

流程

  1. 获取主机和存储磁盘 ID。详情请参阅 查看存储磁盘
  2. 可选:识别当前安装磁盘:

    $ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ 
    1
    
    -H "Authorization: Bearer ${API_TOKEN}" \
    | jq '.installation_disk_id'
    Copy to Clipboard Toggle word wrap
    1
    <host_id> 替换为相关主机的 ID。
  3. 分配一个新的安装磁盘:

    注意

    多路径设备会自动发现并列在主机的清单中。要将多路径光纤通道磁盘指定为安装磁盘,选择一个磁盘,"drive_type" 设置为 "Multipath" 而不是 "FC"(表示单个路径)。

    $ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ 
    1
    
    -X PATCH \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    
    {
      "disks_selected_config": [
        {
          "id": "<disk_id>", 
    2
    
          "role": "install"
        }
      ]
    }
    Copy to Clipboard Toggle word wrap
    1
    <host_id> 替换为主机的 ID。
    2
    <disk_id> 替换为新安装磁盘的 ID。

5.11.1.3. 禁用磁盘格式化

辅助安装程序在安装过程中默认将所有可引导磁盘标记为进行格式化,无论它们是否已被定义为安装磁盘。格式化会导致数据丢失。

您可以选择禁用特定磁盘的格式化。请谨慎禁用格式化,因为可引导磁盘可能会干扰安装过程,特别是引导顺序。

您无法禁用对安装磁盘的格式化。

流程

  1. 获取主机和存储磁盘 ID。详情请参阅 查看存储磁盘
  2. 运行以下命令:

    $ curl https://api.openshift.com/api/assisted-install/v2/infra-envs/${INFRA_ENV_ID}/hosts/<host_id> \ 
    1
    
    -X PATCH \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer ${API_TOKEN}" \
    
    {
     "disks_skip_formatting": [
       {
         "disk_id": "<disk_id>", 
    2
    
         "skip_formatting": true 
    3
    
       }
     ]
    }
    Copy to Clipboard Toggle word wrap
    注意
    1
    <host_id> 替换为主机的 ID。
    2
    <disk_id> 替换为磁盘的 ID。如果有多个磁盘,使用逗号将 ID 分开。
    3
    要重新启用格式化,请将值改为 false
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat