4.4. 新しいクラスターの登録
API を使用して新しいクラスター定義を登録するには、/v2/clusters エンドポイントを使用します。新しいクラスターを登録するには、次の設定が必要です。
-
name -
openshift-version -
pull_secret -
cpu_architecture
新しいクラスターを登録するときに設定できるフィールドの詳細は、API ビューアー の cluster-create-params モデルを参照してください。olm_operators フィールドを設定する場合の Operator のインストールに関する詳細は、関連情報 を参照してください。
クラスター定義を作成したら、クラスター定義を変更し、追加設定の値を指定できます。特定のインストールプラットフォームおよび OpenShift Container Platform バージョンについて、同じクラスター上に 2 つの異なるアーキテクチャーを組み合わせて混合アーキテクチャークラスターを作成することもできます。詳細は、関連情報 を参照 して ください。
前提条件
-
有効な
API_TOKENを生成した。トークンは 15 分ごとに期限切れになる。 - プルシークレットをダウンロードした。
-
オプション: プルシークレットを
$PULL_SECRET変数に割り当てた。
手順
API トークンを更新します。
source refresh-token
$ source refresh-tokenCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しいクラスターを登録します。
オプション: リクエストでプルシークレットファイルを一気に読み込むことで、新しいクラスターを登録できます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記オプション: 設定を JSON ファイルに書き込み、それをリクエストで参照することにより、新しいクラスターを登録できます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl -s -X POST "https://api.openshift.com/api/assisted-install/v2/clusters" \ -d @./cluster.json \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jq '.id'
$ curl -s -X POST "https://api.openshift.com/api/assisted-install/v2/clusters" \ -d @./cluster.json \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jq '.id'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
返された
cluster_idをCLUSTER_ID変数に割り当て、エクスポートします。export CLUSTER_ID=<cluster_id>
$ export CLUSTER_ID=<cluster_id>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記ターミナルセッションを閉じる場合は、新しいターミナルセッションで
CLUSTER_ID変数を再度エクスポートする必要があります。新しいクラスターのステータスを確認します。
curl -s -X GET "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jq
$ curl -s -X GET "https://api.openshift.com/api/assisted-install/v2/clusters/$CLUSTER_ID" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jqCopy to Clipboard Copied! Toggle word wrap Toggle overflow
新しいクラスター定義を登録したら、クラスターのインフラ環境を作成します。
インフラストラクチャー環境を作成するまで、Assisted Installer ユーザーインターフェイスにクラスター設定を表示することはできません。