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

10.4. 컨트롤 플레인 머신 세트 구성

이 예제 YAML 스니펫에서는 컨트롤 플레인 머신 세트 CR(사용자 정의 리소스)의 기본 구조를 보여줍니다.

10.4.1. 컨트롤 플레인 머신 세트 사용자 정의 리소스의 샘플 YAML
링크 복사

ControlPlaneMachineSet CR의 기반은 모든 플랫폼에 대해 동일한 방식으로 구성됩니다.

ControlPlaneMachineSet CR YAML 파일 샘플

apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
1 

  namespace: openshift-machine-api
spec:
  replicas: 3
2 

  selector:
    matchLabels:
      machine.openshift.io/cluster-api-cluster: <cluster_id>
3 

      machine.openshift.io/cluster-api-machine-role: master
      machine.openshift.io/cluster-api-machine-type: master
  state: Active
4 

  strategy:
    type: RollingUpdate
5 

  template:
    machineType: machines_v1beta1_machine_openshift_io
    machines_v1beta1_machine_openshift_io:
      failureDomains:
        platform: <platform>
6 

        <platform_failure_domains>
7 

      metadata:
        labels:
          machine.openshift.io/cluster-api-cluster: <cluster_id>
          machine.openshift.io/cluster-api-machine-role: master
          machine.openshift.io/cluster-api-machine-type: master
      spec:
        providerSpec:
          value:
            <platform_provider_spec>
8
Copy to Clipboard Toggle word wrap

1
cluster 인 ControlPlaneMachineSet CR의 이름을 지정합니다. 이 값은 변경하지 마십시오.
2
컨트롤 플레인 시스템의 수를 지정합니다. 컨트롤 플레인 시스템이 3개인 클러스터만 지원되므로 replicas 값은 3 입니다. 수평 스케일링은 지원되지 않습니다. 이 값은 변경하지 마십시오.
3
클러스터를 프로비저닝할 때 설정한 클러스터 ID를 기반으로 하는 인프라 ID를 지정합니다. ControlPlaneMachineSet CR을 생성할 때 이 값을 지정해야 합니다. OpenShift CLI (oc) 패키지가 설치되어 있으면 다음 명령을 실행하여 인프라 ID를 얻을 수 있습니다. 
$ oc get -o jsonpath='{.status.infrastructureName}{"\n"}' infrastructure cluster
Copy to Clipboard Toggle word wrap
4
Operator 상태를 지정합니다. 상태가 Inactive 이면 Operator가 작동하지 않습니다. 값을 Active 로 설정하여 Operator를 활성화할 수 있습니다.
중요

Operator를 활성화하기 전에 클러스터 요구 사항에 대해 ControlPlaneMachineSet CR 구성이 올바른지 확인해야 합니다. 컨트롤 플레인 머신 세트 Operator 활성화에 대한 자세한 내용은 "컨트롤 플레인 머신 세트 시작하기"를 참조하십시오.

5
클러스터의 업데이트 전략을 지정합니다. 허용되는 값은 OnDelete 및 RollingUpdate 입니다. 기본값은 RollingUpdate 입니다. 업데이트 전략에 대한 자세한 내용은 "컨트롤 플레인 구성 업그레이드"를 참조하십시오.
6
클라우드 공급자 플랫폼 이름을 지정합니다. 이 값은 변경하지 마십시오.
7
클러스터의 <platform_failure_domains> 구성을 지정합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급자에 대한 샘플 실패 도메인 구성을 참조하십시오.
8
클러스터의 <platform_provider_spec> 구성을 지정합니다. 이 섹션의 형식과 값은 공급자에 따라 다릅니다. 자세한 내용은 클라우드 공급자의 샘플 공급자 사양을 참조하십시오.

10.4.2. 컨트롤 플레인 머신 세트 구성 옵션
링크 복사

필요에 따라 클러스터를 사용자 지정하도록 컨트롤 플레인 머신 세트를 구성할 수 있습니다.

10.4.2.1. 컨트롤 플레인 머신 이름에 사용자 정의 접두사 추가
링크 복사

컨트롤 플레인 머신 세트에서 생성하는 머신 이름의 접두사를 사용자 지정할 수 있습니다. 이 작업은 ControlPlaneMachineSet 사용자 정의 리소스(CR)를 편집하여 수행할 수 있습니다.

프로세스

  1. 다음 명령을 실행하여 ControlPlaneMachineSet CR을 편집합니다. 

    $ oc edit controlplanemachineset.machine.openshift.io cluster \
  -n openshift-machine-api
    Copy to Clipboard Toggle word wrap

  2. ControlPlaneMachineSet CR의 .spec.machineNamePrefix 필드를 편집합니다. 

    apiVersion: machine.openshift.io/v1
kind: ControlPlaneMachineSet
metadata:
  name: cluster
  namespace: openshift-machine-api
spec:
  machineNamePrefix: <machine_prefix>
# ...
    Copy to Clipboard Toggle word wrap

    여기서 <machine_prefix >는 소문자 RFC 1123 하위 도메인에 대한 요구 사항을 따르는 접두사 이름을 지정합니다.

    중요

    소문자 RFC 1123 하위 도메인은 소문자 영숫자, 하이픈('-') 및 마침표(.')로만 구성되어야 합니다. 마침표로 구분된 각 블록은 영숫자 문자로 시작하고 끝나야 합니다. 하이픈은 블록 시작 또는 종료 시 허용되지 않으며 연속 기간은 허용되지 않습니다.

  3. 변경 사항을 저장하십시오.

다음 단계

  • machineNamePrefix 매개변수 값만 변경한 경우 기본 RollingUpdate 업데이트 전략을 사용하는 클러스터는 자동으로 업데이트되지 않습니다. 이 변경 사항을 전파하려면 클러스터의 업데이트 전략에 관계없이 컨트롤 플레인 시스템을 수동으로 교체해야 합니다. 자세한 내용은 "컨트롤 플레인 시스템 교체"를 참조하십시오.

10.4.3. 공급자별 구성 옵션
링크 복사

컨트롤 플레인 머신 세트 매니페스트의 <platform_provider_spec> 및 <platform_failure_domains> 섹션은 공급자마다 다릅니다. 클러스터의 공급자별 구성 옵션은 다음 리소스를 참조하십시오.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat