클래식 클러스터에 워커 노드 추가하기

Classic infrastructure

클래식 클러스터에 워커 노드를 추가하는 방법에 대한 정보는 다음 섹션을 참조하십시오.

VPC 클러스터에 작업자를 추가하려고 합니까? VPC 클러스터에 작업자 노드 추가 를 참조하십시오.

앱의 가용성을 높이기 위해 클러스터의 한 기존 구역 또는 다수의 기존 구역에 작업자 노드를 추가할 수 있습니다. 구역 장애로부터 앱을 보호하는 데 도움이 되도록 클러스터에 구역을 추가할 수 있습니다.

클러스터를 작성하면 작업자 노드가 작업자 풀에서 프로비저닝됩니다. 클러스터 작성 후에는 해당 크기를 조정하거나 작업자 풀을 더 추가하여 풀에 작업자 노드를 더 추가할 수 있습니다. 기본적으로 작업자 풀은 하나의 구역에 존재합니다. 하나의 구역에만 작업자 풀이 있는 클러스터를 단일 구역 클러스터(single zone cluster)라고 합니다. 클러스터에 구역을 더 추가하면 작업자 풀이 구역 간에 존재합니다. 둘 이상의 구역 간에 전개된 작업자 풀이 있는 클러스터를 다중 구역 클러스터(multizone cluster)라고 합니다.

다중 구역 클러스터가 있으면 해당 작업자 노드 리소스의 밸런스를 유지하십시오. 모든 작업자 풀이 동일한 구역 간에 전개되어 있는지 확인하고 개별 노드를 추가하는 대신 풀의 크기를 조정하여 작업자를 추가하거나 제거하십시오. 작업자 풀을 설정한 후, 워크로드 리소스 요청을 기반으로 작업자 풀에 작업자 노드를 자동으로 추가하거나 제거하려면 클러스터 오토스케일러를 설정할 수 있습니다.

클래식 워커 노드에 대한 예약 기능은 더 이상 권장되지 않습니다. 2026년 10월 15일 이후에는 새로운 예약 계약을 체결할 수 없습니다. 만료 예정인 기존 예약 계약이 있는 경우, 계약 만료일 전에 예약을 사용하지 않는 새로운 작업자 풀을 생성하고 워크로드를 마이그레이션해야 합니다.

새 작업자 풀 작성

새 작업자 풀을 작성하여 클래식 클러스터에 작업자 노드를 추가할 수 있습니다. 이전에 예약 기능을 사용하여 워커 노드를 프로비저닝한 적이 있다면, 예약 기능이 더 이상 지원되지 않는다는 점에 유의하시기 바랍니다. 대신 표준 워커 풀을 생성하십시오.

시작하기 전에 운영자 또는 관리자 IAM 플랫폼 액세스 역할 파일이 있는지 확인하십시오.

  1. 클러스터의 작업자 구역을 검색하고 작업자 풀에 작업자 노드를 배치할 구역을 선택하십시오. 단일 구역 클러스터를 보유하는 경우에는 작업자 구역 필드에 나타난 구역을 사용해야 합니다. 다중 구역 클러스터의 경우 클러스터의 기존 작업자 구역을 선택하거나 클러스터가 있는 지역의 다중 구역 위치 중 하나를 추가할 수 있습니다. ibmcloud oc zone ls를 실행하여 사용 가능한 구역을 나열할 수 있습니다.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

    출력 예

    ...
Worker Zones: dal10, dal12, dal13

  2. 각 구역에 대해 사용 가능한 사설 및 공용 VLAN을 나열하십시오. 사용할 사설 및 공용 VLAN을 기록해 두십시오. 사설 또는 공용 VLAN이 없으면 구역을 작업자 풀에 추가할 때 사용자를 위해 VLAN이 자동으로 작성됩니다.

    ibmcloud oc vlan ls --zone ZONE

  3. 각 구역별로 워커 노드에 사용할 수 있는 구성을 검토하십시오.

    ibmcloud oc flavors --zone ZONE

  4. 작업자 풀을 작성하십시오. 자세한 옵션은 CLI 문서를 참조하십시오.

    • --label 레이블로 풀에 위치한 작업자 노드에 자동으로 레이블을 지정하도록 key=value 옵션을 포함하십시오.
    • 베어메탈 또는 전용 VM 작업자 풀을 프로비저닝하는 경우 --hardware dedicated를 지정하십시오.
    • 새 작업자 노드는 클러스터 마스터와 동일한 major.minor 버전을 실행하지만 해당 major.minor 버전의 최신 작업자 노드 패치를 적용합니다.
    ibmcloud oc worker-pool create classic --name POOL_NAME --cluster CLUSTER_NAME_OR_ID --flavor FLAVOR --size-per-zone NUMBER_OF_WORKERS_PER_ZONE [--operating-system (REDHAT_8_64)] [--label key=value]

  5. 작업자 풀이 작성되었는지 확인하십시오.

    ibmcloud oc worker-pool ls --cluster CLUSTER_NAME_OR_ID

  6. 기본적으로, 작업자 풀을 추가하면 구역이 없는 풀이 작성됩니다. 구역에 작업자 노드를 배치하려면 이전에 검색한 구역을 작업자 풀에 추가해야 합니다. 다중 구역 전체에 작업자 노드를 분산시키려는 경우에는 각 구역에 대해 이 명령을 반복하십시오.

    ibmcloud oc zone add classic --zone ZONE --cluster CLUSTER_NAME_OR_ID --worker-pool POOL_NAME --private-vlan PRIVATE_VLAN_ID --public-vlan PUBLIC_VLAN_ID

  7. 사용자가 추가한 구역에서 작업자 노드의 프로비저닝을 확인하십시오. 상태가 ‘ provision_pending ’에서 ‘ normal ’로 변경되면 워커 노드가 준비된 것입니다.

    ibmcloud oc worker ls --cluster CLUSTER_NAME_OR_ID --worker-pool POOL_NAME

    출력 예

    ID                                                 Public IP        Private IP      Machine Type      State    Status  Zone    Version
kube-dal10-crb20b637238ea471f8d4a8b881aae4962-w7   169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          provision_pending   Ready   dal10   1.36
kube-dal10-crb20b637238ea471f8d4a8b881aae4962-w8   169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          provision_pending   Ready   dal10   1.36

작업자 풀 크기 조정

작업자 풀이 하나의 구역에 있는지 또는 다중 구역 간에 전개되었는지 여부와 무관하게, 기존 작업자 풀의 크기를 조정하여 클러스터에 있는 작업자 노드의 수를 늘리거나 줄일 수 있습니다.

예를 들어, 구역별로 3개의 작업자 노드가 있는 하나의 작업자 풀이 있는 클러스터를 고려하십시오.

  • 클러스터가 단일 구역이고 dal10에 존재하는 경우, 작업자 풀에는 dal10에 3개의 작업자 노드가 있습니다. 클러스터에는 총 3개의 작업자 노드가 있습니다.
  • 클러스터가 다중 구역이고 dal10 및 dal12에 존재하는 경우, 작업자 풀에는 dal10에 3개의 작업자 노드가 있으며 dal12에 3개의 작업자 노드가 있습니다. 클러스터에는 총 6개의 작업자 노드가 있습니다.

베어메탈 작업자 풀의 경우에는 비용이 매월 청구됨을 유념하십시오. 크기를 늘리거나 줄이는 경우, 이는 해당 월의 비용에 영향을 줍니다. 작업자 풀의 크기를 조정하여 작업자 노드를 추가하는 경우 새 작업자 노드는 해당 major.minor 버전의 최신 작업자 노드 패치를 제외하고 클러스터 마스터와 동일한 major.minor 버전을 실행합니다.

시작하기 전에 운영자 또는 관리자 IAM 플랫폼 액세스 역할 파일이 있는지 확인하십시오.

작업자 풀의 크기를 조정하려면 각 구역에서 작업자 풀에 배치된 작업자 노드의 수를 변경하십시오.

  1. 크기 조정을 원하는 작업자 풀의 이름을 가져오십시오.
    ibmcloud oc worker-pool ls --cluster CLUSTER_NAME_OR_ID
  2. 각 구역에서 배치할 작업자 노드의 수를 지정하여 작업자 풀의 크기를 조정하십시오.
    ibmcloud oc worker-pool resize --cluster CLUSTER_NAME_OR_ID --worker-pool POOL_NAME --size-per-zone NUMBER_OF_WORKERS_PER_ZONE
  3. 작업자 풀의 크기가 조정되었는지 확인하십시오.
    ibmcloud oc worker ls --cluster CLUSTER_NAME_OR_ID --worker-pool POOL_NAME
    Example output for a worker pool that is in two zones, dal10 and dal12, and is resized to two worker nodes per zone:
    ID                                                 Public IP        Private IP      Machine Type      State    Status  Zone    Version
kube-dal10-crb20b637238ea471f8d4a8b881aae4962-w7   169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          normal   Ready   dal10   1.36
kube-dal10-crb20b637238ea471f8d4a8b881aae4962-w8   169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          normal   Ready   dal10   1.36
kube-dal12-crb20b637238ea471f8d4a8b881aae4962-w9   169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          normal   Ready   dal12   1.36
kube-dal12-crb20b637238ea471f8d4a8b881aae4962-w10  169.xx.xxx.xxx   10.xxx.xx.xxx   b3c.4x16          normal   Ready   dal12   1.36

작업자 풀에 구역 추가

기존 작업자 풀에 구역을 추가하여 한 지역 내의 다중 구역 간에 클래식 클러스터를 전개할 수 있습니다.

작업자 풀에 구역을 추가하면 작업자 풀에 정의된 작업자 노드가 새 구역에 프로비저닝되며 향후 워크로드 스케줄링을 위해 고려됩니다. Red Hat OpenShift on IBM Cloud는 지역에 대한 failure-domain.beta.kubernetes.io/region 레이블과 구역에 대한 failure-domain.beta.kubernetes.io/zone 레이블을 각 작업자 노드에 자동으로 추가합니다. Kubernetes 스케줄러는 이러한 레이블을 사용하여 동일한 지역 내의 구역 간에 팟(Pod)을 전개합니다.

클러스터에 다중 작업자 풀이 있는 경우에는 작업자 노드가 클러스터에 균등하게 분산되도록 모든 작업자 풀에 구역을 추가하십시오. 클러스터에 작업자 노드를 추가하는 경우, 새 작업자 노드는 major.minor 버전의 최신 작업자 노드 패치를 제외하고 클러스터 마스터와 동일한 major.minor 버전을 실행합니다.

시작하기 전에:

  • 작업자 풀에 구역을 추가하려면 작업자 풀이 다중 구역 가능 구역에 있어야 합니다. 작업자 풀이 다중 구역 가능 구역에 없으면 새 작업자 풀 작성을 고려하십시오.
  • Operator or Administrator IAM platform access role 가 있는지 확인하십시오.
  • 클래식 클러스터에서 클러스터용 다중 VLAN, 동일한 VLAN의 다중 서브넷 또는 다중 구역 클래식 클러스터가 있는 경우에는 작업자 노드가 사설 네트워크에서 서로 간에 통신할 수 있도록 IBM Cloud 인프라 계정에 대해 VRF(Virtual Router Function)를 사용으로 설정해야 합니다. VRF를 사용으로 설정하려면 VRF 사용을 참조하십시오. VRF가 이미 사용으로 설정되었는지 확인하려면 ibmcloud account show 명령을 사용하십시오. VRF를 사용할 수 없거나 사용하지 않으려면 VLAN Spanning을 사용으로 설정하십시오. 이 작업을 수행하려면 ‘ 네트워크 > 네트워크 VLAN 스패닝 관리 ’ 인프라 권한이 필요하며, 해당 권한을 활성화해 달라고 계정 소유자에게 요청할 수도 있습니다. VLAN 스패닝이 이미 활성화되어 있는지 확인하려면 ibmcloud oc vlan spanning get --region 명령 을 사용하십시오.

작업자 노드가 있는 구역을 작업자 풀에 추가하려면 다음을 수행하십시오.

  1. 사용 가능한 구역을 나열하고 작업자 풀에 추가할 구역을 선택하십시오. 선택하는 구역은 다중 구역 가능 구역이어야 합니다.

    ibmcloud oc zone ls

  2. 해당 구역의 사용 가능한 VLAN을 나열하십시오. 사설 또는 공용 VLAN이 없으면 구역을 작업자 풀에 추가할 때 사용자를 위해 VLAN이 자동으로 작성됩니다.

    ibmcloud oc vlan ls --zone ZONE

  3. 클러스터의 작업자 풀을 나열하고 해당 이름을 기록해 두십시오.

    ibmcloud oc worker-pool ls --cluster CLUSTER_NAME_OR_ID

  4. 작업자 풀에 구역을 추가하십시오. 다중 작업자 풀이 있는 경우에는 모든 구역에서 클러스터의 밸런스가 유지되도록 모든 작업자 풀에 구역을 추가하십시오.

    다중 작업자 풀에 구역을 추가하려면 우선 사설 및 공용 VLAN이 있어야 합니다. 해당 구역에 공용 및 사설 VLAN이 없는 경우에는 공용 및 사설 VLAN이 사용자를 위해 작성되도록 우선 하나의 작업자 풀에 구역을 추가하십시오. 그러면 사용자를 위해 작성된 사설 및 공용 VLAN을 지정하여 다른 작업자 풀에 구역을 추가할 수 있습니다.

    서로 다른 작업자 풀에 대해 서로 다른 VLAN을 사용하려면 각 VLAN 및 이의 대응되는 작업자 풀에 대해 이 명령을 반복하십시오. 지정된 VLAN에 임의의 새 작업자 노드가 추가되지만, 기존 작업자 노드에 대한 VLAN은 변경되지 않습니다.

    ibmcloud oc zone add classic --zone ZONE --cluster CLUSTER_NAME_OR_ID -p POOL_NAME [-p POOL2_NAME] --private-vlan PRIVATE_VLAN_ID --public-vlan PUBLIC_VLAN_ID

  5. 구역이 클러스터에 추가되었는지 확인하십시오. 출력의 Worker zones 필드에서 추가된 구역을 찾으십시오. 추가된 구역에서 새 작업자 노드가 프로비저닝되었으므로 Workers 필드에서 총 작업자 수가 증가되었음을 유의하십시오.

    ibmcloud oc cluster get --cluster CLUSTER_NAME_OR_ID

    출력 예

    NAME:                           mycluster
ID:                             df253b6025d64944ab99ed63bb4567b6
State:                          normal
Status:                         healthy cluster
Created:                        2018-09-28T15:43:15+0000
Location:                       dal10
Pod Subnet:                     172.30.0.0/16
Service Subnet:                 172.21.0.0/16
Master URL:                     https://c3.<region>.containers.cloud.ibm.com:30426
Public Service Endpoint URL:    https://c3.<region>.containers.cloud.ibm.com:30426
Private Service Endpoint URL:   https://c3-private.<region>.containers.cloud.ibm.com:31140
Master Location:                Dallas
Master Status:                  Ready (21 hours ago)
Ingress Subdomain:              mycluster-<hash>-0000.us-south.containers.appdomain.cloud
Ingress Secret:                 mycluster-<hash>-0000
Workers:                        6
Worker Zones:                   dal10, dal12
Version:                        1.36_1524
Owner:                          owner@email.com
Resource Group ID:              a8a12accd63b437bbd6d58fb6a462ca7
Resource Group Name:            Default