×

您可以创建不同的计算机器集来为您的 IBM Cloud® 上的 OpenShift Container Platform 集群提供特定用途。例如,您可以创建基础架构机器集和相关机器,以便您可以将支持的工作负载迁移到新机器。

您只能在 Machine API 可运行的集群中使用高级机器管理和缩放功能。具有用户预置基础架构的集群需要额外的验证和配置才能使用 Machine API。

基础架构平台类型为 `none` 的集群无法使用 Machine API。即使连接到集群的计算机器安装在支持此功能的平台上,此限制也适用。此参数安装后无法更改。

要查看集群的平台类型,请运行以下命令

$ oc get infrastructure cluster -o jsonpath='{.status.platform}'

IBM Cloud 上计算机器集自定义资源的示例 YAML

此示例 YAML 定义了一个在指定 IBM Cloud® 区域内的区域中运行的计算机器集,并创建标有node-role.kubernetes.io/<role>: "" 的节点。

在此示例中,<infrastructure_id> 是基于您在配置集群时设置的集群 ID 的基础架构 ID 标签,<role> 是要添加的节点标签。

apiVersion: machine.openshift.io/v1beta1
kind: MachineSet
metadata:
  labels:
    machine.openshift.io/cluster-api-cluster: <infrastructure_id> (1)
    machine.openshift.io/cluster-api-machine-role: <role> (2)
    machine.openshift.io/cluster-api-machine-type: <role> (2)
  name: <infrastructure_id>-<role>-<region> (3)
  namespace: openshift-machine-api
spec:
  replicas: 1
  selector:
    matchLabels:
      machine.openshift.io/cluster-api-cluster: <infrastructure_id> (1)
      machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>-<region> (3)
  template:
    metadata:
      labels:
        machine.openshift.io/cluster-api-cluster: <infrastructure_id> (1)
        machine.openshift.io/cluster-api-machine-role: <role> (2)
        machine.openshift.io/cluster-api-machine-type: <role> (2)
        machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>-<region> (3)
    spec:
      metadata:
        labels:
          node-role.kubernetes.io/<role>: ""
      providerSpec:
        value:
          apiVersion: ibmcloudproviderconfig.openshift.io/v1beta1
          credentialsSecret:
            name: ibmcloud-credentials
          image: <infrastructure_id>-rhcos (4)
          kind: IBMCloudMachineProviderSpec
          primaryNetworkInterface:
              securityGroups:
              - <infrastructure_id>-sg-cluster-wide
              - <infrastructure_id>-sg-openshift-net
              subnet: <infrastructure_id>-subnet-compute-<zone> (5)
          profile: <instance_profile> (6)
          region: <region> (7)
          resourceGroup: <resource_group> (8)
          userDataSecret:
              name: <role>-user-data (2)
          vpc: <vpc_name> (9)
          zone: <zone> (10)
1 基于您在配置集群时设置的集群 ID 的基础架构 ID。如果您已安装 OpenShift CLI,则可以通过运行以下命令获取基础架构 ID:
$ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
2 要添加的节点标签。
3 基础架构 ID、节点标签和区域。
4 用于集群安装的自定义 Red Hat Enterprise Linux CoreOS (RHCOS) 镜像。
5 要在其上放置机器的基础架构 ID 和您区域内的区域。确保您的区域支持您指定的区域。
6 指定IBM Cloud® 实例配置文件
7 指定要在其上放置机器的区域。
8 放置机器资源的资源组。这是安装时指定的现有资源组,或基于基础架构 ID 命名安装程序创建的资源组。
9 VPC 名称。
10 指定要在其上放置机器的区域内的区域。确保您的区域支持您指定的区域。

创建计算机器集

除了安装程序创建的计算机器集之外,您还可以创建自己的计算机器集来动态管理您选择的特定工作负载的机器计算资源。

先决条件
  • 部署 OpenShift Container Platform 集群。

  • 安装 OpenShift CLI (oc)。

  • 以具有 cluster-admin 权限的用户身份登录到 oc

步骤
  1. 创建一个包含计算机器集自定义资源 (CR) 示例并命名为<file_name>.yaml 的新 YAML 文件。

    确保您设置了<clusterID><role> 参数值。

  2. 可选:如果您不确定为特定字段设置哪个值,您可以检查集群中现有的计算机器集。

    1. 要列出集群中的计算机器集,请运行以下命令:

      $ oc get machinesets -n openshift-machine-api
      示例输出
      NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
      agl030519-vplxk-worker-us-east-1a   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1b   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1c   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1d   0         0                             55m
      agl030519-vplxk-worker-us-east-1e   0         0                             55m
      agl030519-vplxk-worker-us-east-1f   0         0                             55m
    2. 要查看特定计算机器集自定义资源 (CR) 的值,请运行以下命令:

      $ oc get machineset <machineset_name> \
        -n openshift-machine-api -o yaml
      示例输出
      apiVersion: machine.openshift.io/v1beta1
      kind: MachineSet
      metadata:
        labels:
          machine.openshift.io/cluster-api-cluster: <infrastructure_id> (1)
        name: <infrastructure_id>-<role> (2)
        namespace: openshift-machine-api
      spec:
        replicas: 1
        selector:
          matchLabels:
            machine.openshift.io/cluster-api-cluster: <infrastructure_id>
            machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>
        template:
          metadata:
            labels:
              machine.openshift.io/cluster-api-cluster: <infrastructure_id>
              machine.openshift.io/cluster-api-machine-role: <role>
              machine.openshift.io/cluster-api-machine-type: <role>
              machine.openshift.io/cluster-api-machineset: <infrastructure_id>-<role>
          spec:
            providerSpec: (3)
              ...
      1 集群基础架构 ID。
      2 默认节点标签。

      对于具有用户预配基础架构的集群,计算机器集只能创建workerinfra 类型机器。

      3 计算机器集 CR 的<providerSpec> 部分中的值是特定于平台的。有关 CR 中<providerSpec> 参数的更多信息,请参阅您提供程序的示例计算机器集 CR 配置。
  3. 通过运行以下命令创建MachineSet CR:

    $ oc create -f <file_name>.yaml
验证
  • 通过运行以下命令查看计算机器集列表:

    $ oc get machineset -n openshift-machine-api
    示例输出
    NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
    agl030519-vplxk-infra-us-east-1a    1         1         1       1           11m
    agl030519-vplxk-worker-us-east-1a   1         1         1       1           55m
    agl030519-vplxk-worker-us-east-1b   1         1         1       1           55m
    agl030519-vplxk-worker-us-east-1c   1         1         1       1           55m
    agl030519-vplxk-worker-us-east-1d   0         0                             55m
    agl030519-vplxk-worker-us-east-1e   0         0                             55m
    agl030519-vplxk-worker-us-east-1f   0         0                             55m

    当新的计算机器集可用时,DESIREDCURRENT 值匹配。如果计算机器集不可用,请等待几分钟,然后再次运行该命令。

为集群自动缩放器标记 GPU 机器集

您可以使用机器集标签来指示集群自动缩放器可以使用哪些机器来部署启用 GPU 的节点。

先决条件
  • 您的集群使用集群自动缩放器。

步骤
  • 在您要为集群自动缩放器创建机器以用于部署启用 GPU 的节点的机器集上,添加cluster-api/accelerator 标签。

    apiVersion: machine.openshift.io/v1beta1
    kind: MachineSet
    metadata:
      name: machine-set-name
    spec:
      template:
        spec:
          metadata:
            labels:
              cluster-api/accelerator: nvidia-t4 (1)
    1 指定您选择的标签,该标签由字母数字字符、-_. 组成,并以字母数字字符开头和结尾。例如,您可以使用nvidia-t4 来表示 Nvidia T4 GPU,或使用nvidia-a10g 来表示 A10G GPU。

    您必须为ClusterAutoscaler CR 中的spec.resourceLimits.gpus.type 参数指定此标签的值。有关更多信息,请参阅“集群自动缩放器资源定义”。