3.13. install-config.yaml 파일 구성

1. install-config.yaml을 설정합니다. pullSecret 및 sshKey 를 포함하여 환경과 일치하도록 적절한 변수를 변경합니다.

   apiVersion: v1
   baseDomain: <domain>
   metadata:
     name: <cluster_name>
   networking:
     machineNetwork:
     - cidr: <public_cidr>
     networkType: OVNKubernetes
   compute:
   - name: worker
     replicas: 2 

   1

   
   controlPlane:
     name: master
     replicas: 3
     platform:
       baremetal: {}
   platform:
     baremetal:
       apiVIPs:
         - <api_ip>
       ingressVIPs:
         - <wildcard_ip>
       provisioningNetworkCIDR: <CIDR>
       bootstrapExternalStaticIP: <bootstrap_static_ip_address> 

   2

   
       bootstrapExternalStaticGateway: <bootstrap_static_gateway> 

   3

   
       bootstrapExternalStaticDNS: <bootstrap_static_dns> 

   4

   
       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: ipmi://<out_of_band_ip> 

   5

   
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>" 

   6

   
         - name: <openshift_master_1>
           role: master
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
         - name: <openshift_master_2>
           role: master
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
         - name: <openshift_worker_0>
           role: worker
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
         - name: <openshift_worker_1>
           role: worker
           bmc:
             address: ipmi://<out_of_band_ip>
             username: <user>
             password: <password>
           bootMACAddress: <NIC1_mac_address>
           rootDeviceHints:
            deviceName: "<installation_disk_drive_path>"
   pullSecret: '<pull_secret>'
   sshKey: '<ssh_pub_key>'

   1

   OpenShift Container Platform 클러스터의 일부인 컴퓨팅 노드 수를 기반으로 컴퓨팅 머신을 확장합니다. replicas 값에 유효한 옵션은 0 및 2 보다 크거나 같은 정수입니다. 복제본 수를 0 으로 설정하여 3개의 컨트롤 플레인 시스템만 포함하는 3-노드 클러스터를 배포합니다. 3-노드 클러스터는 테스트, 개발 및 프로덕션에 사용할 수 있는 더 작고 리소스 효율이 높은 클러스터입니다. 컴퓨팅 노드가 하나뿐인 클러스터를 설치할 수 없습니다.

   2

   고정 IP 주소가 있는 클러스터를 배포할 때 베어 메탈 네트워크에 DHCP 서버가 없는 경우 부트스트랩 VM의 고정 IP 주소를 지정하도록 bootstrapExternalStaticIP 구성 설정을 설정해야 합니다.

   3

   고정 IP 주소가 있는 클러스터를 배포할 때 베어 메탈 네트워크에 DHCP 서버가 없는 경우 부트스트랩ExternalStaticGateway 구성 설정을 설정하여 부트스트랩 VM의 게이트웨이 IP 주소를 지정해야 합니다.

   4

   고정 IP 주소가 있는 클러스터를 배포할 때 베어 메탈 네트워크에 DHCP 서버가 없는 경우 부트스트랩 VM의 DNS 주소를 지정하도록 bootstrapExternalStaticDNS 구성 설정을 설정해야 합니다.

   5

   자세한 옵션은 BMC 주소 지정 섹션을 참조하십시오.

   6

   설치 디스크 드라이브의 경로를 설정하려면 디스크의 커널 이름을 입력합니다. 예: /dev/sda.

   중요

   디스크 검색 순서가 보장되지 않으므로 디스크의 커널 이름은 여러 디스크가 있는 시스템의 부팅 옵션 간에 변경될 수 있습니다. 예를 들어 /dev/sda 는 /dev/sdb 가 되고 그 반대의 경우도 마찬가지입니다. 이 문제를 방지하려면 WWN(World Wide Name) 또는 /dev/disk/by-path/ 디스크와 같은 영구 디스크 속성을 사용해야 합니다. 스토리지 위치에 /dev/disk/by-path/<device_path > 링크를 사용하는 것이 좋습니다. 디스크 WWN을 사용하려면 deviceName 매개변수를 wwnWithExtension 매개변수로 바꿉니다. 사용하는 매개변수에 따라 다음 값 중 하나를 입력합니다.

   • 디스크 이름입니다. 예를 들어 /dev/sda 또는 /dev/disk/by-path/.
   • 디스크 WWN. 예를 들어 "0x64cd98fde100024684cf3034da5c2" 입니다. 16진수 값이 아닌 문자열 값으로 사용되도록 디스크 WWN 값을 따옴표 내에 입력해야 합니다.

   rootDeviceHints 매개변수에 대한 이러한 요구 사항을 충족하지 않으면 다음과 같은 오류가 발생할 수 있습니다.

   ironic-inspector inspection failed: No disks satisfied root device hints

   참고

   OpenShift Container Platform 4.12 이전에는 클러스터 설치 프로그램에서 apiVIP 및 ingressVIP 구성 설정에 대해 IPv4 주소 또는 IPv6 주소만 허용했습니다. OpenShift Container Platform 4.12 이상에서는 이러한 구성 설정이 더 이상 사용되지 않습니다. 대신 apiVIPs 및 ingressVIPs 구성 설정에서 목록 형식을 사용하여 IPv4 주소, IPv6 주소 또는 두 IP 주소 형식을 모두 지정합니다.

2. 클러스터 구성을 저장할 디렉터리를 생성합니다.

   $ mkdir ~/clusterconfigs

3. install-config.yaml 파일을 새 디렉터리에 복사합니다.

   $ cp install-config.yaml ~/clusterconfigs

4. OpenShift Container Platform 클러스터를 설치하기 전에 모든 베어 메탈 노드의 전원이 꺼졌는지 확인합니다.

   $ ipmitool -I lanplus -U <user> -P <password> -H <management-server-ip> power off

5. 이전 배포에서 남은 경우 이전 부트스트랩 리소스를 제거합니다.

   for i in $(sudo virsh list | tail -n +3 | grep bootstrap | awk {'print $2'});
   do
     sudo virsh destroy $i;
     sudo virsh undefine $i;
     sudo virsh vol-delete $i --pool $i;
     sudo virsh vol-delete $i.ign --pool $i;
     sudo virsh pool-destroy $i;
     sudo virsh pool-undefine $i;
   done

프로세스

1. 다음 명령을 실행하여 BMC의 IP 주소 또는 호스트 이름을 설정합니다.

   $ export SERVER=<ip_address> 

   1

   1

   & lt;ip_address& gt;를 BMC의 IP 주소 또는 호스트 이름으로 바꿉니다.

2. 다음 명령을 실행하여 시스템의 ID를 설정합니다.

   $ export SystemID=<system_id> 

   1

   1

   &lt ;system_id&gt;를 시스템 ID로 바꿉니다. 예를 들어 System.Embedded.1 또는 1. 자세한 내용은 다음 벤더별 BMC 섹션을 참조하십시오.

Redfish API 목록

1. 다음 명령을 실행하여 지원 전원을 켭니다.

   $ curl -u $USER:$PASS -X POST -H'Content-Type: application/json' -H'Accept: application/json' -d '{"ResetType": "On"}' https://$SERVER/redfish/v1/Systems/$SystemID/Actions/ComputerSystem.Reset

2. 다음 명령을 실행하여 전원 지원을 확인합니다.

   $ curl -u $USER:$PASS -X POST -H'Content-Type: application/json' -H'Accept: application/json' -d '{"ResetType": "ForceOff"}' https://$SERVER/redfish/v1/Systems/$SystemID/Actions/ComputerSystem.Reset

3. 다음 명령을 실행하여 pxe 를 사용하는 임시 부팅 구현을 확인합니다.

   $ curl -u $USER:$PASS -X PATCH -H "Content-Type: application/json" -H "If-Match: <ETAG>"  https://$Server/redfish/v1/Systems/$SystemID/ -d '{"Boot": {"BootSourceOverrideTarget": "pxe", "BootSourceOverrideEnabled": "Once"}}

4. 다음 명령을 실행하여 레거시 또는 UEFI 를 사용하는 펌웨어 부팅 모드를 설정하는 상태를 확인합니다.

   $ curl -u $USER:$PASS -X PATCH -H "Content-Type: application/json" -H "If-Match: <ETAG>"  https://$Server/redfish/v1/Systems/$SystemID/ -d '{"Boot": {"BootSourceOverrideMode":"UEFI"}}

Redfish 가상 미디어 API 목록

1. 다음 명령을 실행하여 cd 또는 dvd 를 사용하는 임시 부팅 장치를 설정하는 기능을 확인합니다.

   $ curl -u $USER:$PASS -X PATCH -H "Content-Type: application/json" -H "If-Match: <ETAG>" https://$Server/redfish/v1/Systems/$SystemID/ -d '{"Boot": {"BootSourceOverrideTarget": "cd", "BootSourceOverrideEnabled": "Once"}}'

2. 가상 미디어는 하드웨어에 따라 POST 또는 PATCH 를 사용할 수 있습니다. 다음 명령 중 하나를 실행하여 가상 미디어를 마운트하는 기능을 확인합니다.

   $ curl -u $USER:$PASS -X POST -H "Content-Type: application/json" https://$Server/redfish/v1/Managers/$ManagerID/VirtualMedia/$VmediaId -d '{"Image": "https://example.com/test.iso", "TransferProtocolType": "HTTPS", "UserName": "", "Password":""}'

   $ curl -u $USER:$PASS -X PATCH -H "Content-Type: application/json" -H "If-Match: <ETAG>" https://$Server/redfish/v1/Managers/$ManagerID/VirtualMedia/$VmediaId -d '{"Image": "https://example.com/test.iso", "TransferProtocolType": "HTTPS", "UserName": "", "Password":""}'

프로세스

1. 선택 사항: 설치 프로그램에서 NMState YAML 구문을 확인하지 않기 때문에 install-config.yaml 파일에 구문을 포함하기 전에 nmstatectl gc 로 NMState 구문을 테스트하는 것이 좋습니다.

   참고

   YAML 구문의 오류로 인해 네트워크 구성을 적용하지 못할 수 있습니다. 또한 검증된 YAML 구문을 유지 관리하는 것은 배포 후 또는 클러스터를 확장할 때 Kubernetes NMState를 사용하여 변경 사항을 적용할 때 유용합니다.

   1. NMState YAML 파일을 생성합니다.

      interfaces: 

      1

      
      - name: <nic1_name>
        type: ethernet
        state: up
        ipv4:
          address:
          - ip: <ip_address>
            prefix-length: 24
          enabled: true
      dns-resolver:
        config:
          server:
          - <dns_ip_address>
      routes:
        config:
        - destination: 0.0.0.0/0
          next-hop-address: <next_hop_ip_address>
          next-hop-interface: <next_hop_nic1_name>

      1

      < nic1_name > , < ip_address > , < dns_ip_address > , < next_hop_ip_address > 및 < next_hop_nic1_name >을 적절한 값으로 바꿉니다.

   2. 다음 명령을 실행하여 구성 파일을 테스트합니다.

      $ nmstatectl gc <nmstate_yaml_file>

      & lt;nmstate_yaml_file&gt;을 구성 파일 이름으로 바꿉니다.

2. install-config.yaml 파일 내의 호스트에 NMState 구성을 추가하여 networkConfig 구성 설정을 사용합니다.

       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: redfish+http://<out_of_band_ip>/redfish/v1/Systems/
             username: <user>
             password: <password>
             disableCertificateVerification: null
           bootMACAddress: <NIC1_mac_address>
           bootMode: UEFI
           rootDeviceHints:
             deviceName: "/dev/sda"
           networkConfig: 

   1

   
             interfaces: 

   2

   
             - name: <nic1_name>
               type: ethernet
               state: up
               ipv4:
                 address:
                 - ip: <ip_address>
                   prefix-length: 24
                 enabled: true
             dns-resolver:
               config:
                 server:
                 - <dns_ip_address>
             routes:
               config:
               - destination: 0.0.0.0/0
                 next-hop-address: <next_hop_ip_address>
                 next-hop-interface: <next_hop_nic1_name>

   1

   NMState YAML 구문을 추가하여 호스트 인터페이스를 구성합니다.

   2

   < nic1_name > , < ip_address > , < dns_ip_address > , < next_hop_ip_address > 및 < next_hop_nic1_name >을 적절한 값으로 바꿉니다.

   중요

   클러스터를 배포한 후에는 install-config.yaml 파일의 networkConfig 구성 설정을 수정하여 호스트 네트워크 인터페이스를 변경할 수 없습니다. 배포 후 Kubernetes NMState Operator를 사용하여 호스트 네트워크 인터페이스를 변경합니다.

프로세스

1. 고정 IP 주소를 사용할 때 install-config.yaml 파일에서 machineNetwork 에 서브넷을 추가합니다.

   networking:
     machineNetwork:
     - cidr: 10.0.0.0/24
     - cidr: 192.168.0.0/24
     networkType: OVNKubernetes

2. 고정 IP 주소 또는 본딩과 같은 고급 네트워킹을 사용할 때 NMState 구문을 사용하여 각 엣지 컴퓨팅 노드의 networkConfig 매개변수에 게이트웨이 및 DNS 구성을 추가합니다.

   networkConfig:
     interfaces:
     - name: <interface_name> 

   1

   
       type: ethernet
       state: up
       ipv4:
         enabled: true
         dhcp: false
         address:
         - ip: <node_ip> 

   2

   
           prefix-length: 24
         gateway: <gateway_ip> 

   3

   
     dns-resolver:
       config:
         server:
         - <dns_ip> 

   4

   1

   &lt ;interface_name&gt;을 인터페이스 이름으로 바꿉니다.

   2

   & lt;node_ip& gt;를 노드의 IP 주소로 바꿉니다.

   3

   <gateway_ip>를 게이트웨이의 IP 주소로 바꿉니다.

   4

   <dns_ip>를 DNS 서버의 IP 주소로 바꿉니다.

프로세스

1. 선택 사항: 설치 프로그램에서 NMState YAML 구문을 확인하지 않기 때문에 nmstatectl gc 명령을 사용하여 NMState YAML 구문을 테스트하는 것이 좋습니다. install-config.yaml 파일에 포함하기 전에는 NMState YAML 구문을 확인하지 않습니다.

   1. NMState YAML 파일을 생성합니다.

      interfaces:
      - name: eth0
        ipv6:
          addr-gen-mode: <address_mode> 

      1

      1

      & lt;address_mode >를 클러스터의 IPv6 주소에 필요한 주소 생성 모드로 바꿉니다. 유효한 값은 eui64,stable-privacy 또는 random 입니다.

   2. 다음 명령을 실행하여 구성 파일을 테스트합니다.

      $ nmstatectl gc <nmstate_yaml_file> 

      1

      1

      & lt;nmstate_yaml_file& gt;을 테스트 구성 파일의 이름으로 바꿉니다.

2. install-config.yaml 파일 내의 hosts.networkConfig 섹션에 NMState 구성을 추가합니다.

       hosts:
         - name: openshift-master-0
           role: master
           bmc:
             address: redfish+http://<out_of_band_ip>/redfish/v1/Systems/
             username: <user>
             password: <password>
             disableCertificateVerification: null
           bootMACAddress: <NIC1_mac_address>
           bootMode: UEFI
           rootDeviceHints:
             deviceName: "/dev/sda"
           networkConfig:
             interfaces:
             - name: eth0
               ipv6:
                 addr-gen-mode: <address_mode> 

   1

   
   ...

   1

   & lt;address_mode >를 클러스터의 IPv6 주소에 필요한 주소 생성 모드로 바꿉니다. 유효한 값은 eui64,stable-privacy 또는 random 입니다.

프로세스

1. install-config.yaml 파일 내의 호스트에 networkConfig 필드에 NMState 구성을 추가합니다.

       hosts:
         - name: worker-0
           role: worker
           bmc:
             address: redfish+http://<out_of_band_ip>/redfish/v1/Systems/
             username: <user>
             password: <password>
             disableCertificateVerification: false
           bootMACAddress: <NIC1_mac_address>
           bootMode: UEFI
           networkConfig: 

   1

   
             interfaces: 

   2

   
              - name: eno1 

   3

   
                type: ethernet 

   4

   
                state: up
                mac-address: 0c:42:a1:55:f3:06
                ipv4:
                  enabled: true
                  dhcp: false 

   5

   
                ethernet:
                  sr-iov:
                    total-vfs: 2 

   6

   
                ipv6:
                  enabled: false
                  dhcp: false
              - name: sriov:eno1:0
                type: ethernet
                state: up 

   7

   
                ipv4:
                  enabled: false 

   8

   
                ipv6:
                  enabled: false
              - name: sriov:eno1:1
                type: ethernet
                state: down
              - name: eno2
                type: ethernet
                state: up
                mac-address: 0c:42:a1:55:f3:07
                ipv4:
                  enabled: true
                ethernet:
                  sr-iov:
                    total-vfs: 2
                ipv6:
                  enabled: false
              - name: sriov:eno2:0
                type: ethernet
                state: up
                ipv4:
                  enabled: false
                ipv6:
                  enabled: false
              - name: sriov:eno2:1
                type: ethernet
                state: down
              - name: bond0
                type: bond
                state: up
                min-tx-rate: 100 

   9

   
                max-tx-rate: 200 

   10

   
                link-aggregation:
                  mode: active-backup 

   11

   
                  options:
                    primary: sriov:eno1:0 

   12

   
                  port:
                    - sriov:eno1:0
                    - sriov:eno2:0
                ipv4:
                  address:
                    - ip: 10.19.16.57 

   13

   
                      prefix-length: 23
                  dhcp: false
                  enabled: true
                ipv6:
                  enabled: false
             dns-resolver:
               config:
                 server:
                   - 10.11.5.160
                   - 10.2.70.215
             routes:
               config:
                 - destination: 0.0.0.0/0
                   next-hop-address: 10.19.17.254
                   next-hop-interface: bond0 

   14

   
                   table-id: 254

   1

   networkConfig 필드에는 호스트의 네트워크 구성에 대한 정보가 있으며, 인터페이스,dns-resolver, 경로를 포함한 하위 필드가 있습니다.

   2

   interfaces 필드는 호스트에 정의된 네트워크 인터페이스의 배열입니다.

   3

   인터페이스의 이름입니다.

   4

   인터페이스 유형입니다. 이 예제에서는 이더넷 인터페이스를 생성합니다.

   5

   반드시 필요하지 않은 경우 물리적 기능(PF)의 DHCP를 비활성화하려면 이 값을 'false'로 설정합니다.

   6

   인스턴스화할 SR-IOV 가상 기능(VF) 수로 설정합니다.

   7

   이 값을 up 으로 설정합니다.

   8

   본딩에 연결된 VF의 IPv4 주소를 비활성화하려면 이를 false 로 설정합니다.

   9

   VF에 대해 최소 전송 속도(Mbps)를 설정합니다. 이 샘플 값은 100Mbps의 속도를 설정합니다.

   • 이 값은 최대 전송 속도보다 작거나 같아야 합니다.
   • Intel NIC는 min-tx-rate 매개변수를 지원하지 않습니다. 자세한 내용은 BZ#1772847 에서 참조하십시오.

   10

   VF에 대해 최대 전송 속도(Mbps)를 설정합니다. 이 샘플 값은 200Mbps의 속도를 설정합니다.

   11

   필요한 본딩 모드를 설정합니다.

   12

   본딩 인터페이스의 기본 포트를 설정합니다. 본딩은 기본 장치를 본딩 인터페이스의 첫 번째 장치로 사용합니다. 본딩은 실패하는 경우가 아니면 기본 장치 인터페이스를 종료하지 않습니다. 이 설정은 특히 본딩 인터페이스의 특정 NIC가 더 빨라서 더 큰 부하를 처리할 수 있는 경우 유용합니다. 이 설정은 본딩 인터페이스가 active-backup 모드(mode 1)인 경우에만 유효합니다.

   13

   본딩 인터페이스의 고정 IP 주소를 설정합니다. 노드 IP 주소입니다.

   14

   bond0 을 기본 경로의 게이트웨이로 설정합니다.

   중요

   클러스터를 배포한 후에는 install-config.yaml 파일의 networkConfig 구성 설정을 변경하여 호스트 네트워크 인터페이스를 변경할 수 없습니다. 배포 후 Kubernetes NMState Operator를 사용하여 호스트 네트워크 인터페이스를 변경합니다.