Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

10.4. コントロールプレーンマシンセットの設定

この例の YAML スニペットは、コントロールプレーンマシンセットのカスタムリソース (CR) の基本構造を示しています。

10.4.1. コントロールプレーンマシンセットのカスタムリソースのサンプル YAML
リンクのコピー

ControlPlaneMachineSet CR のベースは、すべてのプラットフォームで同じように構築されています。

サンプル ControlPlaneMachineSet CR YAML ファイル

apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
1 

  namespace: openshift-machine-api
spec:
  replicas: 3
2 

  selector:
    matchLabels:
      machine.openshift.io/cluster-api-cluster: <cluster_id>
3 

      machine.openshift.io/cluster-api-machine-role: master
      machine.openshift.io/cluster-api-machine-type: master
  state: Active
4 

  strategy:
    type: RollingUpdate
5 

  template:
    machineType: machines_v1beta1_machine_openshift_io
    machines_v1beta1_machine_openshift_io:
      failureDomains:
        platform: <platform>
6 

        <platform_failure_domains>
7 

      metadata:
        labels:
          machine.openshift.io/cluster-api-cluster: <cluster_id>
          machine.openshift.io/cluster-api-machine-role: master
          machine.openshift.io/cluster-api-machine-type: master
      spec:
        providerSpec:
          value:
            <platform_provider_spec>
8

1
cluster である ControlPlaneMachineSet CR の名前を指定します。この値は変更しないでください。
2
コントロールプレーンマシンの数を指定します。3 つのコントロールプレーンマシンを持つクラスターのみがサポートされているため、replicas の値は 3 です。水平スケーリングはサポートされていません。この値は変更しないでください。
3
クラスターのプロビジョニング時に設定したクラスター ID を基にするインフラストラクチャー ID を指定します。ControlPlaneMachineSet CR を作成するときに、この値を指定する必要があります。OpenShift CLI (oc) がインストールされている場合は、以下のコマンドを実行してインフラストラクチャー ID を取得できます。 
$ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
4
Operator の状態を指定します。状態が Inactive の場合、Operator は操作できません。値を Active に設定することで、Operator をアクティブ化できます。
重要

Operator をアクティブ化する前に、ControlPlaneMachineSet CR 設定がクラスター要件に対して正しいことを確認する必要があります。Control Plane Machine Set Operator のアクティブ化の詳細は、「コントロールプレーンマシンセットの概要」を参照してください。

5
クラスターの更新戦略を指定します。許可される値は OnDelete と RollingUpdate です。デフォルト値は RollingUpdate です。更新戦略の詳細は、「コントロールプレーン設定の更新」を参照してください。
6
クラウドプロバイダーのプラットフォーム名を指定します。この値は変更しないでください。
7
クラスターの <platform_failure_domains> 設定を指定します。このセクションのフォーマットと値はプロバイダー固有です。詳細は、クラウドプロバイダーの障害ドメイン設定サンプルを参照してください。
8
クラスターの <platform_provider_spec> 設定を指定します。このセクションのフォーマットと値はプロバイダー固有です。詳細は、クラウドプロバイダーのサンプルプロバイダー仕様を参照してください。

10.4.2. コントロールプレーンマシンセットの設定オプション
リンクのコピー

コントロールプレーンマシンセットを設定して、ニーズに合わせてクラスターをカスタマイズできます。

10.4.2.1. コントロールプレーンのマシン名にカスタム接頭辞を追加する
リンクのコピー

コントロールプレーンマシンセットが作成するマシン名の接頭辞をカスタマイズできます。これは、ControlPlaneMachineSet カスタムリソース (CR) を編集することで実行できます。

手順

  1. 次のコマンドを実行して、ControlPlaneMachineSet CR を編集します。 

    $ oc edit controlplanemachineset.machine.openshift.io cluster \
  -n openshift-machine-api

  2. ControlPlaneMachineSet CR の .spec.machineNamePrefix フィールドを編集します。 

    apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
  namespace: openshift-machine-api
spec:
  machineNamePrefix: <machine_prefix>
# ...

    ここで、<machine_prefix> は、小文字の RFC 1123 サブドメインの要件に従う接頭辞名を指定します。

    重要

    小文字の RFC 1123 サブドメインは、小文字の英数字、ハイフン ('-')、およびピリオド ('.') のみで構成する必要があります。ピリオドで区切られた各ブロックは、英数字で始まり、英数字で終わる必要があります。ブロックの先頭または末尾にハイフンを使用することはできず、ピリオドの連続も許可されません。

  3. 変更を保存します。

次のステップ

  • machineNamePrefix パラメーターの値のみを変更した場合、デフォルトの RollingUpdate 更新ストラテジーを使用するクラスターは自動的に更新されません。この変更を伝播するには、クラスターの更新ストラテジーに関係なく、コントロールプレーンマシンを手動で置き換える必要があります。詳細は、「コントロールプレーンマシンの置き換え」を参照してください。

10.4.3. プロバイダー固有の設定オプション
リンクのコピー

コントロールプレーンマシンセットマニフェストの <platform_provider_spec> および <platform_failure_domains> セクションは、プロバイダー固有です。クラスターのプロバイダー固有の設定オプションは、次のリソースを参照してください。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hatトップに戻る