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 トークンを更新します。
source refresh-token
$ source refresh-tokenCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新しいインフラストラクチャー環境を登録します。できればクラスター名を含む名前を指定します。この例では、クラスター ID を提供して、インフラストラクチャー環境をクラスターリソースに関連付けます。次の例では、
image_typeを指定しています。full-isoまたはminimum-iso のいずれかを指定できます。デフォルト値はminimal-isoです。オプション: リクエストでプルシークレットファイルを丸呑みすることで、新しいインフラストラクチャー環境を登録できます。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記- 1
- 有効な値を指定してください。x86_64、arm64、ppc64le、s390x、multi が有効です。
オプション: 設定を JSON ファイルに書き込み、それを要求で参照することにより、新しいインフラストラクチャー環境を登録できます。
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'Copy to Clipboard Copied! Toggle word wrap Toggle overflow
返された
IDをINFRA_ENV_ID変数に割り当て、エクスポートします。export INFRA_ENV_ID=<id>
$ export INFRA_ENV_ID=<id>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
インフラストラクチャー環境を作成し、cluster_id を介してクラスター定義に関連付けると、Assisted Installer Web ユーザーインターフェイスでクラスター設定を確認できます。ターミナルセッションを閉じる場合は、新しいターミナルセッションで ID を再エクスポートする必要があります。