2.6. 추가 install-config 매개 변수


install-config.yaml 파일의 필수 매개 변수 hosts 매개 변수 및 bmc 매개 변수는 다음 표를 참조하십시오.

Expand
표 2.1. 필수 매개 변수
매개 변수기본설명

baseDomain

 

클러스터의 도메인 이름입니다. 예: example.com

bootMode

UEFI

노드의 부팅 모드입니다. 옵션은 legacy, UEFIUEFISecureBoot입니다. bootMode가 설정되지 않은 경우 Ironic은 노드를 검사하는 동안 해당 노드를 설정합니다.

platform:
  baremetal:
    bootstrapExternalStaticDNS
Copy to Clipboard Toggle word wrap
 

부트스트랩 노드의 정적 네트워크 DNS입니다. 베어 메탈 네트워크에 DHCP(동적 호스트 구성 프로토콜) 서버가 없는 경우 정적 IP 주소로 클러스터를 배포하는 경우 이 값을 설정해야 합니다. 이 값을 설정하지 않으면 설치 프로그램은 bootstrapExternalStaticGateway 의 값을 사용하게 되며, 게이트웨이와 DNS의 IP 주소 값이 다를 경우 문제가 발생합니다.

platform:
  baremetal:
    bootstrapExternalStaticIP
Copy to Clipboard Toggle word wrap
 

부트스트랩 VM의 고정 IP 주소입니다. 베어 메탈 네트워크에 DHCP 서버가 없는 경우 정적 IP 주소로 클러스터를 배포하는 경우 이 값을 설정해야 합니다.

platform:
  baremetal:
    bootstrapExternalStaticGateway
Copy to Clipboard Toggle word wrap
 

부트스트랩 VM의 게이트웨이의 정적 IP 주소입니다. 베어 메탈 네트워크에 DHCP 서버가 없는 경우 정적 IP 주소로 클러스터를 배포하는 경우 이 값을 설정해야 합니다.

sshKey

 

sshKey 구성 설정에는 제어 평면 노드와 컴퓨팅 노드에 액세스하는 데 필요한 키가 ~/.ssh/id_rsa.pub 파일에 있습니다. 일반적으로 이 키는 provisioner 노드에서 가져옵니다.

pullSecret

 

pullSecret 구성 설정에는 프로비저너 노드를 준비할 때 Bare Metal에 OpenShift 설치 페이지에서 다운로드한 풀 비밀 사본이 있습니다.

metadata:
    name:
Copy to Clipboard Toggle word wrap
 

OpenShift Container Platform 클러스터의 이름입니다. 예: openshift

networking:
    machineNetwork:
    - cidr:
Copy to Clipboard Toggle word wrap
 

외부 네트워크의 공개 CIDR (Classless Inter-Domain Routing)입니다. 예를 들어, 10.0.0.0/24 .

compute:
  - name: worker
Copy to Clipboard Toggle word wrap
 

OpenShift Container Platform 클러스터에서는 노드가 0인 경우에도 컴퓨팅 노드의 이름을 제공해야 합니다.

compute:
    replicas: 2
Copy to Clipboard Toggle word wrap
 

복제본은 OpenShift Container Platform 클러스터의 컴퓨팅 노드 수를 설정합니다.

controlPlane:
    name: master
Copy to Clipboard Toggle word wrap
 

OpenShift Container Platform 클러스터에는 제어 평면 노드에 대한 이름이 필요합니다.

controlPlane:
    replicas: 3
Copy to Clipboard Toggle word wrap
 

복제본은 OpenShift Container Platform 클러스터의 일부로 포함되는 제어 평면 노드의 수를 설정합니다.

arbiter:
    name: arbiter
Copy to Clipboard Toggle word wrap
 

OpenShift Container Platform 클러스터에는 중재자 노드의 이름이 필요합니다.

arbiter:
    replicas: 1
Copy to Clipboard Toggle word wrap
 

복제본 매개변수는 OpenShift Container Platform 클러스터의 중재자 노드 수를 설정합니다.

provisioningNetworkInterface

 

프로비저닝 네트워크에 연결된 노드의 네트워크 인터페이스 이름입니다. OpenShift Container Platform 4.9 이상 릴리스의 경우 bootMACAddress 구성 설정을 사용하여 Ironic에서 provisioningNetworkInterface 구성 설정을 사용하여 NIC 이름을 식별하는 대신 NIC의 IP 주소를 식별할 수 있습니다.

defaultMachinePlatform

 

플랫폼 구성없이 머신 풀에 사용되는 기본 설정입니다.

apiVIPs

 

(선택 사항) Kubernetes API 통신의 가상 IP 주소입니다.

install-config.yaml 파일에서 MachineNetwork 매개변수의 예약된 IP로 이 설정을 제공하거나 DNS에서 미리 구성하여 기본 이름이 올바르게 확인되도록 해야 합니다. install-config.yaml 파일에서 apiVIPs 구성 설정에 값을 추가할 때 FQDN이 아닌 가상 IP 주소를 사용하세요. 듀얼 스택 네트워킹을 사용하는 경우 기본 IP 주소는 IPv4 네트워크에서 가져와야 합니다. 설정하지 않으면 설치 프로그램은 api.<cluster_name>.<base_domain>을 사용하여 DNS에서 IP 주소를 가져옵니다.

참고

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

disableCertificateVerification

False

redfishredfish-virtualmedia 는 BMC 주소를 관리하기 위해 이 매개 변수가 필요합니다. BMC 주소에 자체 서명된 인증서를 사용하는 경우 값은 True 여야합니다.

ingressVIPs

 

(선택 사항) Ingress 트래픽의 가상 IP 주소입니다.

install-config.yaml 파일에서 MachineNetwork 매개변수의 예약된 IP로 이 설정을 제공하거나 DNS에서 미리 구성하여 기본 이름이 올바르게 확인되도록 해야 합니다. install-config.yaml 파일에서 ingressVIPs 구성 설정에 값을 추가할 때 FQDN이 아닌 가상 IP 주소를 사용하세요. 듀얼 스택 네트워킹을 사용하는 경우 기본 IP 주소는 IPv4 네트워크에서 가져와야 합니다. 설정하지 않으면 설치 프로그램은 test.apps.<cluster_name>.<base_domain>을 사용하여 DNS에서 IP 주소를 가져옵니다.

참고

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

Expand
표 2.2. 선택적 매개변수
매개 변수기본설명
platform:
  baremetal:
    additionalNTPServers:
    - <ip_address_or_domain_name>
Copy to Clipboard Toggle word wrap
 

각 호스트에 추가할 NTP 서버의 선택적 목록입니다. IP 주소나 도메인 이름을 사용하여 각 NTP 서버를 지정할 수 있습니다. 추가 NTP 서버는 클러스터 호스트 시계가 동기화되지 않았을 때 사전 설치 시계 동기화를 활성화하는 사용자 정의 NTP 서버입니다.

provisioningDHCPRange

172.22.0.10,172.22.0.100

프로비저닝 네트워크의 노드에 대한 IP 범위를 정의합니다.

provisioningNetworkCIDR

172.22.0.0/24

프로비저닝에 사용할 네트워크의 CIDR입니다. 프로비저닝 네트워크에서 기본 주소 범위를 사용하지 않는 경우 설치 프로그램에 이 옵션이 필요합니다.

clusterProvisioningIP

provisioningNetworkCIDR의 세 번째 IP 주소입니다.

프로비저닝 서비스가 실행되는 클러스터 내의 IP 주소입니다. 프로비저닝 서브넷의 세 번째 IP 주소로 기본 설정됩니다. 예: 172.22.0.3

bootstrapProvisioningIP

provisioningNetworkCIDR의 두 번째 IP 주소입니다.

설치 프로그램이 제어 플레인(마스터) 노드를 배포하는 동안 프로비저닝 서비스가 실행되는 부트스트랩 VM의 IP 주소입니다. 프로비저닝 서브넷의 두 번째 IP 주소로 기본 설정됩니다. 예를 들면 172.22.0.2 또는 2620:52:0:1307::2 입니다.

externalBridge

baremetal

베어 메탈 네트워크에 연결된 하이퍼바이저의 베어 메탈 브리지 이름입니다.

provisioningBridge

provisioning

프로비저닝 네트워크에 연결된 프로비저너 호스트의 프로비저닝 브리지 이름입니다.

architecture

 

클러스터의 호스트 아키텍처를 정의합니다. 유효한 값은 amd64 또는 arm64 입니다.

defaultMachinePlatform

 

플랫폼 구성없이 머신 풀에 사용되는 기본 설정입니다.

bootstrapOSImage

 

부트스트랩 노드의 기본 운영 체제 이미지를 재정의하는 URL입니다. URL에는 이미지의 SHA-256 해시가 포함되어 있어야합니다. 예: https://mirror.openshift.com/rhcos-<version>-qemu.qcow2.gz?sha256=<uncompressed_sha256> .

provisioningNetwork

 

provisioningNetwork 구성 설정은 클러스터가 프로비저닝 네트워크를 사용하는지 여부를 결정합니다. 이 경우 구성 설정에서 클러스터가 네트워크를 관리하는지 여부도 결정합니다.

비활성화 : 이 매개변수를 비활성화 로 설정하면 프로비저닝 네트워크 요구 사항을 비활성화할 수 있습니다. 비활성화 로 설정하면 가상 미디어 기반 프로비저닝만 사용하거나 Assisted Installer를 사용하여 클러스터를 시작해야 합니다. 비활성화 로 설정하고 전원 관리를 사용하는 경우 베어 메탈 네트워크에서 BMC에 액세스할 수 있어야 합니다. 비활성화 로 설정하면 설치 프로그램이 프로비저닝 서비스에 사용하는 베어 메탈 네트워크에 두 개의 IP 주소를 제공해야 합니다.

Managed: DHCP, TFTP 등을 포함하여 프로비저닝 네트워크를 완전히 관리하려면 이 매개 변수를 기본값인 Managed 로 설정합니다.

Unmanaged: 이 매개 변수를 Unmanaged 로 설정하여 프로비저닝 네트워크를 활성화하지만 DHCP를 수동으로 설정합니다. 가상 미디어의 프로비저닝이 권장되지만 필요한 경우 PXE를 계속 사용할 수 있습니다.

httpProxy

 

이 매개 변수를 환경 내에서 사용되는 적절한 HTTP 프록시로 설정합니다.

httpsProxy

 

이 매개 변수를 환경 내에서 사용되는 적절한 HTTPS 프록시로 설정합니다.

noProxy

 

이 매개 변수를 환경 내 프록시 사용에 대한 적절한 예외 목록으로 설정합니다.

호스트

hosts 매개 변수는 클러스터를 빌드하는 데 사용되는 별도의 베어 메탈 자산 목록입니다.

Expand
표 2.3. 호스트
이름기본설명

name

 

세부 정보와 연결할 BareMetalHost 리소스의 이름입니다. 예: openshift-master-0

role

 

베어 메탈 노드의 역할. 마스터 (제어 평면 노드) 또는 워커 (컴퓨팅 노드).

bmc

 

베이스 보드 관리 컨트롤러에 대한 연결 세부 정보입니다. 자세한 내용은 BMC 주소 지정 섹션을 참조하십시오.

bootMACAddress

 

호스트가 프로비저닝 네트워크에 사용하는 NIC의 MAC 주소입니다. ironic은 bootMACAddress 구성 설정을 사용하여 IP 주소를 검색합니다. 그러면 호스트에 바인딩됩니다.

참고

프로비저닝 네트워크를 비활성화한 경우 호스트에서 유효한 MAC 주소를 제공해야 합니다.

networkConfig

 

이 선택적 매개 변수를 설정하여 호스트의 네트워크 인터페이스를 구성합니다. 자세한 내용은 "(선택 사항) 호스트 네트워크 인터페이스 구성"을 참조하세요.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat