4.2. 컴퓨팅 노드 관리

사전 요구 사항

• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.

검증

• 머신 풀이 머신 풀 페이지에 표시되고 구성이 예상대로 표시되는지 확인합니다.

사전 요구 사항

• 워크스테이션에 최신 ROSA CLI를 설치하고 구성했습니다.
• ROSA CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.

프로세스

• 자동 스케일링을 사용하지 않는 머신 풀을 추가하려면 시스템 풀을 생성하고 인스턴스 유형, compute(작업자) 노드 수 및 노드 레이블을 정의합니다.

  $ rosa create machinepool --cluster=<cluster-name> \
                            --name=<machine_pool_id> \
                            --replicas=<replica_count> \
                            --instance-type=<instance_type> \
                            --labels=<key>=<value>,<key>=<value> \
                            --taints=<key>=<value>:<effect>,<key>=<value>:<effect> \
                            --disk-size=<disk_size> \
                            --availability-zone=<availability_zone_name> \
                            --additional-security-group-ids <sec_group_id> \
                            --subnet <subnet_id>

  Copy to Clipboard Toggle word wrap

  다음과 같습니다.

  --name=<machine_pool_id>

  머신 풀의 이름을 지정합니다.

  --replicas=<replica_count>

  프로비저닝할 컴퓨팅 노드 수를 지정합니다. 단일 가용성 영역을 사용하여 AWS에 Red Hat OpenShift Service를 배포한 경우 영역의 시스템 풀에 프로비저닝할 컴퓨팅 노드 수를 정의합니다. 여러 가용성 영역을 사용하여 클러스터를 배포한 경우 모든 영역에서 총 프로비저닝할 컴퓨팅 노드 수를 정의하고 개수는 3의 배수여야 합니다. 자동 스케일링이 구성되지 않은 경우 --replicas 인수가 필요합니다.

  --instance-type=<instance_type>

  선택 사항: 시스템 풀의 컴퓨팅 노드의 인스턴스 유형을 설정합니다. 인스턴스 유형은 풀의 각 계산 노드에 대한 vCPU 및 메모리 할당을 정의합니다. &lt ;instance_type&gt;을 인스턴스 유형으로 바꿉니다. 기본값은 m5.xlarge 입니다. 풀을 생성한 후에는 머신 풀의 인스턴스 유형을 변경할 수 없습니다.

  --labels=<key>=<value>,<key>=<value>

  선택 사항: 머신 풀의 레이블을 정의합니다. < key>=<value>,<key>=<value >를 쉼표로 구분된 키-값 쌍 목록(예: --labels=key1=value1,key2=value2 )으로 바꿉니다.

  --taints=<key>=<value>:<effect>,<key>=<value>:<effect>

  선택 사항: 머신 풀의 테인트를 정의합니다. < key>=<value>:<effect>,<key>=<value>: <effect>를 각 테인트의 키, 값 및 효과(예: --taints=key1=value1:NoExecute )로 바꿉니다. 사용 가능한 효과에는 NoSchedule,PreferNoSchedule, NoExecute 가 포함됩니다.

  --disk-size=<disk_size>

  선택 사항: 작업자 노드 디스크 크기를 지정합니다. 값은 GB, GiB, TB 또는 TiB일 수 있습니다. &lt ;disk_size >를 숫자 값 및 단위(예: --disk-size=200GiB )로 바꿉니다.

  --availability-zone=<availability_zone_name>

  선택 사항: 선택한 가용성 영역에서 머신 풀을 생성할 수 있습니다. & lt;availability_zone_name&gt;을 가용성 영역 이름으로 바꿉니다.

  --additional-security-group-ids <sec_group_id>

  선택 사항: Red Hat 관리 VPC가 없는 클러스터의 머신 풀의 경우 머신 풀에서 사용할 추가 사용자 지정 보안 그룹을 선택할 수 있습니다. 보안 그룹을 이미 생성하여 이 클러스터에 대해 선택한 VPC와 연결되어야 합니다. 머신 풀을 생성한 후에는 보안 그룹을 추가하거나 편집할 수 없습니다.

  중요

  AWS 클러스터의 Red Hat OpenShift Service의 머신 풀에 최대 10개의 추가 보안 그룹을 사용할 수 있습니다.

  --subnet <subnet_id>

  선택 사항: BYO VPC 클러스터의 경우 서브넷을 선택하여 Single-AZ 머신 풀을 생성할 수 있습니다. 서브넷이 클러스터 생성 서브넷에서 벗어나는 경우 키 kubernetes.io/cluster/<infra-id > 및 값이 shared 인 태그가 있어야 합니다. 고객은 다음 명령을 사용하여 Infra ID를 얻을 수 있습니다.

  $ rosa describe cluster -c <cluster name>|grep "Infra ID:"

  Copy to Clipboard Toggle word wrap

  출력 예

  Infra ID:                   mycluster-xqvj7

  Copy to Clipboard Toggle word wrap

  참고

  --subnet 및 --availability-zone 을 동시에 설정할 수 없으며 Single-AZ 머신 풀 생성에는 1개만 허용됩니다.

  다음 예제에서는 m5.xlarge 인스턴스 유형을 사용하고 2개의 컴퓨팅 노드 복제본을 사용하는 mymachinepool 이라는 시스템 풀을 생성합니다. 이 예제에서는 두 개의 워크로드별 레이블을 추가합니다.

  $ rosa create machinepool --cluster=mycluster --name=mymachinepool --replicas=2 --instance-type=m5.xlarge --labels=app=db,tier=backend

  Copy to Clipboard Toggle word wrap

  출력 예

  I: Machine pool 'mymachinepool' created successfully on cluster 'mycluster'
  I: To view all machine pools, run 'rosa list machinepools -c mycluster'

  Copy to Clipboard Toggle word wrap

• 자동 스케일링을 사용하는 머신 풀을 추가하려면 머신 풀을 생성하고 자동 스케일링 구성, 인스턴스 유형 및 노드 레이블을 정의합니다.

  $ rosa create machinepool --cluster=<cluster-name> \
                            --name=<machine_pool_id> \
                            --enable-autoscaling \
                            --min-replicas=<minimum_replica_count> \
                            --max-replicas=<maximum_replica_count> \
                            --instance-type=<instance_type> \
                            --labels=<key>=<value>,<key>=<value> \
                            --taints=<key>=<value>:<effect>,<key>=<value>:<effect> \
                            --availability-zone=<availability_zone_name>

  Copy to Clipboard Toggle word wrap

  다음과 같습니다.

  --name=<machine_pool_id>

  머신 풀의 이름을 지정합니다. & lt;machine_pool_id >를 머신 풀 이름으로 바꿉니다.

  --enable-autoscaling

  시스템 풀에서 자동 스케일링을 통해 배포 요구 사항을 충족할 수 있습니다.

  --min-replicas=<minimum_replica_count> and --max-replicas=<maximum_replica_count>

  최소 및 최대 컴퓨팅 노드 제한을 정의합니다. 클러스터 자동 스케일러는 사용자가 지정하는 제한을 초과하여 머신 풀 노드 수를 줄이거나 늘리지 않습니다.

  --min-replicas 및 --max-replicas 인수는 가용성 영역의 시스템 풀에서 자동 스케일링 제한을 정의합니다.

  --instance-type=<instance_type>

  선택 사항: 시스템 풀의 컴퓨팅 노드의 인스턴스 유형을 설정합니다. 인스턴스 유형은 풀의 각 계산 노드에 대한 vCPU 및 메모리 할당을 정의합니다. &lt ;instance_type&gt;을 인스턴스 유형으로 바꿉니다. 기본값은 m5.xlarge 입니다. 풀을 생성한 후에는 머신 풀의 인스턴스 유형을 변경할 수 없습니다.

  --labels=<key>=<value>,<key>=<value>

  선택 사항: 머신 풀의 레이블을 정의합니다. < key>=<value>,<key>=<value >를 쉼표로 구분된 키-값 쌍 목록(예: --labels=key1=value1,key2=value2 )으로 바꿉니다.

  --taints=<key>=<value>:<effect>,<key>=<value>:<effect>

  선택 사항: 머신 풀의 테인트를 정의합니다. < key>=<value>:<effect>,<key>=<value>: <effect>를 각 테인트의 키, 값 및 효과(예: --taints=key1=value1:NoExecute )로 바꿉니다. 사용 가능한 효과에는 NoSchedule,PreferNoSchedule, NoExecute 가 포함됩니다.

  --availability-zone=<availability_zone_name>

  선택 사항: 선택한 가용성 영역에서 머신 풀을 생성할 수 있습니다. & lt;availability_zone_name&gt;을 가용성 영역 이름으로 바꿉니다.

  다음 예제에서는 m5.xlarge 인스턴스 유형을 사용하고 자동 스케일링이 활성화된 mymachinepool 이라는 시스템 풀을 생성합니다. 최소 컴퓨팅 노드 제한은 3이고 최대값은 전체적으로 6입니다. 이 예제에서는 두 개의 워크로드별 레이블을 추가합니다.

  $ rosa create machinepool --cluster=mycluster --name=mymachinepool --enable-autoscaling --min-replicas=3 --max-replicas=6 --instance-type=m5.xlarge --labels=app=db,tier=backend

  Copy to Clipboard Toggle word wrap

  출력 예

  I: Machine pool 'mymachinepool' created successfully on hosted cluster 'mycluster'
  I: To view all machine pools, run 'rosa list machinepools -c mycluster'

  Copy to Clipboard Toggle word wrap

• AWS 클러스터의 Red Hat OpenShift Service에 Windows 라이센스 포함 머신 풀을 추가하려면 AWS의 Red Hat OpenShift Service에 대한 AWS Windows 라이센스 포함 을 참조하십시오.

  Windows 라이센스 포함 머신 풀은 다음 기준이 충족될 때만 생성할 수 있습니다.

  • 호스트 클러스터는 AWS 클러스터의 Red Hat OpenShift Service입니다.

  • 인스턴스 유형은 베어 메탈 EC2입니다.

    중요

    AWS Windows 라이센스: AWS의 Red Hat OpenShift Service는 기술 프리뷰 기능 전용입니다. 기술 프리뷰 기능은 Red Hat 프로덕션 서비스 수준 계약(SLA)에서 지원되지 않으며 기능적으로 완전하지 않을 수 있습니다. Red Hat은 프로덕션 환경에서 사용하는 것을 권장하지 않습니다. 이러한 기능을 사용하면 향후 제품 기능을 조기에 이용할 수 있어 개발 과정에서 고객이 기능을 테스트하고 피드백을 제공할 수 있습니다.

    Red Hat 기술 프리뷰 기능의 지원 범위에 대한 자세한 내용은 기술 프리뷰 기능 지원 범위를 참조하십시오.

사전 요구 사항

• ROSA CLI 버전 1.2.57 이상을 설치하고 구성했습니다.
• ROSA CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터 버전 4.19 이상에서 Red Hat OpenShift Service를 생성하셨습니다.
• 클러스터에 이미 용량 예약 또는 테인트를 사용하지 않는 머신 풀이 있습니다. 머신 풀에는 작업자 노드가 2개 이상 있어야 합니다.
• 용량 예약 ID가 있고 용량은 생성 중인 머신 풀의 가용성 영역(AZ)에 필요한 인스턴스 유형에 대해 예약되어 있습니다.

프로세스

• 시스템 풀을 생성하고 다음 명령을 실행하여 인스턴스 유형, 작업자 노드 수 및 용량 예약 ID를 정의합니다.

  $ rosa create machinepool --cluster=<cluster-name> \
                            --name=<machine_pool_id> \
                            --replicas=<replica_count> \
                            --capacity-reservation-id cr-<capacity_reservation_id> \
                            --instance-type=<instance_type> \
                            --subnet <subnet_id>

  Copy to Clipboard Toggle word wrap

  다음과 같습니다.

  <machine_pool_id>

  머신 풀의 이름을 지정합니다.

  <replica_count>

  프로비저닝된 컴퓨팅 노드 수를 지정합니다. 단일 AZ를 사용하여 AWS에 Red Hat OpenShift Service를 배포하는 경우 AZ의 시스템 풀에 프로비저닝된 컴퓨팅 노드 수를 정의합니다. 여러 AZ를 사용하여 클러스터를 배포하는 경우 모든 AZ에 프로비저닝된 총 컴퓨팅 노드 수를 정의합니다. 다중 영역 클러스터의 경우 컴퓨팅 노드 수가 3의 배수여야 합니다. 자동 스케일링이 구성되지 않은 경우 --replicas 인수가 필요합니다.

  cr-<capacity_reservation_id>

  예약 ID를 지정합니다. AWS에서 용량 예약을 구매할 때 cr-<capacity_reservation_id > 형식으로 ID를 가져옵니다. ID는 온 디맨드 용량 예약 또는 ML의 용량 블록 모두에 사용할 수 있으므로 예약 유형을 지정할 필요가 없습니다.

  <instance_type>

  선택 사항: 머신 풀의 컴퓨팅 노드의 인스턴스 유형을 지정합니다. 인스턴스 유형은 풀의 각 계산 노드에 대한 vCPU 및 메모리 할당을 정의합니다. &lt ;instance_type&gt;을 인스턴스 유형으로 바꿉니다. 기본값은 m5.xlarge 입니다. 풀을 생성한 후에는 머신 풀의 인스턴스 유형을 변경할 수 없습니다.

  <subnet_id>

  선택 사항: 서브넷 ID를 지정합니다. BYO VPC(Bring Your Own Private Cloud) 클러스터의 경우 서브넷을 선택하여 단일 AZ 머신 풀을 생성할 수 있습니다. 초기 클러스터 생성 중에 지정되지 않은 서브넷을 선택하는 경우 kubernetes.io/cluster/<infra-id > 키와 공유 값으로 서브넷에 태그를 지정해야 합니다. 고객은 다음 명령을 실행하여 Infra ID를 가져올 수 있습니다.

  $ rosa describe cluster --cluster <cluster_name>|grep "Infra ID:"

  Copy to Clipboard Toggle word wrap

  출력 예

  Infra ID:                   mycluster-xqvj7

  Copy to Clipboard Toggle word wrap

• 다음 명령을 실행하여 클러스터에서 사용 가능한 머신 풀을 나열합니다.

  $ rosa list machinepools --cluster <cluster_name>

  Copy to Clipboard Toggle word wrap

• 다음 명령을 실행하여 클러스터의 특정 시스템 풀 정보를 설명합니다.

  $ rosa describe machinepool --cluster <cluster_name> --machinepool <machine_pool_name>

  Copy to Clipboard Toggle word wrap

  출력 예

  ID:                         <machine_pool_name>
  Cluster ID:                 <cluster-id>
  Autoscaling:                No
  Desired replicas:           1
  Current replicas:           1
  Instance type:              c5.xlarge
  Labels:
  Tags:                       red-hat-managed=true, api.openshift.com/environment=production, api.openshift.com/id=<cluster_name>, api.openshift.com/legal-entity-id=<legal_entity_id>, api.openshift.com/name=<cluster_name>, api.openshift.com/nodepool-hypershift=<cluster_name>-<machine_pool_name>, api.openshift.com/nodepool-ocm=<machine_pool_name>, red-hat-clustertype=rosa
  Taints:
  Availability zone:          us-east-1a
  Subnet:                     <subnet-id>
  Disk Size:                  300 GiB
  Version:                    4.19.10
  EC2 Metadata Http Tokens:   optional
  Autorepair:                 Yes
  Tuning configs:
  Kubelet configs:
  Additional security group IDs:
  Node drain grace period:
  Capacity Reservation:
      - ID:                   <capacity-reservation-id>
      - Type:                 OnDemand
  Management upgrade:
      - Type:                 Replace
      - Max surge:            1
      - Max unavailable:      0
  Message:                    Minimum availability requires 1 replicas, current 1 available

  Copy to Clipboard Toggle word wrap

  출력에는 용량 예약 ID 및 유형이 포함되어야 합니다.

클러스터 생성을 위한 사전 요구 사항

• 클러스터 설치 중에 기본 머신 풀의 루트 디스크 크기 조정을 선택하는 옵션이 있습니다.

클러스터 생성 절차

• 원하는 루트 디스크 크기에 맞게 OpenShift 클러스터를 생성할 때 다음 명령을 실행합니다.

  $ rosa create cluster --worker-disk-size=<disk_size>

  Copy to Clipboard Toggle word wrap

  값은 GB, GiB, TB 또는 TiB일 수 있습니다. < disk_size >를 숫자 값 및 단위(예: --worker-disk-size=200GiB )로 바꿉니다. 숫자와 단위를 분리할 수 없습니다. 공백은 허용되지 않습니다.

머신 풀 생성을 위한 사전 요구 사항

• 클러스터를 설치한 후 새 시스템 풀의 루트 디스크 크기 조정을 선택하는 옵션이 있습니다.

사전 요구 사항

• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 클러스터가 ready 상태입니다.
• 테인트 없이 기존 머신 풀이 있고 단일 AZ 클러스터용 인스턴스가 두 개 이상 있거나 다중 AZ 클러스터의 경우 세 개의 인스턴스가 있습니다.

사전 요구 사항

• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 클러스터가 ready 상태입니다.
• 테인트 없이 기존 머신 풀이 있고 Single-AZ 클러스터용 인스턴스가 두 개 이상 있거나 Multi-AZ 클러스터의 경우 세 개의 인스턴스가 있습니다.

사전 요구 사항

• 워크스테이션에 최신 ROSA CLI(명령줄 인터페이스)(rosa)를 설치하고 구성했습니다.
• ROSA CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 기존 머신 풀이 있습니다.

사전 요구 사항

• 워크스테이션에 최신 AWS(aws), ROSA(rosa) 및 OpenShift(oc) CLI를 설치하고 구성했습니다.
• ROSA CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.

프로세스

• 다음 명령을 실행하여 사용자 지정 태그로 머신 풀을 생성합니다.

  $ rosa create machinepools --cluster=<name> --replicas=<replica_count> \
       --name <mp_name> --tags='<key> <value>,<key> <value>' 

  1

  Copy to Clipboard Toggle word wrap

  1

  < key> <value>,<key> <value >를 각 태그의 키와 값으로 바꿉니다.

  출력 예

  $ rosa create machinepools --cluster=mycluster --replicas 2 --tags='tagkey1 tagvalue1,tagkey2 tagvaluev2'
  
  I: Checking available instance types for machine pool 'mp-1'
  I: Machine pool 'mp-1' created successfully on cluster 'mycluster'
  I: To view the machine pool details, run 'rosa describe machinepool --cluster mycluster --machinepool mp-1'
  I: To view all machine pools, run 'rosa list machinepools --cluster mycluster'

  Copy to Clipboard Toggle word wrap

검증

• describe 명령을 사용하여 태그가 있는 머신 풀의 세부 정보를 확인하고 출력에 시스템 풀에 태그가 포함되어 있는지 확인합니다.

  $ rosa describe machinepool --cluster=<cluster_name> --machinepool=<machinepool_name>

  Copy to Clipboard Toggle word wrap

  출력 예

  ID:                            db-nodes-mp
  Cluster ID:                    <ID_of_cluster>
  Autoscaling:                   No
  Desired replicas:              2
  Current replicas:              2
  Instance type:                 m5.xlarge
  Labels:
  Tags:                          red-hat-clustertype=rosa, red-hat-managed=true, tagkey1=tagvalue1, tagkey2=tagvaluev2
  Taints:
  Availability zone:             us-east-2a
  ...

  Copy to Clipboard Toggle word wrap

사전 요구 사항

• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 기존 머신 풀에는 테인트가 포함되지 않고 두 개 이상의 인스턴스가 포함됩니다.

사전 요구 사항

• 워크스테이션에 최신 AWS(aws), ROSA(rosa) 및 OpenShift(oc) CLI를 설치하고 구성했습니다.
• rosa CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 기존 머신 풀에는 테인트가 포함되지 않고 두 개 이상의 인스턴스가 포함됩니다.

사전 요구 사항

• HCP 클러스터를 사용하여 ROSA를 생성하셨습니다.
• 기존 머신 풀이 있습니다.

사전 요구 사항

• 워크스테이션에 최신 AWS(aws) 및 ROSA(rosa) CLI를 설치하고 구성하셨습니다.
• rosa CLI를 사용하여 Red Hat 계정에 로그인했습니다.
• AWS 클러스터에서 Red Hat OpenShift Service를 생성하셨습니다.
• 기존 머신 풀이 있습니다.