8장. 에이전트 기반 설치 프로그램의 설치 구성 매개변수

install-config.yaml 콘텐츠의 API 버전입니다. 현재 버전은 v1입니다. 설치 프로그램에서 이전 API 버전도 지원할 수 있습니다.

값: 문자열

클라우드 공급자의 기본 도메인입니다. 기본 도메인은 OpenShift Container Platform 클러스터 구성 요소에 대한 경로를 생성하는 데 사용됩니다. 클러스터의 전체 DNS 이름은 baseDomain과 metadata.name 매개변수 값의 조합으로, <metadata.name>.<baseDomain> 형식입니다.

값: example.com 과 같은 완전히 정규화된 도메인 또는 하위 도메인 이름입니다.

Kubernetes 리소스 ObjectMeta로 name 매개변수만 사용합니다.

값: 객체

클러스터의 이름입니다. 클러스터의 DNS 레코드는 {{.metadata.name}}.{{. baseDomain}} 형식의 모든 하위 도메인입니다. install-config.yaml 또는 agent-config.yaml 파일을 통해 metadata.name 매개변수를 제공하지 않으면 클러스터 이름이 agent-cluster 로 설정됩니다. 예를 들어, ZTP 매니페스트만 사용하는 설치는 metadata.name 매개변수를 제공하지 않습니다.

값: 소문자, 하이픈( - ), 마침표( . )로 구성된 문자열(예: dev ).

설치를 수행할 특정 플랫폼에 대한 구성: baremetal , external , none , vsphere 또는 nutanix .

값: 객체

Red Hat OpenShift Cluster Manager에서 풀 시크릿을 가져와서 Quay.io와 같은 서비스에서 OpenShift Container Platform 구성 요소의 컨테이너 이미지 다운로드를 인증합니다.

값:

{
   "auths":{
      "cloud.openshift.com":{
         "auth":"b3Blb=",
         "email":"you@example.com"
      },
      "quay.io":{
         "auth":"b3Blb=",
         "email":"you@example.com"
      }
   }
}

클러스터의 네트워크의 구성입니다.

값: 객체

Red Hat OpenShift Networking 네트워크 플러그인을 설치합니다.

가치: OVNKubernetes . OVNKubernetes 는 Linux 네트워크와 Linux와 Windows 서버를 모두 포함하는 하이브리드 네트워크를 위한 컨테이너 네트워크 인터페이스(CNI) 플러그인입니다. 기본값은 OVNKubernetes 입니다.

Pod의 IP 주소 블록입니다.

기본값은 10.128.0.0/14이며, 호스트 접두사는 /23입니다.

여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.

값: 객체의 배열. 예를 들면 다음과 같습니다.

networking:
  clusterNetwork:
  - cidr: 10.128.0.0/14
    hostPrefix: 23
  - cidr: fd01::/48
    hostPrefix: 64

networking.clusterNetwork를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다.

OVN-Kubernetes 네트워크 공급자를 사용하는 경우 IPv4 및 IPv6 네트워크를 지정할 수 있습니다.

값: CIDR(Classless Inter-Domain Routing) 표기법의 IP 주소 블록입니다. IPv4 블록의 접두사 길이는 0에서 32 사이입니다. IPv6 블록의 접두사 길이는 0에서 128 사이입니다. 예를 들면 10.128.0.0/14 또는 fd01::/48입니다.

개별 노드 각각에 할당할 서브넷 접두사 길이입니다. 예를 들어 hostPrefix를 23으로 설정하는 경우, 지정된 cidr 이외 /23 서브넷이 각 노드에 할당됩니다. 23의 hostPrefix 값은 510(2^(32 - 23) - 2) Pod IP 주소를 제공합니다.

값: 서브넷 접두사.

IPv4 네트워크의 경우 기본값은 23입니다. IPv6 네트워크의 경우 기본값은 64입니다. 기본값은 IPv6의 최소 값이기도 합니다.

서비스의 IP 주소 블록입니다. 기본값은 172.30.0.0/16입니다.

OVN-Kubernetes 네트워크 플러그인은 서비스 네트워크에 대해 단일 IP 주소 블록만 지원합니다.

OVN-Kubernetes 네트워크 공급자를 사용하는 경우 IPv4 및 IPv6 주소 제품군 모두에 IP 주소 블록을 지정할 수 있습니다.

값: CIDR 형식의 IP 주소 블록이 있는 배열입니다. 예를 들면 다음과 같습니다.

networking:
  serviceNetwork:
   - 172.30.0.0/16
   - fd02::/112

시스템의 IP 주소 블록입니다.

여러 IP 주소 블록을 지정하는 경우 블록이 겹치지 않아야 합니다.

값: 객체의 배열. 예를 들면 다음과 같습니다.

networking:
  machineNetwork:
  - cidr: 10.0.0.0/16

networking.machineNetwork를 사용하는 경우 필수 항목입니다. IP 주소 블록입니다. libvirt 및 IBM Power® Virtual Server를 제외한 모든 플랫폼의 기본값은 10.0.0.0/16 입니다. libvirt의 기본값은 192.168.126.0/24입니다. IBM Power® Virtual Server의 경우 기본값은 192.168.0.0/24 입니다.

값: CIDR 표기법의 IP 네트워크 블록입니다.

예를 들면 10.0.0.0/16 또는 fd00::/48입니다.

ovn-kubernetes 에서 내부적으로 사용하는 IPv4 조인 서브넷을 구성합니다. 이 서브넷은 노드 네트워크를 포함하여 OpenShift Container Platform이 사용하는 다른 서브넷과 겹치면 안 됩니다. 서브넷의 크기는 노드 수보다 커야 합니다. 설치 후에는 값을 변경할 수 없습니다.

값: CIDR 표기법의 IP 네트워크 블록입니다. 기본값은 100.64.0.0/16 입니다.

노드의 신뢰할 수 있는 인증서 스토리지에 추가되는 PEM 인코딩 X.509 인증서 번들입니다. 이 신뢰할 수 있는 번들은 프록시가 구성되었을 때에도 사용할 수 있습니다.

값: 문자열

선택적 핵심 클러스터 구성 요소의 설치를 제어합니다. 선택적 구성 요소를 비활성화하여 OpenShift Container Platform 클러스터의 설치 공간을 줄일 수 있습니다. 자세한 내용은 설치 의 "클러스터 기능" 페이지를 참조하세요.

값: 문자열 배열

활성화할 선택적 기능의 초기 세트를 선택합니다. 유효한 값은 None , v4.11 , v4.12 및 vCurrent 입니다. 기본값은 vCurrent 입니다.

값: 문자열

baselineCapabilitySet 에서 지정한 것 이상으로 선택적 기능 세트를 확장합니다. 이 매개변수에서 여러 기능을 지정할 수 있습니다.

값: 문자열 배열

워크로드 분할을 활성화하여 OpenShift Container Platform 서비스, 클러스터 관리 워크로드 및 인프라 포드를 격리하여 예약된 CPU 세트에서 실행할 수 있습니다. 설치 중에만 워크로드 분할을 활성화할 수 있습니다. 설치 후에는 비활성화할 수 없습니다. 이 필드는 작업 부하 분할을 활성화하지만, 특정 CPU를 사용하도록 작업 부하를 구성하지는 않습니다. 자세한 내용은 확장성 및 성능 섹션의 워크로드 분할 페이지를 참조하세요.

값: 없음 또는 AllNodes . 기본값은 없음 입니다.

컴퓨팅 노드를 구성하는 시스템의 구성입니다.

값: MachinePool 객체의 배열.

풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 amd64 , arm64 , ppc64le 및 s390x 입니다.

값: 문자열

컴퓨팅 시스템에서 동시 멀티스레딩 또는 hyperthreading 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다.

값: 활성화 또는 비활성화

compute를 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.

가치: 근로자

compute를 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 작업자 시스템을 호스팅할 클라우드 공급자를 지정합니다. 이 매개변수 값은 controlPlane.platform 매개변수 값과 일치해야 합니다

값: baremetal , vsphere 또는 {}

프로비저닝할 컴퓨팅 시스템(작업자 시스템이라고도 함) 수입니다.

값: 2 이상의 양의 정수. 기본값은 3입니다.

클러스터에 기능 세트를 활성화합니다. 기능 세트는 기본적으로 활성화되어 있지 않은 OpenShift Container Platform 기능 컬렉션입니다. 설치 중에 기능 세트를 활성화하는 방법에 대한 자세한 내용은 "기능 게이트를 사용하여 기능 활성화"를 참조하십시오.

값: 문자열. TechPreviewNoUpgrade 와 같이 활성화할 기능 세트의 이름입니다.

제어 평면을 형성하는 머신에 대한 구성입니다.

값: MachinePool 객체의 배열.

풀에 있는 시스템의 명령어 집합 아키텍처를 결정합니다. 현재 다양한 아키텍처가 있는 클러스터는 지원되지 않습니다. 모든 풀은 동일한 아키텍처를 지정해야 합니다. 유효한 값은 amd64 , arm64 , ppc64le 및 s390x 입니다.

값: 문자열

컨트롤 플레인 시스템에서 동시 멀티스레딩 또는 hyperthreading 활성화 또는 비활성화 여부를 지정합니다. 시스템 코어의 성능을 높이기 위해 기본적으로 동시 멀티스레딩이 활성화됩니다.

값: 활성화 또는 비활성화

controlPlane을 사용하는 경우 필수 항목입니다. 시스템 풀의 이름입니다.

값: 마스터

controlPlane을 사용하는 경우 필수 항목입니다. 이 매개변수를 사용하여 컨트롤 플레인 시스템을 호스팅하는 클라우드 공급자를 지정합니다. 이 매개변수 값은 compute.platform 매개변수 값과 일치해야 합니다.

값: baremetal , vsphere 또는 {}

프로비저닝하는 컨트롤 플레인 시스템의 수입니다.

값: 단일 노드 OpenShift를 배포할 때 지원되는 값은 3 , 4 , 5 또는 1 입니다.

Cloud Credential Operator (CCO) 모드입니다. 모드가 지정되지 않은 경우 CCO는 여러 모드가 지원되는 플랫폼에서 Mint 모드가 우선으로 되어 지정된 인증 정보의 기능을 동적으로 확인하려고합니다.

값: Mint , Passthrough , Manual 또는 빈 문자열( "" ).

FIPS 모드를 활성화 또는 비활성화합니다. 기본값은 false(비활성화)입니다. FIPS 모드를 활성화하면 OpenShift Container Platform이 실행되는 Red Hat Enterprise Linux CoreOS(RHCOS) 머신은 기본 Kubernetes 암호화 제품군을 우회하고 대신 RHCOS에서 제공하는 암호화 모듈을 사용합니다.

값: 거짓 또는 참

릴리스 이미지 내용의 소스 및 리포지토리입니다.

값: 객체의 배열. 이 표의 다음 행에 설명된 대로 source와 mirrors(선택사항)가 포함됩니다.

imageContentSources를 사용하는 경우 필수 항목입니다. 예를 들어 이미지 가져오기 사양에서 사용자가 가리키는 리포지토리를 지정합니다.

값: 문자열

동일한 이미지를 포함할 수도 있는 하나 이상의 리포지토리를 지정합니다.

값: 문자열 배열

Kubernetes API, OpenShift 경로와 같이 클러스터의 사용자 끝점을 게시하거나 노출하는 방법입니다.

가치: 내부적 또는 외부적 . 기본값은 External입니다.

이 필드를 Internal 로 설정하는 것은 클라우드 이외의 플랫폼에서는 지원되지 않습니다.

클러스터 머신에 대한 액세스를 인증하는 SSH 키입니다.

값: 예를 들어, sshKey: ssh-ed25519 AAAA.. .

프로비저닝 서비스가 실행되는 클러스터 내의 IP 주소입니다. 기본값은 provisioning 서브넷의 세 번째 IP 주소입니다. 예를 들면 172.22.0.2 또는 2620:52:0:1307::2 입니다.

값: IPv4 또는 IPv6 주소.

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

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

Disabled: provisioning 네트워크의 요구 사항을 비활성화하려면 이 매개변수를 Disabled 로 설정합니다. 비활성화 로 설정하면 2일차에는 가상 미디어 기반 프로비저닝만 사용할 수 있습니다. Disabled 및 전원 관리를 사용하는 경우 baremetal 네트워크에서 BMC에 액세스할 수 있어야 합니다. Disabled 인 경우 프로비저닝 서비스에 사용되는 baremetal 네트워크에 두 개의 IP 주소를 제공해야 합니다.

값: 관리됨 또는 비활성화됨 .

프로비저닝 서비스가 실행되는 클러스터 내의 MAC 주소입니다.

값: MAC 주소.

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

값: 유효한 CIDR, 예: 10.0.0.0/16 .

provisioning 네트워크에 연결된 노드의 네트워크 인터페이스 이름입니다. provisioningNetworkInterface 구성 설정을 사용하여 NIC 이름을 식별하는 대신 bootMACAddress 구성 설정을 사용하여 Ironic이 NIC의 IP 주소를 식별할 수 있도록 합니다.

값: 문자열.

프로비저닝 네트워크의 노드에 대한 IP 범위를 정의합니다(예: 172.22.0.10,172.22.0.254 ).

값: IP 주소 범위.

베어 메탈 호스트에 대한 구성.

값: 호스트 구성 객체의 배열입니다.

호스트의 이름.

값: 문자열.

호스트 프로비저닝에 사용되는 NIC의 MAC 주소입니다.

값: MAC 주소.

호스트가 베이스보드 관리 컨트롤러(BMC)에 연결하기 위한 구성입니다.

값: BMC 구성 개체 사전.

BMC의 사용자 이름입니다.

값: 문자열.

BMC의 비밀번호입니다.

값: 문자열.

호스트의 BMC 컨트롤러와 통신하기 위한 URL입니다. address 구성 설정은 프로토콜을 지정합니다. 예를 들어, redfish+http://10.10.10.1:8000/redfish/v1/Systems/1234는 Redfish를 활성화합니다. 자세한 내용은 "베어 메탈에 설치 프로그램 제공 클러스터 배포" 섹션의 "BMC 주소 지정"을 참조하세요.

값: URL.

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

값: 부울.

클러스터를 호스팅하는 클라우드 플랫폼의 계정을 설명합니다. 매개변수를 사용하여 플랫폼을 사용자 지정할 수 있습니다. 머신 풀의 컴퓨팅 및 제어 평면 머신에 대한 추가 구성 설정을 제공하는 경우 매개변수는 필요하지 않습니다.

값: vSphere 구성 개체 사전

지역과 구역 간의 관계를 설정합니다. 데이터 저장소 개체와 같은 vCenter 개체를 사용하여 장애 도메인을 정의합니다. 장애 도메인은 OpenShift Container Platform 클러스터 노드에 대한 vCenter 위치를 정의합니다.

값: 실패 도메인 구성 개체의 배열입니다.

실패 도메인의 이름입니다.

값: 문자열

클러스터에 대해 여러 개의 장애 도메인을 정의하는 경우 각 vCenter 데이터 센터에 태그를 첨부해야 합니다. 지역을 정의하려면 openshift-region 태그 카테고리의 태그를 사용하세요. 단일 vSphere 데이터 센터 환경의 경우 태그를 첨부할 필요는 없지만 매개변수에 대해 datacenter 와 같은 영숫자 값을 입력해야 합니다. 호스트 그룹을 기반으로 장애 도메인을 구축하려면 데이터 센터 대신 vSphere 클러스터에 이러한 태그를 첨부하세요.

값: 문자열

호스트 그룹을 활성화하기 위해 ComputeCluster 지역 유형을 지정합니다.

값: 문자열

클라이언트가 장애 도메인 리소스에 액세스할 수 있도록 VMware vCenter 서버의 정규화된 호스트 이름 또는 IP 주소를 지정합니다. vSphere vCenter 서버 위치에 서버 역할을 적용해야 합니다.

값: 문자열

클러스터에 대해 여러 개의 장애 도메인을 정의하는 경우 각 vCenter 클러스터에 태그를 첨부해야 합니다. 영역을 정의하려면 openshift-zone 태그 카테고리의 태그를 사용하세요. 단일 vSphere 데이터 센터 환경의 경우 태그를 첨부할 필요는 없지만 매개변수에 대해 cluster 와 같은 영숫자 값을 입력해야 합니다. 호스트 그룹을 기반으로 실패 도메인을 만들려면 클러스터 대신 호스트 그룹에 해당하는 영역을 정의하세요. 이러한 태그를 사용하여 각 ESXi 호스트를 해당 호스트 그룹과 연결합니다.

값: 문자열

호스트 그룹을 활성화하기 위해 HostGroup 영역 유형을 지정합니다.

값: 문자열

vSphere 컴퓨팅 클러스터로 가는 경로입니다.

값: 문자열

OpenShift Container Platform 가상 머신(VM)이 작동하는 데이터 센터를 나열하고 정의합니다. 데이터 센터 목록은 vcenters 필드에 지정된 데이터 센터 목록과 일치해야 합니다.

값: 문자열

가상 머신 파일, 템플릿 및 ISO 이미지를 보관하는 vSphere 데이터스토어의 경로입니다.

값: 문자열

선택 사항: 사용자가 가상 머신을 만든 기존 폴더의 절대 경로입니다(예: /<data_center_name>/vm/<folder_name>/<subfolder_name> ).

값: 문자열

장애 도메인과 연결할 vSphere 호스트 그룹을 지정합니다.

값: 문자열

vCenter 인스턴스에서 구성한 가상 IP 주소 및 DNS 레코드가 포함된 네트워크입니다.

값: 문자열

선택 사항: 설치 프로그램이 가상 머신을 생성하는 기존 리소스 풀의 절대 경로입니다(예: /<data_center_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name> ).

값: 문자열

기존 Red Hat Enterprise Linux CoreOS(RHCOS) 이미지 템플릿이나 가상 머신의 절대 경로를 지정합니다. 설치 프로그램은 이미지 템플릿이나 가상 머신을 사용하여 vSphere 호스트에 RHCOS를 빠르게 설치할 수 있습니다. vSphere 호스트에 RHCOS 이미지를 업로드하는 대안으로 이 매개변수를 사용하는 것을 고려하세요. 이 매개변수는 설치 프로그램에서 제공하는 인프라에서만 사용할 수 있습니다.

값: 문자열

서비스가 vCenter 서버와 통신할 수 있도록 연결 세부 정보를 구성합니다.

값: vCenter 구성 개체의 배열입니다.

OpenShift Container Platform 가상 머신(VM)이 작동하는 데이터 센터를 나열하고 정의합니다. 데이터 센터 목록은 failureDomains 필드에 지정된 데이터 센터 목록과 일치해야 합니다.

값: 문자열

vSphere 사용자와 연결된 암호입니다.

값: 문자열

vCenter 서버와 통신하는 데 사용되는 포트 번호입니다.

값: 정수

vCenter 서버의 정규화된 호스트 이름 또는 IP 주소입니다.

값: 문자열

vSphere 사용자와 연결된 사용자 이름입니다.

값: 문자열

OpenShift Container Platform 클러스터를 설치할 vCenter 클러스터입니다.

값: 문자열

OpenShift Container Platform 가상 머신(VM)이 작동하는 데이터 센터를 정의합니다.

값: 문자열

프로비저닝 볼륨에 사용할 기본 데이터 저장소의 이름입니다.

값: 문자열

설치 프로그램이 가상 머신을 생성하는 기존 폴더의 절대 경로입니다. 이 값을 제공하지 않으면 설치 프로그램이 데이터 센터 가상 머신 폴더에 인프라 ID로 이름이 지정된 폴더를 생성합니다.

값: 문자열, 예: /<data_center_name>/vm/<folder_name>/<subfolder_name> .

vCenter 사용자 이름의 암호입니다.

값: 문자열

선택 사항: 설치 프로그램이 가상 머신을 생성하는 기존 리소스 풀의 절대 경로입니다. 값을 지정하지 않으면 설치 프로그램은 클러스터 루트의 /<data_center_name>/host/<cluster_name>/Resources 에 리소스를 설치합니다.

값: 문자열, 예: /<data_center_name>/host/<cluster_name>/Resources/<resource_pool_name>/<optional_nested_resource_pool_name> .

vCenter 인스턴스에 연결하는 데 사용할 사용자 이름입니다. 이 사용자에게는 최소한 vSphere에서 정적 또는 동적 영구 볼륨 프로비저닝에 필요한 역할과 권한이 있어야 합니다.

값: 문자열

vCenter 서버의 정규화된 호스트 이름 또는 IP 주소입니다.

값: 문자열