11.5. AWS 클래식 아키텍처(ROSA) CLI에 Red Hat OpenShift Service 설치, rosa

프로세스

1. AWS 클래식 아키텍처 CLI(명령줄 인터페이스)에 Red Hat OpenShift Service를 설치합니다.

   1. 운영 체제에 대한 ROSA CLI의 최신 릴리스 를 다운로드합니다.
   2. 선택 사항: 다운로드한 실행 파일의 이름을 로타 로 다시 지정합니다. 이 문서에서는 rosa 를 사용하여 실행 파일을 참조합니다.

   3. 선택 사항: 경로에 로타를 추가합니다.

      예

      $ mv rosa /usr/local/bin/rosa

      Copy to Clipboard Toggle word wrap

   4. 다음 명령을 입력하여 설치를 확인합니다.

      $ rosa

      Copy to Clipboard Toggle word wrap

      출력 예

      Command-line tool for Red Hat OpenShift Service on AWS.
      For further documentation visit https://access.redhat.com/documentation/en-us/red_hat_openshift_service_on_aws
      
      Usage:
        rosa [command]
      
      Available Commands:
        completion  Generates completion scripts
        create      Create a resource from stdin
        delete      Delete a specific resource
        describe    Show details of a specific resource
        download    Download necessary tools for using your cluster
        edit        Edit a specific resource
        grant       Grant role to a specific resource
        help        Help about any command
        init        Applies templates to support Red Hat OpenShift Service on AWS
        install     Installs a resource into a cluster
        link        Link a ocm/user role from stdin
        list        List all resources of a specific type
        login       Log in to your Red Hat account
        logout      Log out
        logs        Show installation or uninstallation logs for a cluster
        revoke      Revoke role from a specific resource
        uninstall   Uninstalls a resource from a cluster
        unlink      UnLink a ocm/user role from stdin
        upgrade     Upgrade a resource
        verify      Verify resources are configured correctly for cluster install
        version     Prints the version of the tool
        whoami      Displays user account information
      
      Flags:
            --color string   Surround certain characters with escape sequences to display them in color on the terminal. Allowed options are [auto never always] (default "auto")
            --debug          Enable debug mode.
        -h, --help           help for rosa
      
      Use "rosa [command] --help" for more information about a command.

      Copy to Clipboard Toggle word wrap

   5. 선택 사항: ROSA CLI에 대한 명령 완료 스크립트를 생성합니다. 다음 예제에서는 Linux 시스템에 대한 Bash 완료 스크립트를 생성합니다.

      $ rosa completion bash | sudo tee /etc/bash_completion.d/rosa

      Copy to Clipboard Toggle word wrap

   6. 선택 사항: 기존 터미널에서 ROSA CLI에 대한 명령 완료를 활성화합니다. 다음 예제에서는 Linux 시스템의 기존 터미널에서 rosa 에 대한 Bash 완료를 활성화합니다.

      $ source /etc/bash_completion.d/rosa

      Copy to Clipboard Toggle word wrap

2. rosa 를 사용하여 Red Hat 계정에 로그인합니다.

   1. 다음 명령을 입력합니다.

      $ rosa login

      Copy to Clipboard Toggle word wrap

   2. & lt;my_offline_access_token&gt;을 토큰으로 바꿉니다.

      출력 예

      To login to your Red Hat account, get an offline access token at https://console.redhat.com/openshift/token/rosa
      ? Copy the token and paste it here: <my-offline-access-token>

      Copy to Clipboard Toggle word wrap

      출력 예가 계속됨

      I: Logged in as 'rh-rosa-user' on 'https://api.openshift.com'

      Copy to Clipboard Toggle word wrap

3. 다음 명령을 입력하여 AWS 계정에 필요한 권한이 있는지 확인합니다.

   $ rosa verify permissions

   Copy to Clipboard Toggle word wrap

   출력 예

   I: Validating SCP policies...
   I: AWS SCP policies ok

   Copy to Clipboard Toggle word wrap

   참고

   이 명령은 AWS STS(보안 토큰 서비스)를 사용하지 않는 ROSA 클러스터에 대한 권한만 확인합니다.

4. AWS 계정에 AWS 클래식 아키텍처 클러스터에 Red Hat OpenShift Service를 배포하는 데 필요한 할당량이 있는지 확인합니다.

   $ rosa verify quota --region=us-west-2

   Copy to Clipboard Toggle word wrap

   출력 예

   I: Validating AWS quota...
   I: AWS quota ok

   Copy to Clipboard Toggle word wrap

   참고

   AWS 할당량이 리전에 따라 다를 수 있습니다. 오류가 발생하면 다른 리전을 시도합니다.

   할당량을 늘려야 하는 경우 AWS 콘솔 로 이동하여 실패한 서비스에 대한 할당량 증가를 요청합니다.

   권한 및 할당량 검사가 모두 통과된 후 다음 단계로 진행합니다.

5. 클러스터 배포를 위해 AWS 계정을 준비합니다.

   1. 다음 명령을 실행하여 Red Hat 및 AWS 인증 정보가 올바르게 설정되었는지 확인합니다. AWS 계정 ID, 기본 리전 및 ARN이 예상과 일치하는지 확인합니다. 현재 OCM 으로 시작하는 행은 무시해도 됩니다.

      $ rosa whoami

      Copy to Clipboard Toggle word wrap

      출력 예

      AWS Account ID:               000000000000
      AWS Default Region:           us-east-2
      AWS ARN:                      arn:aws:iam::000000000000:user/hello
      OCM API:                      https://api.openshift.com
      OCM Account ID:               1DzGIdIhqEWyt8UUXQhSoWaaaaa
      OCM Account Name:             Your Name
      OCM Account Username:         you@domain.com
      OCM Account Email:            you@domain.com
      OCM Organization ID:          1HopHfA2hcmhup5gCr2uH5aaaaa
      OCM Organization Name:        Red Hat
      OCM Organization External ID: 0000000

      Copy to Clipboard Toggle word wrap

   2. AWS 계정을 초기화합니다. 이 단계에서는 클러스터 배포 및 관리를 위해 AWS 계정을 준비하는 CloudFormation 템플릿을 실행합니다. 이 단계를 완료하는 데 일반적으로 1-2 분이 걸립니다.

      $ rosa init

      Copy to Clipboard Toggle word wrap

      출력 예

      I: Logged in as 'rh-rosa-user' on 'https://api.openshift.com'
      I: Validating AWS credentials...
      I: AWS credentials are valid!
      I: Validating SCP policies...
      I: AWS SCP policies ok
      I: Validating AWS quota...
      I: AWS quota ok
      I: Ensuring cluster administrator user 'osdCcsAdmin'...
      I: Admin user 'osdCcsAdmin' created successfully!
      I: Verifying whether OpenShift command-line tool is available...
      E: OpenShift command-line tool is not installed.
      Run 'rosa download oc' to download the latest version, then add it to your PATH.

      Copy to Clipboard Toggle word wrap

6. ROSA CLI에서 OpenShift CLI(oc)를 설치합니다.

   1. 이 명령을 입력하여 oc CLI의 최신 버전을 다운로드합니다.

      $ rosa download oc

      Copy to Clipboard Toggle word wrap
   2. oc CLI를 다운로드한 후 압축을 풀고 경로에 추가합니다.

   3. 이 명령을 입력하여 oc CLI가 올바르게 설치되었는지 확인합니다.

      $ rosa verify oc

      Copy to Clipboard Toggle word wrap