4.4. 새 클러스터 등록
API에 새 클러스터 정의를 등록하려면 /v2/clusters 끝점을 사용합니다. 새 클러스터를 등록하려면 다음 설정이 필요합니다.
-
name
-
openshift-version
-
pull_secret
-
cpu_architecture
새 클러스터를 등록할 때 설정할 수 있는 필드에 대한 자세한 내용은 API 뷰어 의 cluster-create-params
모델을 참조하십시오. olm_operators
필드를 설정할 때 Operator 설치에 대한 자세한 내용은 추가 리소스 를 참조하십시오.
클러스터 정의를 생성한 후 클러스터 정의를 수정하고 추가 설정 값을 제공할 수 있습니다. 특정 설치 플랫폼 및 OpenShift Container Platform 버전의 경우 동일한 클러스터에서 두 개의 서로 다른 아키텍처를 결합하여 혼합 아키텍처 클러스터를 생성할 수도 있습니다. 자세한 내용은 추가 리소스 를 참조하십시오.
사전 요구 사항
-
유효한
API_TOKEN
을 생성했습니다. 토큰은 15분마다 만료됩니다. - 풀 시크릿을 다운로드했습니다.
-
선택 사항:
$PULL_SECRET
변수에 풀 시크릿을 할당했습니다.
프로세스
API 토큰을 새로 고칩니다.
$ source refresh-token
새 클러스터를 등록합니다.
선택 사항: 요청에 풀 시크릿 파일을 슬루핑하여 새 클러스터를 등록할 수 있습니다.
$ 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
새 클러스터 정의를 등록하면 클러스터의 인프라 환경을 생성합니다.
인프라 환경을 생성할 때까지 지원 설치 관리자 사용자 인터페이스에서 클러스터 구성 설정을 볼 수 없습니다.
추가 리소스