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
新しいクラスターを登録します。
オプション: リクエストでプルシークレットファイルを一気に読み込むことで、新しいクラスターを登録できます。
$ 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.11", "cpu_architecture" : "<architecture_name>" 1 "high_availability_mode": <cluster_type>, 2 "base_dns_domain": "example.com", "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
注記オプション: 設定を JSON ファイルに書き込み、それをリクエストで参照することにより、新しいクラスターを登録できます。
cat << EOF > cluster.json { "name": "testcluster", "openshift_version": "4.11", "high_availability_mode": "<cluster_type>", "base_dns_domain": "example.com", "pull_secret": $PULL_SECRET } EOF
$ 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'
返された
cluster_id
をCLUSTER_ID
変数に割り当て、エクスポートします。$ export CLUSTER_ID=<cluster_id>
注記ターミナルセッションを閉じる場合は、新しいターミナルセッションで
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
新しいクラスター定義を登録したら、クラスターのインフラ環境を作成します。
インフラストラクチャー環境を作成するまで、Assisted Installer ユーザーインターフェイスにクラスター設定を表示することはできません。