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
注册新集群。
可选: 您可以通过在请求中分片 pull secret 文件来注册新集群:
$ 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 用户界面中看到集群配置设置。
其他资源