1.3. CLI를 사용하여 HCP 클러스터로 ROSA 생성
ROSA(Red Hat OpenShift Service on AWS) CLI인 rosa
를 사용하여 클러스터를 생성하는 경우 기본 옵션을 선택하여 클러스터를 빠르게 생성할 수 있습니다.
사전 요구 사항
- HCP를 사용하여 ROSA에 대한 AWS 사전 요구 사항을 완료했습니다.
- 사용 가능한 AWS 서비스 할당량이 있습니다.
- AWS 콘솔에서 ROSA 서비스를 활성화했습니다.
-
설치 호스트에 최신 ROSA CLI(
rosa
)를 설치하고 구성했습니다.rosa 버전을
실행하여 현재 설치된 ROSA CLI 버전을 확인합니다. 최신 버전을 사용할 수 있는 경우 CLI는 이 업그레이드를 다운로드할 수 있는 링크를 제공합니다. - ROSA CLI를 사용하여 Red Hat 계정에 로그인했습니다.
- OIDC 구성을 생성했습니다.
- AWS 계정에 ELB(Elastic Load Balancing) 서비스 역할이 있는지 확인했습니다.
절차
다음 명령 중 하나를 사용하여 HCP 클러스터로 ROSA를 생성합니다.
참고HCP 클러스터를 사용하여 ROSA를 생성할 때 기본 머신 Classless Inter-Domain Routing (CIDR)은
10.0.0.0/16
입니다. VPC 서브넷의 CIDR 범위에 해당하지 않는 경우 다음 명령에--machine-cidr <address_block
>을 추가합니다. AWS에서 Red Hat OpenShift Service의 기본 CIDR 범위에 대한 자세한 내용은 CIDR 범위 정의를 참조하십시오.환경 변수를 설정하지 않은 경우 다음 명령을 실행합니다.
$ rosa create cluster --cluster-name=<cluster_name> \ <.> --mode=auto --hosted-cp [--private] \ <.> --operator-roles-prefix <operator-role-prefix> \ <.> --oidc-config-id <id-of-oidc-configuration> \ --subnet-ids=<public-subnet-id>,<private-subnet-id>
<.> 클러스터 이름을 지정합니다. 클러스터 이름이 15자보다 긴 경우 openshiftapps.com에서 프로비저닝된 클러스터의 하위 도메인으로 자동 생성된 도메인 접두사가 포함됩니다. 하위 도메인을 사용자 지정하려면
--domain-prefix
플래그를 사용합니다. 도메인 접두사는 15자를 초과할 수 없으며 고유해야 하며 클러스터 생성 후에는 변경할 수 없습니다. <.> 선택 사항: HCP 클러스터를 사용하여 개인 ROSA를 생성하는 데--private
인수가 사용됩니다. 이 인수를 사용하는 경우--subnet-ids
에 프라이빗 서브넷 ID만 사용해야 합니다. <.> 기본적으로 클러스터별 Operator 역할 이름 앞에는 클러스터 이름 및 임의의 4자리 해시가 추가됩니다. 선택 옵션으로 역할 이름에 <cluster_name>-<hash
>를 대체할 사용자 지정 접두사를 지정할 수 있습니다. 접두사는 클러스터별 Operator IAM 역할을 생성할 때 적용됩니다. 접두사에 대한 자세한 내용은 사용자 정의 Operator IAM 역할 접두사 정보를 참조하십시오.참고연결된 계정 전체 역할을 생성할 때 사용자 정의 ARN 경로를 지정한 경우 사용자 정의 경로가 자동으로 감지됩니다. 사용자 정의 경로는 이후 단계에서 생성할 때 클러스터별 Operator 역할에 적용됩니다.
환경 변수를 설정하는 경우 다음 명령을 실행하여 공개적으로 사용 가능한 API 및 공개적으로 사용 가능한 Ingress를 사용하여 단일 초기 머신 풀로 클러스터를 생성합니다.
$ rosa create cluster --private --cluster-name=<cluster_name> \ --mode=auto --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
환경 변수를 설정하는 경우 다음 명령을 실행하여 단일 초기 머신 풀, 공개적으로 사용 가능한 API 및 공개적으로 사용 가능한 Ingress로 클러스터를 생성합니다.
$ rosa create cluster --cluster-name=<cluster_name> --mode=auto \ --hosted-cp --operator-roles-prefix=$OPERATOR_ROLES_PREFIX \ --oidc-config-id=$OIDC_ID --subnet-ids=$SUBNET_IDS
다음 명령을 실행하여 클러스터 상태를 확인합니다.
$ rosa describe cluster --cluster=<cluster_name>
클러스터 설치가 진행됨에 따라 다음
상태
필드 변경 사항이 출력에 나열됩니다.-
보류 (사전 계정)
-
설치 ( 진행 중인 DNS 설정)
-
설치
Ready
참고설치에 실패하거나 10분 이상
State
필드가준비
상태가 아닌 경우 자세한 내용은 설치 문제 해결 설명서를 확인하십시오. 자세한 내용은 설치 문제 해결을 참조하십시오. Red Hat 지원에 문의하려면 AWS에서 Red Hat OpenShift Service에 대한 지원 받기를 참조하십시오.
-
AWS 설치 프로그램 로그에서 Red Hat OpenShift Service를 확인하여 클러스터 생성 진행 상황을 추적합니다. 로그를 확인하려면 다음 명령을 실행합니다.
$ rosa logs install --cluster=<cluster_name> --watch \ <.>
<.> 선택 사항: 설치가 진행되는 동안 새 로그 메시지를 조사하려면
--watch
인수를 사용합니다.