4.5. 注册新集群
要使用 API 注册新集群定义，请使用 /v2/clusters 端点。
以下参数是必需的：
-
name -
openshift-version -
pull_secret -
cpu_architecture
有关注册新集群时可设置的字段的详情，请参阅 API viewer 中的 cluster-create-params 模型。设置 olm_operators 字段时，请参阅 其它资源，以了解安装 Operator 的详情。
先决条件
-
您已生成了一个有效的
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.16", \ 1 "high_availability_mode": "<mode>", \ 2 "cpu_architecture" : "<architecture_name>", \ 3 "base_dns_domain": "example.com", \ "pull_secret": $pull_secret[0] | tojson \ } \ ')" | jq '.id'通过执行以下操作注册集群：
将配置写入 JSON 文件：
$ cat << EOF > cluster.json { "name": "testcluster", "openshift_version": "4.16", 1 "high_availability_mode": "<mode>", 2 "base_dns_domain": "example.com", "network_type": "examplenetwork", "cluster_network_cidr":"11.111.1.0/14" "cluster_network_host_prefix": 11, "service_network_cidr": "111.11.1.0/16", "api_vips":[{"ip": ""}], "ingress_vips": [{"ip": ""}], "vip_dhcp_allocation": false, "additional_ntp_source": "clock.redhat.com,clock2.redhat.com", "ssh_public_key": "$CLUSTER_SSHKEY", "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 用户界面中看到集群配置设置。
4.5.1. 安装 Operator
您可以在注册新集群时安装以下 Operator：
OpenShift Virtualization Operator
注意目前，IBM Z® 和 IBM Power® 不支持 OpenShift Virtualization。
- 多集群引擎 Operator
- OpenShift Data Foundation Operator
- LVM 存储 Operator
如果需要高级选项，请在安装集群后安装 Operator。
流程
运行以下命令:
$ 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.15", "cpu_architecture" : "x86_64", "base_dns_domain": "example.com", "olm_operators": [ { "name": "mce" } 1 , { "name": "odf" } 2 ] "pull_secret": $pull_secret[0] | tojson } ')" | jq '.id'
