10.2. 제어 평면 머신 세트 시작하기


제어 평면 머신 세트를 시작하는 프로세스는 클러스터의 ControlPlaneMachineSet 사용자 정의 리소스(CR) 상태에 따라 달라집니다.

활성화된 CR이 생성된 클러스터
활성 상태의 생성된 CR이 있는 클러스터는 기본적으로 설정된 제어 평면 머신을 사용합니다. 관리자 작업은 필요하지 않습니다.
비활성 생성된 CR이 있는 클러스터
비활성화된 생성된 CR이 포함된 클러스터의 경우 CR 구성을 검토하고 CR을 활성화 해야 합니다.
생성된 CR이 없는 클러스터
생성된 CR이 포함되지 않은 클러스터의 경우 클러스터에 적합한 구성으로 CR을 만들고 활성화 해야 합니다.

클러스터의 ControlPlaneMachineSet CR 상태가 확실하지 않은 경우 CR 상태를 확인할 수 있습니다.

10.2.1. 지원되는 클라우드 제공업체

OpenShift Container Platform 4.19에서는 Amazon Web Services(AWS), Google Cloud Platform(GCP), Microsoft Azure, Nutanix 및 VMware vSphere 클러스터에 대한 제어 플레인 머신 세트가 지원됩니다.

설치 후 제어 평면 머신 세트의 상태는 클라우드 공급자와 클러스터에 설치한 OpenShift Container Platform 버전에 따라 달라집니다.

Expand
표 10.1. OpenShift Container Platform 4.19에 대한 제어 평면 머신 세트 구현
클라우드 공급자기본적으로 활성화됨생성된 CR수동 CR 필요

AWS(Amazon Web Services)

X [1]

X

 

GCP(Google Cloud Platform)

X [2]

X

 

Microsoft Azure

X [2]

X

 

Nutanix

X [3]

X

 

Red Hat 오픈스택 플랫폼(RHOSP)

X [3]

X

 

VMware vSphere

X [4]

X

 
  1. 4.11 이하 버전에서 업그레이드된 AWS 클러스터에는 CR 활성화가 필요합니다.
  2. 버전 4.12 이하에서 업그레이드된 GCP 및 Azure 클러스터에는 CR 활성화가 필요합니다.
  3. 4.13 이하 버전에서 업그레이드된 Nutanix 및 RHOSP 클러스터에는 CR 활성화가 필요합니다.
  4. 버전 4.15 이하에서 업그레이드된 vSphere 클러스터에는 CR 활성화가 필요합니다.

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

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.2.3. 컨트롤 플레인 머신 세트 사용자 정의 리소스 활성화

제어 평면 머신 세트를 사용하려면 클러스터에 대한 올바른 설정을 갖춘 ControlPlaneMachineSet 사용자 지정 리소스(CR)가 있는지 확인해야 합니다. 생성된 CR이 있는 클러스터에서 CR의 구성이 클러스터에 맞는지 확인하고 활성화해야 합니다.

참고

CR의 매개변수에 대한 자세한 내용은 "제어 평면 머신 세트 구성"을 참조하세요.

프로세스

  1. 다음 명령을 실행하여 CR의 구성을 확인하세요.

    $ oc --namespace openshift-machine-api edit controlplanemachineset.machine.openshift.io cluster
    Copy to Clipboard Toggle word wrap
  2. 클러스터 구성에 맞지 않는 필드 값을 변경하세요.
  3. 구성이 올바르면 .spec.state 필드를 활성 으로 설정하고 변경 사항을 저장하여 CR을 활성화합니다.

    중요

    CR을 활성화하려면 CR 구성을 업데이트하는 데 사용하는 동일한 oc 편집 세션에서 .spec.state 필드를 활성 으로 변경해야 합니다. CR이 Inactive 상태로 저장된 경우 컨트롤 플레인 머신 세트 생성기는 CR을 원래 설정으로 재설정합니다.

10.2.4. 컨트롤 플레인 머신 세트 사용자 정의 리소스 생성

제어 평면 머신 세트를 사용하려면 클러스터에 대한 올바른 설정을 갖춘 ControlPlaneMachineSet 사용자 지정 리소스(CR)가 있는지 확인해야 합니다. 생성된 CR이 없는 클러스터에서 CR을 수동으로 생성하고 활성화해야 합니다.

참고

CR의 구조와 매개변수에 대한 자세한 내용은 "제어 평면 머신 세트 구성"을 참조하세요.

프로세스

  1. 다음 템플릿을 사용하여 YAML 파일을 만듭니다.

    컨트롤 플레인 머신 세트 CR YAML 파일 템플릿

    apiVersion: machine.openshift.io/v1
    kind: ControlPlaneMachineSet
    metadata:
      name: cluster
      namespace: openshift-machine-api
    spec:
      replicas: 3
      selector:
        matchLabels:
          machine.openshift.io/cluster-api-cluster: <cluster_id> 
    1
    
          machine.openshift.io/cluster-api-machine-role: master
          machine.openshift.io/cluster-api-machine-type: master
      state: Active 
    2
    
      strategy:
        type: RollingUpdate 
    3
    
      template:
        machineType: machines_v1beta1_machine_openshift_io
        machines_v1beta1_machine_openshift_io:
          failureDomains:
            platform: <platform> 
    4
    
            <platform_failure_domains> 
    5
    
          metadata:
            labels:
              machine.openshift.io/cluster-api-cluster: <cluster_id> 
    6
    
              machine.openshift.io/cluster-api-machine-role: master
              machine.openshift.io/cluster-api-machine-type: master
          spec:
            providerSpec:
              value:
                <platform_provider_spec> 
    7
    Copy to Clipboard Toggle word wrap

    1
    클러스터를 프로비저닝할 때 설정한 클러스터 ID를 기반으로 하는 인프라 ID를 지정합니다. ControlPlaneMachineSet CR을 생성할 때 이 값을 지정해야 합니다. OpenShift CLI (oc) 패키지가 설치되어 있으면 다음 명령을 실행하여 인프라 ID를 얻을 수 있습니다.
    $ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
    Copy to Clipboard Toggle word wrap
    2
    운영자의 상태를 지정합니다. 상태가 Inactive 이면 Operator가 작동하지 않습니다. 값을 Active 로 설정하여 Operator를 활성화할 수 있습니다.
    중요

    CR을 활성화하기 전에 클러스터 요구 사항에 맞게 구성이 올바른지 확인해야 합니다.

    3
    클러스터에 대한 업데이트 전략을 지정합니다. 유효한 값은 OnDeleteRollingUpdate 입니다. 기본값은 RollingUpdate 입니다. 업데이트 전략에 대한 자세한 내용은 "제어 평면 구성 업데이트"를 참조하세요.
    4
    클라우드 공급자 플랫폼 이름을 지정하세요. 유효한 값은 AWS , Azure , GCP , Nutanix , VSphereOpenStack 입니다.
    5
    클러스터에 <platform_failure_domains> 구성을 추가합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급자의 샘플 장애 도메인 구성을 참조하세요.
    6
    인프라 ID를 지정합니다.
    7
    클러스터에 대한 <platform_provider_spec> 구성을 추가합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급업체의 샘플 공급업체 사양을 참조하세요.
  2. 제어 평면 머신 세트 CR에 대한 샘플 YAML을 참조하고 클러스터 구성에 적합한 값으로 파일을 채웁니다.
  3. 클라우드 공급자의 샘플 장애 도메인 구성 및 샘플 공급자 사양을 참조하고 파일의 해당 섹션을 적절한 값으로 업데이트하세요.
  4. 구성이 올바르면 .spec.state 필드를 활성 으로 설정하고 변경 사항을 저장하여 CR을 활성화합니다.
  5. 다음 명령을 실행하여 YAML 파일에서 CR을 만듭니다.

    $ oc create -f <control_plane_machine_set>.yaml
    Copy to Clipboard Toggle word wrap

    여기서 <control_plane_machine_set> 은 CR 구성이 포함된 YAML 파일의 이름입니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat