2.5. 在 GCP 上创建机器集

流程

1. 创建一个包含机器集自定义资源（CR）示例的新 YAML 文件，并将其命名为 <file_name>.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

      默认节点标签。

      注意

      对于具有用户置备的基础架构的集群，计算机器集只能创建 worker 和 infra 类型机器。

      3

      计算机器设置 CR 的 <providerSpec> 部分中的值是特定于平台的。有关 CR 中的 <providerSpec> 参数的更多信息，请参阅您的供应商计算机器设置 CR 配置示例。

3. 运行以下命令来创建 MachineSet CR：

   $ oc create -f <file_name>.yaml

流程

1. 使用您的 KMS 密钥名称、密钥环名称和位置运行以下命令，允许特定服务帐户使用您的 KMS 密钥，并为服务帐户授予正确的 IAM 角色：

   gcloud kms keys add-iam-policy-binding <key_name> \
     --keyring <key_ring_name> \
     --location <key_ring_location> \
     --member "serviceAccount:service-<project_number>@compute-system.iam.gserviceaccount.com” \
     --role roles/cloudkms.cryptoKeyEncrypterDecrypter

2. 在机器集 YAML 文件中的 providerSpec 字段中配置加密密钥。例如：

   providerSpec:
     value:
       # ...
       disks:
       - type:
         # ...
         encryptionKey:
           kmsKey:
             name: machine-encryption-key 1
             keyRing: openshift-encrpytion-ring 2
             location: global 3
             projectID: openshift-gcp-project 4
           kmsKeyServiceAccount: openshift-service-account@openshift-gcp-project.iam.gserviceaccount.com 5

   1

   用于磁盘加密的客户管理的加密密钥名称。

   2

   KMS 密钥所属的 KMS 密钥环的名称。

   3

   KMS 密钥环存在的 GCP 位置。

   4

   可选：存在 KMS 密钥环的项目 ID。如果没有设置项目 ID，则会使用创建机器设置的机器设置 projectID。

   5

   可选：用于给定 KMS 密钥加密请求的服务帐户。如果没有设置服务帐户，则使用 Compute Engine 默认服务帐户。

   当使用更新的 providerSpec 对象配置创建新机器后，磁盘加密密钥就会使用 KMS 密钥加密。

1. 有关机器类型的更多信息，包括规格、兼容性、区域可用性和限制，请参阅 GCP Compute Engine 文档，有关 N1 机器集、A2 计算机系列和 GPU 区域以及区域可用性。

流程

1. 在文本编辑器中，为现有机器集打开 YAML 文件或创建新机器。

2. 在机器集 YAML 文件中的 providerSpec 字段中指定 GPU 配置。请参见以下有效配置示例：

   A2 机器集配置示例：

     providerSpec:
       value:
         machineType: a2-highgpu-1g 1
         onHostMaintenance: Terminate 2
         restartPolicy: Always 3

   1

   指定机器类型。确保在 A2 机器集中包含机器类型。

   2

   在使用 GPU 支持时，您必须将 HostMaintenance 设置为 终止。

   3

   为机器集部署的机器指定重启策略。允许的值是 Always 或 Never。

   N1 机器集配置示例：

   providerSpec:
     value:
       gpus:
       - count: 1 1
         type: nvidia-tesla-p100 2
       machineType: n1-standard-1 3
       onHostMaintenance: Terminate 4
       restartPolicy: Always 5

   1

   指定要附加到机器的 GPU 数。

   2

   指定要附加到机器的 GPU 类型。确保机器类型和 GPU 类型兼容。

   3

   指定机器类型。确保机器类型和 GPU 类型兼容。

   4

   在使用 GPU 支持时，您必须将 HostMaintenance 设置为 终止。

   5

   为机器集部署的机器指定重启策略。允许的值是 Always 或 Never。