4.4. 注册新集群
要使用 API 注册新集群定义,请使用 /v2/clusters 端点。注册新集群需要以下设置:
-
name
-
openshift-version
-
pull_secret
-
cpu_architecture
有关注册新集群时可设置的字段的详情,请参阅 API viewer 中的 cluster-create-params
模型。设置 olm_operators
字段时,请参阅安装 Operator 的详情,请参阅附加资源。
创建集群定义后,您可以修改集群定义并为附加设置提供值。对于某些安装平台和 OpenShift Container Platform 版本,您还可以在同一集群中合并两个不同的架构来创建混合架构集群。详情请查看 附加资源。
先决条件
-
您已生成了一个有效的
API_TOKEN
。令牌每 15 分钟过期一次。 - 您已下载了 pull secret。
-
可选: 您已将 pull secret 分配给
$PULL_SECRET
变量。
流程
刷新 API 令牌:
source refresh-token
$ source refresh-token
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注册新集群。
可选: 您可以通过在请求中分片 pull secret 文件来注册新集群:
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" \ | jq
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
注册新的集群定义后,为集群创建基础架构环境。
在创建基础架构环境前,您无法在 Assisted Installer 用户界面中看到集群配置设置。