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

12.2. 컨트롤 플레인 머신 세트 시작하기

컨트롤 플레인 머신 세트를 시작하는 프로세스는 클러스터의 ControlPlaneMachineSet CR(사용자 정의 리소스)의 상태에 따라 다릅니다.

활성 생성된 CR이 있는 클러스터
활성 상태의 CR이 생성된 클러스터는 기본적으로 컨트롤 플레인 머신 세트를 사용합니다. 관리자 작업이 필요하지 않습니다.
비활성 생성된 CR이 있는 클러스터
비활성 생성된 CR이 포함된 클러스터의 경우 CR 구성을 검토하고 CR을 활성화해야 합니다.
생성된 CR이 없는 클러스터
생성된 CR을 포함하지 않는 클러스터의 경우 클러스터에 적절한 구성으로 CR을 생성하고 활성화해야 합니다.

클러스터에서 ControlPlaneMachineSet CR의 상태에 대해 확신이 있는 경우 CR 상태를 확인할 수 있습니다.

12.2.1. 지원되는 클라우드 공급자

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

설치 후 컨트롤 플레인 머신 세트의 상태는 클라우드 공급자 및 클러스터에 설치한 OpenShift Container Platform 버전에 따라 다릅니다.

표 12.1. OpenShift Container Platform 4.17용 컨트롤 플레인 머신 세트 구현
클라우드 공급자기본적으로 활성 상태생성된 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 OpenStack Platform (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 활성화 가 필요합니다.

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

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

프로세스

  • 다음 명령을 실행하여 CR의 상태를 확인합니다. 

    $ oc get controlplanemachineset.machine.openshift.io cluster \
  --namespace openshift-machine-api
    • Active 의 결과는 ControlPlaneMachineSet CR이 존재하고 활성화되어 있음을 나타냅니다. 관리자 작업이 필요하지 않습니다.
    • Inactive 의 결과는 ControlPlaneMachineSet CR이 존재하지만 활성화되지 않았음을 나타냅니다.
    • NotFound 의 결과는 기존 ControlPlaneMachineSet CR이 없음을 나타냅니다.

다음 단계

컨트롤 플레인 머신 세트를 사용하려면 클러스터에 대한 올바른 설정이 있는 ControlPlaneMachineSet CR이 있는지 확인해야 합니다.

  • 클러스터에 기존 CR이 있는 경우 CR의 구성이 클러스터에 적합한지 확인해야 합니다.
  • 클러스터에 기존 CR이 없는 경우 클러스터에 대한 올바른 구성으로 클러스터를 생성해야 합니다.

12.2.3. 컨트롤 플레인 머신 세트 사용자 정의 리소스 활성화

컨트롤 플레인 머신 세트를 사용하려면 클러스터에 대한 올바른 설정이 있는 ControlPlaneMachineSet CR(사용자 정의 리소스)이 있는지 확인해야 합니다. 생성된 CR이 있는 클러스터에서 CR의 구성이 클러스터에 적합한지 확인하고 활성화해야 합니다.

참고

CR의 매개변수에 대한 자세한 내용은 "Control Plane 머신 세트 구성"을 참조하십시오.

프로세스

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

    $ oc --namespace openshift-machine-api edit controlplanemachineset.machine.openshift.io cluster
  2. 클러스터 구성에 잘못된 필드의 값을 변경합니다.

  3. 구성이 올바르면 .spec.state 필드를 Active 로 설정하고 변경 사항을 저장하여 CR을 활성화합니다.

    중요

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

추가 리소스

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

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

참고

CR의 구조 및 매개변수에 대한 자세한 내용은 "Control Plane 머신 세트 구성"을 참조하십시오.

프로세스

  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

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

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

    3
    클러스터의 업데이트 전략을 지정합니다. 유효한 값은 OnDelete 및 RollingUpdate 입니다. 기본값은 RollingUpdate 입니다. 업데이트 전략에 대한 자세한 내용은 "컨트롤 플레인 구성 업그레이드"를 참조하십시오.
    4
    클라우드 공급자 플랫폼 이름을 지정합니다. 유효한 값은 AWS,Azure,GCP,Nutanix,VSphere, OpenStack 입니다.
    5
    클러스터에 대한 & lt;platform_failure_domains& gt; 구성을 추가합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급자에 대한 샘플 실패 도메인 구성을 참조하십시오.
    6
    인프라 ID를 지정합니다.
    7
    클러스터에 대한 <platform_provider_spec> 구성을 추가합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급자의 샘플 공급자 사양을 참조하십시오.
  2. 컨트롤 플레인 머신 세트 CR의 샘플 YAML을 참조하여 클러스터 구성에 적합한 값으로 파일을 채웁니다.
  3. 클라우드 공급자의 샘플 실패 도메인 구성 및 샘플 공급자 사양을 참조하여 파일의 해당 섹션을 적절한 값으로 업데이트합니다.
  4. 구성이 올바르면 .spec.state 필드를 Active 로 설정하고 변경 사항을 저장하여 CR을 활성화합니다.

  5. 다음 명령을 실행하여 YAML 파일에서 CR을 생성합니다. 

    $ oc create -f <control_plane_machine_set>.yaml

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

추가 리소스

Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

© 2024 Red Hat, Inc.