환경 준비

프로세스

1. rosa CLI에 다음 명령을 입력하여 정책 파일을 준비합니다.

   $ curl -o ./rosa-installer-core.json https://raw.githubusercontent.com/openshift/managed-cluster-config/master/resources/sts/4.20/sts_installer_core_permission_boundary_policy.json

   Copy to Clipboard Toggle word wrap

2. AWS에서 정책을 생성하고 다음 명령을 입력하여 ARM(Amazon Resource Name)을 수집합니다.

   $ aws iam create-policy \
   --policy-name rosa-core-permissions-boundary-policy \
   --policy-document file://./rosa-installer-core.json \
   --description "ROSA installer core permission boundary policy, the minimum permission set, allows BYO-VPC, disallows PrivateLink"

   Copy to Clipboard Toggle word wrap

   출력 예

   {
       "Policy": {
           "PolicyName": "rosa-core-permissions-boundary-policy",
           "PolicyId": "<Policy ID>",
           "Arn": "arn:aws:iam::<account ID>:policy/rosa-core-permissions-boundary-policy",
           "Path": "/",
           "DefaultVersionId": "v1",
           "AttachmentCount": 0,
           "PermissionsBoundaryUsageCount": 0,
           "IsAttachable": true,
           "CreateDate": "<CreateDate>",
           "UpdateDate": "<UpdateDate>"
       }
   }

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 입력하여 제한하려는 설치 프로그램 역할에 권한 경계 정책을 추가합니다.

   $ aws iam put-role-permissions-boundary \
   --role-name ManagedOpenShift-Installer-Role \
   --permissions-boundary arn:aws:iam::<account ID>:policy/rosa-core-permissions-boundary-policy

   Copy to Clipboard Toggle word wrap

4. rosa CLI에 다음 명령을 입력하여 연결된 정책(권한 경계 포함)의 유효성을 확인하는 설치 프로그램 역할을 표시합니다.

   $ aws iam get-role --role-name ManagedOpenShift-Installer-Role \
   --output text | grep PERMISSIONSBOUNDARY

   Copy to Clipboard Toggle word wrap

   출력 예

   PERMISSIONSBOUNDARY	arn:aws:iam::<account ID>:policy/rosa-core-permissions-boundary-policy	Policy

   Copy to Clipboard Toggle word wrap

   PL 및 VPC 권한 경계 정책의 더 많은 예를 보려면 다음을 참조하십시오.

   예 3.2. sts_installer_privatelink_permission_boundary_policy.json

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "ec2:ModifyVpcEndpointServiceConfiguration",
           "route53:ListHostedZonesByVPC",
           "route53:CreateVPCAssociationAuthorization",
           "route53:AssociateVPCWithHostedZone",
           "route53:DeleteVPCAssociationAuthorization",
           "route53:DisassociateVPCFromHostedZone",
           "route53:ChangeResourceRecordSets"
         ],
         "Resource": "*"
       }
     ]
   }

   Copy to Clipboard Toggle word wrap

   예 3.3. sts_installer_vpc_permission_boundary_policy.json

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
   		    "ec2:AssociateDhcpOptions",
   		    "ec2:AssociateRouteTable",
   		    "ec2:AttachInternetGateway",
   		    "ec2:CreateDhcpOptions",
   		    "ec2:CreateInternetGateway",
   		    "ec2:CreateNatGateway",
   		    "ec2:CreateRouteTable",
   		    "ec2:CreateSubnet",
   		    "ec2:CreateVpc",
   		    "ec2:DeleteDhcpOptions",
   		    "ec2:DeleteInternetGateway",
   		    "ec2:DeleteNatGateway",
   		    "ec2:DeleteRouteTable",
   		    "ec2:DeleteSubnet",
   		    "ec2:DeleteVpc",
   		    "ec2:DetachInternetGateway",
   		    "ec2:DisassociateRouteTable",
   		    "ec2:ModifySubnetAttribute",
   		    "ec2:ModifyVpcAttribute",
   		    "ec2:ReplaceRouteTableAssociation"
               ],
               "Resource": "*"
           }
       ]
   }

   Copy to Clipboard Toggle word wrap

프로세스

1. 사용하려는 AWS(Amazon Web Services) 계정에 로그인합니다.

   전용 AWS 계정을 사용하여 프로덕션 클러스터를 실행하는 것이 좋습니다. AWS 조직을 사용하는 경우 조직 내에서 AWS 계정을 사용하거나 새 계정을 생성할 수 있습니다.

   AWS 조직을 사용하고 있고 사용하려는 AWS 계정에 서비스 제어 정책(SCP)이 적용되어야 하는 경우 이러한 정책은 클러스터에 필요한 역할과 정책보다 더 제한적이지 않아야 합니다.

2. AWS Management Console에서 AWS 클래식 아키텍처에서 Red Hat OpenShift Service를 활성화합니다.

   1. AWS 계정에 로그인합니다.
   2. AWS 클래식 아키텍처에서 Red Hat OpenShift Service를 활성화하려면 ROSA 서비스로 이동하여 OpenShift 사용을 선택합니다.

3. AWS CLI를 설치하고 구성합니다.

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

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

   2. 기본 AWS 리전을 설정합니다.

      참고

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

      AWS 클래식 아키텍처의 Red Hat OpenShift Service는 다음과 같은 우선 순위 순서로 리전을 평가합니다.

      1. --region 플래그를 사용하여 rosa 명령을 실행할 때 지정된 리전입니다.
      2. AWS_DEFAULT_REGION 환경 변수에 설정된 리전입니다. AWS 문서에서 AWS CLI를 구성하려면 환경 변수 를 참조하십시오.
      3. AWS 구성 파일에 설정된 기본 리전입니다. AWS 문서의 aws configure를 사용한 빠른 구성 을 참조하십시오.

   3. 선택 사항: 이름이 지정된 AWS 프로필을 사용하여 AWS CLI 설정 및 인증 정보를 구성합니다. Rosa 는 다음과 같은 우선 순위 순서로 이름이 지정된 AWS를 평가합니다.

      1. rosa 명령을 --profile 플래그를 사용하여 실행할 때 지정된 프로필입니다.
      2. AWS_PROFILE 환경 변수에 설정된 프로필입니다. AWS 문서의 이름이 지정된 프로필을 참조하십시오.

   4. 다음 명령을 실행하여 AWS API를 쿼리하여 AWS CLI가 올바르게 설치 및 구성되었는지 확인합니다.

      $ aws sts get-caller-identity

      Copy to Clipboard Toggle word wrap

4. ROSA CLI(rosa)의 최신 버전을 설치합니다.

   1. 운영 체제에 대한 ROSA CLI 의 최신 릴리스를 다운로드합니다.

   2. 선택 사항: 다운로드한 파일의 이름을 rosa 로 다시 지정하고 파일을 실행 가능하게 만듭니다. 이 문서에서는 rosa 를 사용하여 실행 파일을 참조합니다.

      $ chmod +x rosa

      Copy to Clipboard Toggle word wrap

   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 {product-title}. 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 명령 완료를 활성화합니다. 다음 예제에서는 Linux 시스템에서 rosa 에 대한 Bash 완료 스크립트를 소싱합니다.

      $ source /etc/bash_completion.d/rosa

      Copy to Clipboard Toggle word wrap

5. ROSA CLI를 사용하여 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

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

   $ rosa verify quota [--region=<aws_region>]

   Copy to Clipboard Toggle word wrap

   출력 예

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

   Copy to Clipboard Toggle word wrap

   참고

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

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

   할당량 확인이 성공하면 다음 단계를 진행합니다.

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

   1. 다음 명령을 실행하여 Red Hat 및 AWS 인증 정보가 올바르게 설정되었는지 확인합니다. AWS 계정 ID, 기본 리전 및 ARN이 예상과 일치하는지 확인합니다. 현재 OpenShift Cluster Manager로 시작하는 행을 안전하게 무시할 수 있습니다.

      $ rosa whoami

      Copy to Clipboard Toggle word wrap

      출력 예

      AWS Account ID:               000000000000
      AWS Default Region:           us-east-1
      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

8. ROSA(rosa) CLI에서 OpenShift CLI(oc), 버전 4.7.9 이상을 설치합니다.

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

      $ rosa download openshift-client

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

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

      $ rosa verify openshift-client

      Copy to Clipboard Toggle word wrap