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
클러스터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
운영자의 상태를 지정합니다. 상태가 Inactive 이면 Operator가 작동하지 않습니다. 값을 Active 로 설정하여 Operator를 활성화할 수 있습니다.
중요

Operator를 활성화하기 전에 ControlPlaneMachineSet CR 구성이 클러스터 요구 사항에 맞는지 확인해야 합니다. 제어 평면 머신 세트 운영자 활성화에 대한 자세한 내용은 "제어 평면 머신 세트 시작하기"를 참조하세요.

5
클러스터에 대한 업데이트 전략을 지정합니다. 허용되는 값은 OnDeleteRollingUpdate 입니다. 기본값은 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