Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

10.7. 제어 평면 머신 세트 문제 해결

이 섹션의 정보를 활용해 발생할 수 있는 문제를 파악하고 복구하세요.

10.7.1. 컨트롤 플레인 머신 세트 사용자 정의 리소스 상태 확인
링크 복사

ControlPlaneMachineSet CR(사용자 정의 리소스)의 존재 및 상태를 확인할 수 있습니다.

프로세스

  • 다음 명령을 실행하여 CR 상태를 확인하세요. 

    $ oc get controlplanemachineset.machine.openshift.io cluster \
  --namespace openshift-machine-api
    Copy to Clipboard Toggle word wrap
    • Active 결과는 ControlPlaneMachineSet CR이 존재하고 활성화되었음을 나타냅니다. 관리자 작업은 필요하지 않습니다.
    • Inactive 결과는 ControlPlaneMachineSet CR이 존재하지만 활성화되지 않았음을 나타냅니다.
    • NotFound 결과는 ControlPlaneMachineSet CR이 존재하지 않음을 나타냅니다.

다음 단계

제어 평면 머신 세트를 사용하려면 클러스터에 대한 올바른 설정을 갖춘 ControlPlaneMachineSet CR이 있는지 확인해야 합니다.

  • 클러스터에 기존 CR이 있는 경우 해당 CR의 구성이 클러스터에 맞는지 확인해야 합니다.
  • 클러스터에 기존 CR이 없는 경우 클러스터에 맞는 올바른 구성으로 CR을 만들어야 합니다.

10.7.2. 누락된 Azure 내부 부하 분산 장치 추가
링크 복사

Azure의 ControlPlaneMachineSet 및 컨트롤 플레인 Machine CR(사용자 정의 리소스) 모두에 internalLoadBalancer 매개변수가 필요합니다. 이 매개변수가 클러스터에 사전 구성되지 않은 경우 두 CR에 모두 추가해야 합니다.

Azure 공급자 사양에서 이 매개변수가 어디에 있는지에 대한 자세한 내용은 샘플 Azure 공급자 사양을 참조하세요. 컨트롤 플레인 Machine CR의 배치는 비슷합니다.

프로세스

  1. 다음 명령을 실행하여 클러스터의 제어 평면 머신을 나열하세요. 

    $ oc get machines \
  -l machine.openshift.io/cluster-api-machine-role==master \
  -n openshift-machine-api
    Copy to Clipboard Toggle word wrap

  2. 각 제어 평면 머신에 대해 다음 명령을 실행하여 CR을 편집합니다. 

    $ oc edit machine <control_plane_machine_name>
    Copy to Clipboard Toggle word wrap
  3. 클러스터에 대한 올바른 세부 정보와 함께 internalLoadBalancer 매개변수를 추가하고 변경 사항을 저장합니다.

  4. 다음 명령을 실행하여 제어 평면 머신 세트 CR을 편집합니다. 

    $ oc edit controlplanemachineset.machine.openshift.io cluster \
  -n openshift-machine-api
    Copy to Clipboard Toggle word wrap
  5. 클러스터에 대한 올바른 세부 정보와 함께 internalLoadBalancer 매개변수를 추가하고 변경 사항을 저장합니다.

다음 단계

  • 기본 RollingUpdate 업데이트 전략을 사용하는 클러스터의 경우 Operator는 변경 사항을 제어 평면 구성에 자동으로 전파합니다.
  • OnDelete 업데이트 전략을 사용하도록 구성된 클러스터의 경우 제어 평면 머신을 수동으로 교체해야 합니다.

10.7.3. 성능 저하된 etcd Operator 복구
링크 복사

특정 상황으로 인해 etcd 운영자가 저하될 수 있습니다.

예를 들어, 수정 작업을 수행하는 동안 머신 상태 검사에서 etcd를 호스팅하는 제어 평면 머신이 삭제될 수 있습니다. 그 시점에서 etcd 멤버에 연결할 수 없는 경우 etcd Operator의 성능이 저하됩니다.

etcd 운영자가 성능이 저하되면 운영자가 실패한 멤버를 제거하고 클러스터 상태를 복원하도록 강제하기 위해 수동 개입이 필요합니다.

프로세스

  1. 다음 명령을 실행하여 클러스터의 제어 평면 머신을 나열하세요. 

    $ oc get machines \
  -l machine.openshift.io/cluster-api-machine-role==master \
  -n openshift-machine-api \
  -o wide
    Copy to Clipboard Toggle word wrap

    다음 조건 중 하나라도 실패하면 제어 평면 머신이 실패했음을 나타낼 수 있습니다.

    • STATE 값이 중지되었습니다.
    • PHASE 값이 실패했습니다 .
    • PHASE 값은 10 분 이상 Deleting 됩니다.
    중요

    계속하기 전에 클러스터에 두 개의 정상적인 제어 평면 머신이 있는지 확인하세요. 이 절차의 작업을 두 대 이상의 제어 평면 머신에서 수행하면 etcd 쿼럼이 손실될 위험이 있으며 데이터가 손실될 수 있습니다.

    대부분의 제어 평면 호스트를 잃어 etcd 쿼럼 손실이 발생한 경우 이 절차 대신 재해 복구 절차인 "이전 클러스터 상태로 복원"을 따라야 합니다.

  2. 다음 명령을 실행하여 실패한 제어 평면 머신의 머신 CR을 편집합니다. 

    $ oc edit machine <control_plane_machine_name>
    Copy to Clipboard Toggle word wrap

  3. 실패한 제어 평면 머신에서 lifecycleHooks 매개변수의 내용을 제거하고 변경 사항을 저장합니다.

    etcd 운영자는 실패한 머신을 클러스터에서 제거한 다음 안전하게 새로운 etcd 멤버를 추가할 수 있습니다.

10.7.4. RHOSP에서 실행되는 클러스터 업그레이드
링크 복사

OpenShift Container Platform 4.13 이하 버전으로 생성되고 Red Hat OpenStack Platform(RHOSP)에서 실행되는 클러스터의 경우, 제어 평면 머신 세트를 사용하기 전에 업그레이드 후 작업을 수행해야 할 수도 있습니다.

Red Hat OpenStack Platform(RHOSP)에서 실행되는 일부 클러스터를 업그레이드하는 경우 다음 구성이 참이면 제어 평면 머신 세트를 사용하기 전에 머신 리소스를 수동으로 업데이트해야 합니다.

  • 업그레이드된 클러스터는 OpenShift Container Platform 4.13 이하 버전을 사용하여 생성되었습니다.
  • 클러스터 인프라는 설치 프로그램에서 제공됩니다.
  • 여러 가용성 영역에 걸쳐 기계가 분산되었습니다.
  • 블록 스토리지 가용성 영역이 정의되지 않은 루트 볼륨을 사용하도록 머신이 구성되었습니다.

이 절차가 필요한 이유를 알아보려면 솔루션 #7024383을 참조하세요.

프로세스

  1. 모든 제어 평면 머신의 경우 환경과 일치하는 모든 제어 평면 머신에 대한 공급자 사양을 편집합니다. 예를 들어, 머신 master-0을 편집하려면 다음 명령을 입력하세요. 

    $ oc edit machine/<cluster_id>-master-0 -n openshift-machine-api
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <cluster_id>
    업그레이드된 클러스터의 ID를 지정합니다.

  2. 공급자 사양에서 rootVolume.availabilityZone 속성의 값을 사용하려는 가용성 영역의 볼륨으로 설정합니다.

    RHOSP 공급자 사양 예시

    providerSpec:
  value:
    apiVersion: machine.openshift.io/v1alpha1
    availabilityZone: az0
      cloudName: openstack
    cloudsSecret:
      name: openstack-cloud-credentials
      namespace: openshift-machine-api
    flavor: m1.xlarge
    image: rhcos-4.14
    kind: OpenstackProviderSpec
    metadata:
      creationTimestamp: null
    networks:
    - filter: {}
      subnets:
      - filter:
          name: refarch-lv7q9-nodes
          tags: openshiftClusterID=refarch-lv7q9
    rootVolume:
        availabilityZone: nova
    1 
    
        diskSize: 30
        sourceUUID: rhcos-4.12
        volumeType: fast-0
    securityGroups:
    - filter: {}
      name: refarch-lv7q9-master
    serverGroupName: refarch-lv7q9-master
    serverMetadata:
      Name: refarch-lv7q9-master
      openshiftClusterID: refarch-lv7q9
    tags:
    - openshiftClusterID=refarch-lv7q9
    trunk: true
    userDataSecret:
      name: master-user-data
    Copy to Clipboard Toggle word wrap

    1
    이 값으로 영역 이름을 설정합니다.
    참고

    초기 클러스터 배포 이후에 머신 리소스를 편집하거나 다시 만든 경우 구성에 맞게 이러한 단계를 조정해야 할 수도 있습니다.

    RHOSP 클러스터에서 머신의 루트 볼륨 가용성 영역을 찾아 해당 값을 값으로 사용합니다.

  3. 다음 명령을 실행하여 제어 평면 머신 세트 리소스에 대한 정보를 검색합니다. 

    $ oc describe controlplanemachineset.machine.openshift.io/cluster --namespace openshift-machine-api
    Copy to Clipboard Toggle word wrap

  4. 다음 명령을 실행하여 리소스를 편집합니다. 

    $ oc edit controlplanemachineset.machine.openshift.io/cluster --namespace openshift-machine-api
    Copy to Clipboard Toggle word wrap
  5. 해당 리소스의 경우 spec.state 속성 값을 Active로 설정하여 클러스터의 제어 평면 머신 세트를 활성화합니다.

클러스터 제어 평면 머신 세트 운영자가 귀하의 제어 평면을 관리할 준비가 되었습니다.

Red Hat OpenStack Platform(RHOSP)에서 실행되는 일부 클러스터를 업그레이드하는 경우 다음 구성이 참이면 제어 평면 머신 세트를 사용하기 전에 머신 리소스를 수동으로 업데이트해야 합니다.

  • 업그레이드된 클러스터는 OpenShift Container Platform 4.13 이하 버전을 사용하여 생성되었습니다.
  • 클러스터 인프라는 설치 프로그램에서 제공됩니다.
  • 제어 평면 머신은 여러 컴퓨팅 가용성 영역에 분산되었습니다.

이 절차가 필요한 이유를 알아보려면 솔루션 #7013893을 참조하세요.

프로세스

  1. 마스터-1 및 마스터-2 제어 평면 머신의 경우 편집을 위해 공급자 사양을 엽니다. 예를 들어, 첫 번째 컴퓨터를 편집하려면 다음 명령을 입력하세요. 

    $ oc edit machine/<cluster_id>-master-1 -n openshift-machine-api
    Copy to Clipboard Toggle word wrap

    다음과 같습니다.

    <cluster_id>
    업그레이드된 클러스터의 ID를 지정합니다.

  2. 마스터-1 및 마스터-2 제어 평면 머신의 경우, 공급자 사양에서 serverGroupName 속성 값을 편집하여 머신 마스터-0 의 값과 일치시킵니다.

    RHOSP 공급자 사양 예시

    providerSpec:
  value:
    apiVersion: machine.openshift.io/v1alpha1
    availabilityZone: az0
      cloudName: openstack
    cloudsSecret:
      name: openstack-cloud-credentials
      namespace: openshift-machine-api
    flavor: m1.xlarge
    image: rhcos-4.19
    kind: OpenstackProviderSpec
    metadata:
      creationTimestamp: null
    networks:
    - filter: {}
      subnets:
      - filter:
          name: refarch-lv7q9-nodes
          tags: openshiftClusterID=refarch-lv7q9
    securityGroups:
    - filter: {}
      name: refarch-lv7q9-master
    serverGroupName: refarch-lv7q9-master-az0
    1 
    
    serverMetadata:
      Name: refarch-lv7q9-master
      openshiftClusterID: refarch-lv7q9
    tags:
    - openshiftClusterID=refarch-lv7q9
    trunk: true
    userDataSecret:
      name: master-user-data
    Copy to Clipboard Toggle word wrap

    1
    이 값은 master-0 , master-1 , master-3 머신과 일치해야 합니다.
    참고

    초기 클러스터 배포 이후에 머신 리소스를 편집하거나 다시 만든 경우 구성에 맞게 이러한 단계를 조정해야 할 수도 있습니다.

    RHOSP 클러스터에서 제어 평면 인스턴스가 있는 서버 그룹을 찾아 해당 값을 값으로 사용합니다.

  3. 다음 명령을 실행하여 제어 평면 머신 세트 리소스에 대한 정보를 검색합니다. 

    $ oc describe controlplanemachineset.machine.openshift.io/cluster --namespace openshift-machine-api
    Copy to Clipboard Toggle word wrap

  4. 다음 명령을 실행하여 리소스를 편집합니다. 

    $ oc edit controlplanemachineset.machine.openshift.io/cluster --namespace openshift-machine-api
    Copy to Clipboard Toggle word wrap
  5. 해당 리소스의 경우 spec.state 속성 값을 Active로 설정하여 클러스터의 제어 평면 머신 세트를 활성화합니다.

클러스터 제어 평면 머신 세트 운영자가 귀하의 제어 평면을 관리할 준비가 되었습니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat