8장. ROSA CLI

절차

1. 최신 AWS CLI(aws)를 설치하고 구성합니다.

   1. AWS 명령줄 인터페이스 설명서에 따라 운영 체제에 대한 AWS CLI를 설치하고 구성합니다.

      aws_access_key_id,aws_secret_access_key 및 region 을 .aws/credentials 파일에 지정합니다. AWS 문서의 AWS 구성 기본 사항을 참조하십시오.

      참고

      필요한 경우 AWS_DEFAULT_REGION 환경 변수를 사용하여 기본 AWS 리전을 설정할 수 있습니다.

   2. AWS API를 쿼리하여 AWS CLI가 올바르게 설치되어 구성되었는지 확인합니다.

      $ aws sts get-caller-identity  --output text

      Copy to Clipboard Toggle word wrap

      출력 예

      <aws_account_id>    arn:aws:iam::<aws_account_id>:user/<username>  <aws_user_id>

      Copy to Clipboard Toggle word wrap

2. OpenShift Cluster Manager의 다운로드 페이지에서 운영 체제용 ROSA CLI(rosa) 최신 버전을 다운로드합니다.

3. 다운로드한 아카이브에서 rosa 바이너리 파일을 추출합니다. 다음 예제에서는 Linux tar 아카이브에서 바이너리를 추출합니다.

   $ tar xvf rosa-linux.tar.gz

   Copy to Clipboard Toggle word wrap

4. 경로에 rosa 를 추가하십시오. 다음 예에서는 /usr/local/bin 디렉터리가 사용자의 경로에 포함됩니다.

   $ sudo mv rosa /usr/local/bin/rosa

   Copy to Clipboard Toggle word wrap

5. rosa 버전을 쿼리하여 ROSA CLI가 올바르게 설치되었는지 확인합니다.

   $ rosa version

   Copy to Clipboard Toggle word wrap

   출력 예

   1.2.15
   Your ROSA CLI is up to date.

   Copy to Clipboard Toggle word wrap

6. 선택 사항: ROSA CLI에 대한 탭 완료를 활성화합니다. 탭 완료가 활성화되면 Tab 키를 두 번 눌러 하위 명령을 자동으로 완료하고 명령 제안을 수신할 수 있습니다.

   • Linux 호스트에서 Bash의 영구 탭 완료를 활성화하려면 다음을 수행합니다.

     1. Bash에 대한 rosa 탭 완료 구성 파일을 생성하여 /etc/bash_completion.d/ 디렉터리에 저장합니다.

        # rosa completion bash > /etc/bash_completion.d/rosa

        Copy to Clipboard Toggle word wrap
     2. 새 터미널을 열어 구성을 활성화합니다.

   • macOS 호스트에서 Bash에 대한 영구 탭 완료를 활성화하려면 다음을 수행합니다.

     1. Bash에 대한 rosa 탭 완료 구성 파일을 생성하여 /usr/local/etc/bash_completion.d/ 디렉터리에 저장합니다.

        $ rosa completion bash > /usr/local/etc/bash_completion.d/rosa

        Copy to Clipboard Toggle word wrap
     2. 새 터미널을 열어 구성을 활성화합니다.

   • Zsh에 대해 영구 탭 완료를 활성화하려면 다음을 수행합니다.

     1. Zsh 환경에 탭 완료가 활성화되지 않은 경우 다음 명령을 실행하여 활성화합니다.

        $ echo "autoload -U compinit; compinit" >> ~/.zshrc

        Copy to Clipboard Toggle word wrap

     2. Zsh에 대한 rosa 탭 완료 구성 파일을 생성하여 함수 경로의 첫 번째 디렉터리에 저장합니다.

        $ rosa completion zsh > "${fpath[1]}/_rosa"

        Copy to Clipboard Toggle word wrap
     3. 새 터미널을 열어 구성을 활성화합니다.

   • 어류에 대한 지속적인 탭 완료를 활성화하려면 다음을 수행합니다.

     1. 어류에 대한 rosa 탭 완료 구성 파일을 생성하여 ~/.config/fish/completions/ 디렉터리에 저장합니다.

        $ rosa completion fish > ~/.config/fish/completions/rosa.fish

        Copy to Clipboard Toggle word wrap
     2. 새 터미널을 열어 구성을 활성화합니다.

   • PowerShell에 대해 영구 탭 완료를 활성화하려면 다음을 수행합니다.

     1. PowerShell에 대한 rosa 탭 완료 구성 파일을 생성하여 rosa.ps1 이라는 파일에 저장합니다.

        PS> rosa completion powershell | Out-String | Invoke-Expression

        Copy to Clipboard Toggle word wrap
     2. PowerShell 프로필에서 rosa.ps1 파일을 가져옵니다.
   참고

   rosa 탭 완료 구성에 대한 자세한 내용은 rosa completion --help 명령을 실행하여 도움말 메뉴를 참조하십시오.

프로세스

1. Red Hat 의 Red Hat OpenShift Cluster Manager 오프라인 토큰을 사용하여 Roa 를 초기화합니다.

   $ rosa init --token=<token>

   Copy to Clipboard Toggle word wrap

2. ROSA 클러스터를 생성합니다.

   $ rosa create cluster --cluster-name=<cluster_name>

   Copy to Clipboard Toggle word wrap

3. IDP(ID 공급자)를 추가합니다.

   $ rosa create idp --cluster=<cluster_name> --type=<identity_provider> [arguments]

   Copy to Clipboard Toggle word wrap

4. dedicated-admin 사용자를 추가합니다.

   $ rosa grant user dedicated-admin --user=<idp_user_name> --cluster=<cluster_name>

   Copy to Clipboard Toggle word wrap

프로세스

1. ROSA CLI(rosa)의 새 버전을 사용할 수 있는지 확인합니다.

   $ rosa version

   Copy to Clipboard Toggle word wrap

   출력 예

   1.2.12
   There is a newer release version '1.2.15', please consider updating: https://mirror.openshift.com/pub/openshift-v4/clients/rosa/latest/

   Copy to Clipboard Toggle word wrap

2. ROSA CLI의 최신 호환 버전을 다운로드합니다.

   $ rosa download rosa

   Copy to Clipboard Toggle word wrap

   이 명령은 rosa-*.tar.gz 라는 아카이브를 현재 디렉터리로 다운로드합니다. 파일의 정확한 이름은 운영 체제 및 시스템 아키텍처에 따라 다릅니다.

3. 아카이브 내용을 추출합니다.

   $ tar -xzf rosa-linux.tar.gz

   Copy to Clipboard Toggle word wrap

4. 추출된 파일을 경로로 이동하여 ROSA CLI의 새 버전을 설치합니다. 다음 예에서는 /usr/local/bin 디렉터리가 사용자의 경로에 포함됩니다.

   $ sudo mv rosa /usr/local/bin/rosa

   Copy to Clipboard Toggle word wrap