11.4. Cluster API マシンの設定オプション

マシンテンプレートリソースはプロバイダー固有であり、コンピュートマシンセットが作成するマシンの基本的なプロパティーを定義します。コンピュートマシンセットは、マシン作成時にこのテンプレートを参照します。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate 

metadata:
  name: <template_name> 

  namespace: openshift-cluster-api
spec:
  template:
    spec: 

      iamInstanceProfile: # ...
      instanceType: m5.large
      ignition:
        storageType: UnencryptedUserData
        version: "3.4"
      ami:
        id: # ...
      subnet:
        filters:
        - name: tag:Name
          values:
          - # ...
      additionalSecurityGroups:
      - filters:
        - name: tag:Name
          values:
          - # ...

コンピュートマシンセットリソースは、作成するマシンの追加プロパティーを定義します。また、コンピュートマシンセットは、マシンを作成するときにクラスターリソースとマシンテンプレートを参照します。

apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineSet
metadata:
  name: <machine_set_name> 

  namespace: openshift-cluster-api
  labels:
    cluster.x-k8s.io/cluster-name: <cluster_name> 

spec:
  clusterName: <cluster_name> 

  replicas: 1
  selector:
    matchLabels:
      test: example
      cluster.x-k8s.io/cluster-name: <cluster_name>
      cluster.x-k8s.io/set-name: <machine_set_name>
  template:
    metadata:
      labels:
        test: example
        cluster.x-k8s.io/cluster-name: <cluster_name>
        cluster.x-k8s.io/set-name: <machine_set_name>
        node-role.kubernetes.io/<role>: ""
    spec:
      bootstrap:
         dataSecretName: worker-user-data
      clusterName: <cluster_name>
      infrastructureRef:
        apiVersion: infrastructure.cluster.x-k8s.io/v1beta1
        kind: AWSMachineTemplate 

        name: <template_name> 

既存の AWS プレースメントグループ内の Elastic Fabric Adapter (EFA) インスタンスにコンピュートマシンをデプロイできます。

EFA インスタンスにはプレースメントグループは必要なく、EFA の設定以外の目的にもプレースメントグループを使用できます。次の例では、EFA とプレースメントグループを併用して、指定したプレースメントグループ内のマシンのネットワークパフォーマンスを向上させる設定を示しています。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレートの YAML ファイルに適切な値を設定します。次に、マシンセットの YAML ファイルを設定し、マシンをデプロイする際にそのマシンテンプレートを参照するようにします。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      instanceType: <supported_instance_type> 

      networkInterfaceType: efa 

      placementGroupName: <placement_group> 

      placementGroupPartition: <placement_group_partition_number> 

# ...

Amazon Web Services (AWS) クラスター上のマシンが使用する Amazon EC2 インスタンスメタデータサービス (IMDS) のバージョンを制限できます。マシンでは、IMDSv2 (AWS ドキュメント) の使用を必須にすることも、IMDSv2 に加えて IMDSv1 の使用を許可することもできます。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレートの YAML ファイルに適切な値を設定します。次に、マシンセットの YAML ファイルを設定し、マシンをデプロイする際にそのマシンテンプレートを参照するようにします。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      instanceMetadataOptions:
        httpEndpoint: enabled
        httpPutResponseHopLimit: 1 

        httpTokens: optional 

        instanceMetadataTags: disabled
# ...

IMDSv2 の使用を必須とした場合、タイムアウトが発生する可能性があります。軽減ストラテジーを含む詳細は、Instance metadata access considerations (AWS ドキュメント) を参照してください。

Amazon Web Services (AWS) クラスター上の専有インスタンスによってサポートされるマシンをデプロイできます。

専有インスタンスは、単一のお客様専用のハードウェア上の仮想プライベートクラウド (VPC) で実行されます。これらの Amazon EC2 インスタンスは、ホストのハードウェアレベルで物理的に分離されます。インスタンスが単一つの有料アカウントにリンクされている別の AWS アカウントに属する場合でも、専有インスタンスの分離が生じます。ただし、専有ではない他のインスタンスは、それらが同じ AWS アカウントに属する場合は、ハードウェアを専有インスタンスと共有できます。

OpenShift Container Platform は、パブリックまたは専用テナンシーのインスタンスをサポートします。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレートの YAML ファイルに適切な値を設定します。次に、マシンセットの YAML ファイルを設定し、マシンをデプロイする際にそのマシンテンプレートを参照するようにします。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      tenancy: dedicated 

# ...

Amazon Web Services (AWS) に保証されないスポットインスタンスとしてマシンをデプロイできます。Spot インスタンスは、AWS EC2 の予備容量を使用するため、On-Demand インスタンスよりも安価です。Spot インスタンスは、バッチやステートレス、水平的に拡張可能なワークロードなどの割り込みを許容できるワークロードに使用することができます。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレートの YAML ファイルに適切な値を設定します。次に、マシンセットの YAML ファイルを設定し、マシンをデプロイする際にそのマシンテンプレートを参照するようにします。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      spotMarketOptions: 

        maxPrice: <price_per_hour> 

# ...

以下の理由により、Spot インスタンスを使用すると中断が生じる可能性があります。

AWS は、中断の発生時にユーザーに警告を 2 分間表示します。OpenShift Container Platform は、AWS が終了に関する警告を発行する際に影響を受けるインスタンスからワークロードを削除し始めます。

AWS がインスタンスを終了すると、Spot インスタンスノードで実行される終了ハンドラーによりマシンリソースが削除されます。コンピュートマシンセットの replicas の量を満たすために、コンピュートマシンセットはスポットインスタンスを要求するマシンを作成します。

OpenShift Container Platform バージョン 4.20 以降では、On-Demand Capacity Reservation および Capacity Blocks for ML を含む Amazon Web Services クラスターでの Capacity Reservation がサポートされます。

定義した容量要求のパラメーターに一致する利用可能なリソースにマシンをデプロイできます。これらのパラメーターは、予約するインスタンスのタイプ、リージョン、およびインスタンスの数を指定します。Capacity Reservation が容量要求に対応できる場合、デプロイメントは成功します。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレートの YAML ファイルに適切な値を設定します。次に、マシンセットの YAML ファイルを設定し、マシンをデプロイする際にそのマシンテンプレートを参照するようにします。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      capacityReservationId: <capacity_reservation> 

      capacityReservationPreference: <reservation_preference> 

      marketType: <market_type> 

# ...

このサービスの制限事項や推奨されるユースケースなどの詳細は、AWS ドキュメントの On-Demand Capacity Reservations and Capacity Blocks for ML を参照してください。

Amazon Web Services (AWS) に GPU 対応コンピュートマシンをデプロイできます。次のサンプル設定では、例として NVIDIA Tesla T4 Tensor Core GPU を含む AWS G4dn インスタンスタイプ を使用しています。

サポートされているインスタンスタイプの詳細は、NVIDIA ドキュメントの次のページを参照してください。

独自の設定でコンピュートマシンをデプロイするには、マシンテンプレート YAML ファイルと、マシンをデプロイするときにマシンテンプレートを参照するマシンセット YAML ファイルに適切な値を設定します。

apiVersion: infrastructure.cluster.x-k8s.io/v1beta2
kind: AWSMachineTemplate
# ...
spec:
  template:
    spec:
      instanceType: g4dn.xlarge 

# ...

apiVersion: cluster.x-k8s.io/v1beta1
kind: MachineSet
metadata:
  name: <cluster_name>-gpu-<region> 

  namespace: openshift-cluster-api
  labels:
    cluster.x-k8s.io/cluster-name: <cluster_name>
spec:
  clusterName: <cluster_name>
  replicas: 1
  selector:
    matchLabels:
      test: example
      cluster.x-k8s.io/cluster-name: <cluster_name>
      cluster.x-k8s.io/set-name: <cluster_name>-gpu-<region> 

  template:
    metadata:
      labels:
        test: example
        cluster.x-k8s.io/cluster-name: <cluster_name>
        cluster.x-k8s.io/set-name: <cluster_name>-gpu-<region> 

        node-role.kubernetes.io/<role>: ""
# ...