4.7. 注册新的基础架构环境
使用 Assisted Installer API 注册新集群定义后,使用 v2/infra-envs 端点创建一个基础架构环境。注册新的基础架构环境需要以下设置:
-
name
-
pull_secret
-
cpu_architecture
有关注册新基础架构环境时可以设置的字段的详情,请参阅 API viewer 中的 infra-env-create-params
模型。您可以在创建基础架构环境后修改基础架构环境。作为最佳实践,请考虑在创建新基础架构环境时包括 cluster_id
。cluster_id
将基础架构环境与集群定义相关联。在创建新基础架构环境时,辅助安装程序也会生成发现 ISO。
先决条件
-
您已生成了一个有效的
API_TOKEN
。令牌每 15 分钟过期一次。 - 您已下载了 pull secret。
-
可选: 注册一个新的集群定义并导出
cluster_id
。
流程
刷新 API 令牌:
$ source refresh-token
注册新的基础架构环境。提供名称,最好包含集群名称。本例提供集群 ID,用于将基础架构环境与集群资源关联。以下示例指定了
image_type
。您可以指定full-iso
或minimal-iso
。默认值为minimal-iso
。可选: 您可以通过在请求中分片 pull secret 文件来注册新的基础架构环境:
$ 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 文件并在请求中引用它来注册新的基础架构环境:
$ cat << EOF > infra-envs.json { "name": "testcluster", "pull_secret": $PULL_SECRET, "proxy": { "http_proxy": "", "https_proxy": "", "no_proxy": "" }, "ssh_authorized_key": "$CLUSTER_SSHKEY", "image_type": "full-iso", "cluster_id": "${CLUSTER_ID}", "openshift_version": "4.11" } EOF
$ 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'
为
INFRA_ENV_ID
变量分配返回的id
并导出它:$ export INFRA_ENV_ID=<id>
创建基础架构环境并通过 cluster_id
将其与集群定义相关联后,您可以在 Assisted Installer Web 用户界面中看到集群设置。如果您关闭终端会话,则需要在新终端会话中重新导出 id
。