5.5. 新しいクラスターの登録

手順

1. オプション: 次のコマンドを実行して、Assisted Installer で使用できる Operator を確認します。

   $ curl -s "https://api.openshift.com/api/assisted-install/v2/supported-operators" -H "Authorization: Bearer ${API_TOKEN}" | jq .

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、指定した OCP バージョン、CPU アーキテクチャー、またはプラットフォームで Operator がサポートされているかどうかを確認します。

   $ curl -s "https://api.openshift.com/api/assisted-install/v2/support-levels/features?openshift_version=4.13&cpu_architecture=x86_64&platform_type=baremetal" -H "Authorization: Bearer ${API_TOKEN}" | jq .features.SNO 

   1

   2

   Copy to Clipboard Toggle word wrap

   1

   各属性を次のように置き換えてください。

   • openshift_version には、OpenShift Container Platform のバージョン番号を指定します。この属性は必須です。
   • cpu_architecture には、x86_64、aarch64、arm64、ppc64le、s390x、または multi を指定します。この属性は任意です。
   • platform_type には、baremetal、none、nutanix、vsphere、または external を指定します。この属性は任意です。

   2

   Operator は大文字で指定します。たとえば、Node Feature Discovery の場合は .NODE-FEATURE-DISCOVERY、OpenShift AI の場合は .OPENSHIFT-AI、OpenShift sandboxed containers の場合は .OSC、Self Node Remediation の場合は .SELF-NODE-REMEDIATION、Migration Toolkit for Virtualization の場合は .MTV になります。

   出力例

   "supported"

   Copy to Clipboard Toggle word wrap

   可能なステータスは、"supported"、"dev-preview"、"tech-preview"、および "unavailable" です。

3. 次のコマンドを実行して、指定した OCP バージョン、CPU アーキテクチャー、またはプラットフォームでサポートされている Operator と追加機能の完全なリストを取得します。

   $ curl -s "https://api.openshift.com/api/assisted-install/v2/support-levels/features?openshift_version=4.13&cpu_architecture=x86_64&platform_type=baremetal" -H "Authorization: Bearer ${API_TOKEN}" | jq

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、インストールする Operator を指定します。

   $ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -H "Content-Type: application/json" \
   -d "$(jq --null-input \
      --slurpfile pull_secret ~/Downloads/pull-secret.txt '
   {
      "name": "testcluster",
      "openshift_version": "4.15",
      "cpu_architecture" : "x86_64",
      "base_dns_domain": "example.com",
      "olm_operators": [
     { "name": "mce" } 

   1

   
     ,
     { "name": "odf" }
     ,
    { "name": "amd-gpu" }
       ]
      "pull_secret": $pull_secret[0] | tojson
   }
   ')" | jq '.id'

   Copy to Clipboard Toggle word wrap

   1

   インストールする必要がある Operator をリストします。OpenShift Virtualization の場合は cnv、Migration Toolkit for Virtualization の場合は mtv、multicluster engine の場合は mce、Red Hat OpenShift Data Foundation の場合は odf、Logical Volume Manager Storage の場合は lvm、OpenShift AI の場合は openshift-ai、OpenShift sandboxed containers の場合は osc、Kubernetes NMState の場合は nmstate、AMD GPU の場合は amd-gpu、Kernel Module Management の場合は kmm、Node Feature Discovery の場合は node-feature-discovery、NVIDIA GPU の場合は nvidia-gpu、Self Node Remediation の場合は self-node-remediation を指定します。Operator をインストールすると、依存する Operator も自動的にアクティブ化されます。

手順

1. オプション: 次のコマンドを実行して、Assisted Installer で使用できる Operator バンドルを確認します。

   $ curl -s "https://api.openshift.com/api/assisted-install/v2/operators/bundles" -H "Authorization: Bearer ${API_TOKEN}" | jq .

   Copy to Clipboard Toggle word wrap

2. オプション: 次のコマンドを実行して、特定のバンドルに関連付けられている Operator を確認します。

   $ curl -s "https://api.openshift.com/api/assisted-install/v2/operators/bundles/virtualization" -H "Authorization: Bearer ${API_TOKEN}" | jq . 

   1

   Copy to Clipboard Toggle word wrap

   1

   Virtualization Operator バンドルの場合は virtualization を指定し、OpenShift AI Operator バンドルの場合は openshift-ai を指定します。この例では、Virtualization Operator バンドルを指定します。

   出力例

   {
     "description": "Run virtual machines alongside containers on one platform.",
     "id": "virtualization",
     "operators": [
       "kube-descheduler",
       "node-maintenance",
       "mtv",
       "nmstate",
       "fence-agents-remediation",
       "cnv",
       "node-healthcheck",
       "cluster-observability"
       "metallb"
       "numaresources"
       "oadp"
     ],
     "title": "Virtualization"
   }

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、バンドルに関連付けられている Operator をインストールします。

   $ curl -s -X POST https://api.openshift.com/api/assisted-install/v2/clusters \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -H "Content-Type: application/json" \
   -d "$(jq --null-input \
      --slurpfile pull_secret ~/Downloads/pull-secret.txt '
   {
      "name": "testcluster",
      "openshift_version": "4.15",
      "cpu_architecture" : "x86_64",
      "base_dns_domain": "example.com",
      "olm_operators": [ 

   1

   
     { "name": "node-healthcheck" }
   
     { "name": "fence-agents-remediation" }
   
     { "name": "kube-descheduler" }
   
     { "name": "mtv" }
   
     { "name": "nmstate" }
   
     { "name": "node-maintenance" }
   
     { "name": "cnv" } 

   2

   
   
     { "name": "nmstate" }
   
     { "name": "cluster-observability" }
   
     { "name": "metallb" }
   
     { "name": "numaresources" }
   
     { "name": "oadp" }
       ]
        "pull_secret": $pull_secret[0] | tojson
   }
   ')" | jq '.id'

   Copy to Clipboard Toggle word wrap

   1

   インストールする Operator バンドル内の Operator を指定します。この例では、Virtualization バンドルの Operator をリストしています。

   2

   以下の点に注意してください。

   • Virtualization バンドルでは、cnv を指定すると、lso がバックグラウンドで自動的にインストールされます。

   • OpenShift AI Operator バンドルの場合:

     • nvidia-gpu を指定すると、node-feature-discovery が自動的にインストールされます。
     • amd-gpu を指定すると、kmm が自動的にインストールされます。

手順

1. ロードバランサーをすべてのホストからアクセスできるように設定し、次のサービスにアクセスできるようにします。

   • OpenShift Machine Config Operator (MCO) - コントロールプレーンノード上。
   • OpenShift API - コントロールプレーンノード上。
   • Ingress Controller - コンピュート (ワーカー) ノード上。

   詳細は、ユーザー管理ロードバランサーの設定 (手順 1 と 2) を参照してください。

2. ユーザー管理ロードバランサーのフロントエンド IP アドレスをターゲットにするようにクラスターの DNS レコードを設定します。ロードバランサー経由で、クラスター API およびアプリケーションの DNS サーバーのレコードを更新する必要があります。

   • プライマリー API にアクセスできるように DNS レコードを設定します。

     <load_balancer_ip_address> <record_name> api.<cluster_name>.<base_domain>

     Copy to Clipboard Toggle word wrap

   • Ingress コントローラーを介して外部トラフィックをアプリケーションにルーティングするように DNS レコードを設定します。

     <load_balancer_ip_address> <record_name> apps.<cluster_name>.<base_domain>

     Copy to Clipboard Toggle word wrap

   • vSphere でのみ、お使いのネットワークの内部 API アクセスをサポートするように DNS レコードを設定します。

     <load_balancer_ip_address> <record_name> api-int.<cluster_name>.<base_domain>

     Copy to Clipboard Toggle word wrap

   詳細は、ユーザー管理ロードバランサーの設定 (手順 3) を参照してください。

3. Assisted Installer API クラスター定義に次の設定を追加します。

   1. user_managed_networking および load_balancer フィールドを以下の値に設定します。

      "user_managed_networking": false,
      "load_balancer": {
              "type": "user-managed"
      }

      Copy to Clipboard Toggle word wrap

      詳細は、ネットワーク管理タイプの変更 を参照してください。

   2. Ingress および API VIP を指定します。これらはロードバランサーの IP アドレスに対応している必要があります。

          "ingress_vips": [
              {
                  "cluster_id": "<cluster-id>",
                  "ip": "<load-balancer-ip>"
              }
          ],
          "api_vips": [
              {
                  "cluster_id": "<cluster-id>",
                  "ip": "<load-balancer-ip>"
              }
          ]

      Copy to Clipboard Toggle word wrap

   3. 以下のことを確実にするために、マシンネットワークのリストを指定します。

      • 各ノードに、1 つ以上のマシンネットワーク内の IP アドレスを持つ 1 つ以上のネットワークインターフェイスカード (NIC) があること。

      • ロードバランサーの IP (API の仮想 IP および Ingress 仮想 IP でもある) が、1 つ以上のマシンネットワークに含まれていること。

        例

         "machine_networks": [
            {
                "cidr": "<hosts-cidr-1>",
                "cluster_id": "<cluster-id>"
            },
            {
                "cidr": "<hosts-cidr-2>",
                "cluster_id": "<cluster-id>"
            },
            {
                "cidr": "<load-balancer-cidr>",
                "cluster_id": "<cluster-id>"
            }
        ]

        Copy to Clipboard Toggle word wrap

      詳細は、マシンネットワーク を参照してください。