4.6. 新しいインフラ環境の登録
Assisted Installer API を使用して新しいクラスター定義を登録したら、v2/infra-envs エンドポイントを使用してインフラストラクチャー環境を作成します。新しいインフラストラクチャー環境を登録するには、次の設定が必要です。
-
name
-
pull_secret
-
cpu_architecture
新しいインフラストラクチャー環境を登録するときに設定できるフィールドの詳細は、API ビューアー の infra-env-create-params
モデルを参照してください。インフラストラクチャー環境は、作成後に変更できます。ベストプラクティスとして、新しいインフラストラクチャー環境を作成するときに cluster_id
を含めることを検討してください。cluster_id
は、インフラストラクチャー環境をクラスター定義に関連付けます。新しいインフラストラクチャー環境を作成するとき、Assisted Installer は検出 ISO も生成します。
前提条件
-
有効な
API_TOKEN
を生成した。トークンは 15 分ごとに期限切れになる。 - プルシークレットをダウンロードした。
-
オプション: 新しいクラスター定義を登録し、
cluster_id
をエクスポートした。
手順
API トークンを更新します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow source refresh-token
$ source refresh-token
新しいインフラストラクチャー環境を登録します。できればクラスター名を含む名前を指定します。この例では、クラスター ID を提供して、インフラストラクチャー環境をクラスターリソースに関連付けます。次の例では、
image_type
を指定しています。full-iso
またはminimum-
iso のいずれかを指定できます。デフォルト値はminimal-iso
です。オプション: リクエストでプルシークレットファイルを丸呑みすることで、新しいインフラストラクチャー環境を登録できます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl https://api.openshift.com/api/assisted-install/v2/infra-envs \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt \ --arg cluster_id ${CLUSTER_ID} '
$ curl https://api.openshift.com/api/assisted-install/v2/infra-envs \ -H "Authorization: Bearer ${API_TOKEN}" \ -H "Content-Type: application/json" \ -d "$(jq --null-input \ --slurpfile pull_secret ~/Downloads/pull-secret.txt \ --arg cluster_id ${CLUSTER_ID} ' { "name": "testcluster-infra-env", "image_type":"full-iso", "cluster_id": $cluster_id, "cpu_architecture" : "<architecture_name>"
1 "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
注記- 1
- 有効な値を指定してください。x86_64、arm64、ppc64le、s390x、multi が有効です。
オプション: 設定を JSON ファイルに書き込み、それを要求で参照することにより、新しいインフラストラクチャー環境を登録できます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow cat << EOF > infra-envs.json { "name": "testcluster-infra-env", "image_type": "full-iso", "cluster_id": "$CLUSTER_ID", "pull_secret": $PULL_SECRET } EOF
$ cat << EOF > infra-envs.json { "name": "testcluster-infra-env", "image_type": "full-iso", "cluster_id": "$CLUSTER_ID", "pull_secret": $PULL_SECRET } EOF
Copy to Clipboard Copied! Toggle word wrap Toggle overflow curl -s -X POST "https://api.openshift.com/api/assisted-install/v2/infra-envs" \ -d @./infra-envs.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/infra-envs" \ -d @./infra-envs.json \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $API_TOKEN" \ | jq '.id'
返された
ID
をINFRA_ENV_ID
変数に割り当て、エクスポートします。Copy to Clipboard Copied! Toggle word wrap Toggle overflow export INFRA_ENV_ID=<id>
$ export INFRA_ENV_ID=<id>
インフラストラクチャー環境を作成し、cluster_id
を介してクラスター定義に関連付けると、Assisted Installer Web ユーザーインターフェイスでクラスター設定を確認できます。ターミナルセッションを閉じる場合は、新しいターミナルセッションで ID
を再エクスポートする必要があります。