3.14. 매니페스트 구성 파일

1. OpenShift Container Platform 매니페스트를 만듭니다.

   $ ./openshift-baremetal-install --dir ~/clusterconfigs create manifests

   INFO Consuming Install Config from target directory
   WARNING Making control-plane schedulable by setting MastersSchedulable to true for Scheduler cluster settings
   WARNING Discarding the OpenShift Manifest that was provided in the target directory because its dependencies are dirty and it needs to be regenerated

프로세스

1. 다음 명령을 사용하여 설치 호스트에 Butane을 설치합니다.

   $ sudo dnf -y install butane

2. 컨트롤 플레인 노드에 대한 chrony.conf 파일의 콘텐츠를 포함하여 Butane 구성, 99-master-chrony-conf-override.bu를 만듭니다.

   참고

   Butane에 대한 자세한 내용은 “Butane 을 사용하여 머신 구성 생성”을 참조하십시오.

   Butane 구성의 예

   variant: openshift
   version: 4.16.0
   metadata:
     name: 99-master-chrony-conf-override
     labels:
       machineconfiguration.openshift.io/role: master
   storage:
     files:
       - path: /etc/chrony.conf
         mode: 0644
         overwrite: true
         contents:
           inline: |
             # Use public servers from the pool.ntp.org project.
             # Please consider joining the pool (https://www.pool.ntp.org/join.html).
   
             # The Machine Config Operator manages this file
             server openshift-master-0.<cluster-name>.<domain> iburst 

   1

   
             server openshift-master-1.<cluster-name>.<domain> iburst
             server openshift-master-2.<cluster-name>.<domain> iburst
   
             stratumweight 0
             driftfile /var/lib/chrony/drift
             rtcsync
             makestep 10 3
             bindcmdaddress 127.0.0.1
             bindcmdaddress ::1
             keyfile /etc/chrony.keys
             commandkey 1
             generatecommandkey
             noclientlog
             logchange 0.5
             logdir /var/log/chrony
   
             # Configure the control plane nodes to serve as local NTP servers
             # for all compute nodes, even if they are not in sync with an
             # upstream NTP server.
   
             # Allow NTP client access from the local network.
             allow all
             # Serve time even if not synchronized to a time source.
             local stratum 3 orphan

   1

   <cluster-name>을 클러스터 이름으로 바꾸고 <domain>을 정규화된 도메인 이름으로 교체해야 합니다.

3. Butane을 사용하여 컨트롤 플레인 노드에 전달할 구성이 포함된 MachineConfig 파일 99-master-chrony-conf-override.yaml을 생성합니다.

   $ butane 99-master-chrony-conf-override.bu -o 99-master-chrony-conf-override.yaml

4. 컨트롤 플레인 노드의 NTP 서버를 참조하는 컴퓨팅 노드의 chrony.conf 파일의 내용을 포함하여 Butane 구성 99-worker-chrony-conf-override.bu 를 만듭니다.

   Butane 구성의 예

   variant: openshift
   version: 4.16.0
   metadata:
     name: 99-worker-chrony-conf-override
     labels:
       machineconfiguration.openshift.io/role: worker
   storage:
     files:
       - path: /etc/chrony.conf
         mode: 0644
         overwrite: true
         contents:
           inline: |
             # The Machine Config Operator manages this file.
             server openshift-master-0.<cluster-name>.<domain> iburst 

   1

   
             server openshift-master-1.<cluster-name>.<domain> iburst
             server openshift-master-2.<cluster-name>.<domain> iburst
   
             stratumweight 0
             driftfile /var/lib/chrony/drift
             rtcsync
             makestep 10 3
             bindcmdaddress 127.0.0.1
             bindcmdaddress ::1
             keyfile /etc/chrony.keys
             commandkey 1
             generatecommandkey
             noclientlog
             logchange 0.5
             logdir /var/log/chrony

   1

   <cluster-name>을 클러스터 이름으로 바꾸고 <domain>을 정규화된 도메인 이름으로 교체해야 합니다.

5. Butane을 사용하여 작업자 노드로 전달할 구성이 포함된 MachineConfig 개체 파일 99-worker-chrony-conf-override.yaml을 생성합니다.

   $ butane 99-worker-chrony-conf-override.bu -o 99-worker-chrony-conf-override.yaml

프로세스

1. install-config.yaml 파일을 저장하는 디렉터리로 변경합니다.

   $ cd ~/clusterconfigs

2. manifests 하위 디렉터리로 전환합니다.

   $ cd manifests

3. cluster-network-avoid-workers-99-config.yaml이라는 파일을 생성합니다.

   $ touch cluster-network-avoid-workers-99-config.yaml

4. 편집기에서 cluster-network-avoid-workers-99-config.yaml 파일을 열고 Operator 구성을 설명하는 CR(사용자 정의 리소스)을 입력합니다.

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     name: 50-worker-fix-ipi-rwn
     labels:
       machineconfiguration.openshift.io/role: worker
   spec:
     config:
       ignition:
         version: 3.2.0
       storage:
         files:
           - path: /etc/kubernetes/manifests/keepalived.yaml
             mode: 0644
             contents:
               source: data:,

   이 매니페스트는 컨트롤 플레인 노드에 ingressVIP 가상 IP 주소를 배치합니다. 또한 이 매니페스트는 컨트롤 플레인 노드에 다음 프로세스를 배포합니다.

   • openshift-ingress-operator
   • keepalived
5. cluster-network-avoid-workers-99-config.yaml 파일을 저장합니다.

6. manifests/cluster-ingress-default-ingresscontroller.yaml 파일을 생성합니다.

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: default
     namespace: openshift-ingress-operator
   spec:
     nodePlacement:
       nodeSelector:
         matchLabels:
           node-role.kubernetes.io/master: ""

7. manifests 디렉터리를 백업하는 것이 좋습니다. 설치 프로그램은 클러스터를 생성할 때 manifests/ 디렉터리를 삭제합니다.

8. mastersSchedulable 필드를 true로 설정하여 컨트롤 플레인 노드를 예약할 수 있도록 cluster-scheduler-02-config.yml 매니페스트를 수정합니다. 기본적으로 컨트롤 플레인 노드는 예약할 수 없습니다. 예를 들면 다음과 같습니다.

   $ sed -i "s;mastersSchedulable: false;mastersSchedulable: true;g" clusterconfigs/manifests/cluster-scheduler-02-config.yml

   참고

   이 절차를 완료한 후 컨트롤 플레인 노드를 예약할 수 없는 경우 클러스터 배포가 실패합니다.

프로세스

1. router-replicas.yaml 파일을 생성합니다.

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: default
     namespace: openshift-ingress-operator
   spec:
     replicas: <num-of-router-pods>
     endpointPublishingStrategy:
       type: HostNetwork
     nodePlacement:
       nodeSelector:
         matchLabels:
           node-role.kubernetes.io/worker: ""

   참고

   <num-of-router-pods>를 적절한 값으로 바꿉니다. 하나의 컴퓨팅 노드로만 작업하는 경우 replicas: 1 로 설정합니다. 컴퓨팅 노드를 3개 이상 사용하여 작업하는 경우 필요에 따라 replicas: 를 기본값 2 에서 늘릴 수 있습니다.

2. router-replicas.yaml 파일을 clusterconfigs/openshift 디렉터리에 저장하고 복사합니다.

   $ cp ~/router-replicas.yaml clusterconfigs/openshift/99_router-replicas.yaml

프로세스

1. 매니페스트를 생성합니다.

2. 노드에 해당하는 BareMetalHost 리소스 파일을 수정합니다.

   $ vim clusterconfigs/openshift/99_openshift-cluster-api_hosts-*.yaml

3. BareMetalHost 리소스의 spec 섹션에 BIOS 구성을 추가합니다.

   spec:
     firmware:
       simultaneousMultithreadingEnabled: true
       sriovEnabled: true
       virtualizationEnabled: true

   참고

   Red Hat은 세 가지 BIOS 구성을 지원합니다. BMC 유형 irmc 가 있는 서버만 지원됩니다. 다른 유형의 서버는 현재 지원되지 않습니다.

4. 클러스터를 생성합니다.

프로세스

1. 매니페스트를 생성합니다.

2. 노드에 해당하는 BareMetalHost 리소스를 수정합니다.

   $ vim clusterconfigs/openshift/99_openshift-cluster-api_hosts-*.yaml

   참고

   다음 예제에서는 OpenShift Container Platform 4.16이 소프트웨어 RAID를 지원하지 않기 때문에 하드웨어 RAID 구성을 사용합니다.

   1. 특정 RAID 구성을 spec 섹션에 추가한 경우 노드에서 준비 단계에서 원래 RAID 구성을 삭제하고 RAID에서 지정된 구성을 수행합니다. 예를 들면 다음과 같습니다.

      spec:
        raid:
          hardwareRAIDVolumes:
          - level: "0" 

      1

      
            name: "sda"
            numberOfPhysicalDisks: 1
            rotational: true
            sizeGibibytes: 0

      1

      level 은 필수 필드이며 다른 필드는 선택적 필드입니다.

   2. spec 섹션에 빈 RAID 구성을 추가한 경우 빈 구성으로 인해 노드가 준비 단계에서 원래 RAID 구성을 삭제하지만 새 구성을 수행하지 않습니다. 예를 들면 다음과 같습니다.

      spec:
        raid:
          hardwareRAIDVolumes: []

   3. spec 섹션에 raid 필드를 추가하지 않으면 원래 RAID 구성이 삭제되지 않으며 새 구성은 수행되지 않습니다.
3. 클러스터를 생성합니다.

1. custom-partitions.yaml 파일을 생성하고 파티션 레이아웃이 포함된 MachineConfig 오브젝트를 포함합니다.

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: primary
     name: 10_primary_storage_config
   spec:
     config:
       ignition:
         version: 3.2.0
       storage:
         disks:
           - device: </dev/xxyN>
             partitions:
               - label: recovery
                 startMiB: 32768
                 sizeMiB: 16384
         filesystems:
           - device: /dev/disk/by-partlabel/recovery
             label: recovery
             format: xfs

2. custom-partitions.yaml 파일을 clusterconfigs/openshift 디렉터리에 저장하고 복사합니다.

   $ cp ~/<MachineConfig_manifest> ~/clusterconfigs/openshift