7.2. 사용 가능한 에이전트 구성 매개변수

다음 표에서는 에이전트 기반 설치 프로세스의 일부로 설정할 수 있는 필수 및 선택적 에이전트 구성 매개변수를 지정합니다.

이러한 값은 agent-config.yaml 파일에 지정됩니다.

참고

이러한 설정은 설치에만 사용되며 설치 후에는 수정할 수 없습니다.

7.2.1. 필수 구성 매개변수
링크 복사

필수 에이전트 구성 매개변수는 다음 표에 설명되어 있습니다.

Expand

표 7.7. 필수 매개 변수
매개변수	설명	값
`apiVersion:` Copy to Clipboard Toggle word wrap	`agent-config.yaml` 콘텐츠의 API 버전입니다. 현재 버전은 `v1beta1` 입니다. 설치 프로그램에서 이전 API 버전도 지원할 수 있습니다.	문자열
`metadata:` Copy to Clipboard Toggle word wrap	Kubernetes 리소스 `ObjectMeta`로 `name` 매개변수만 사용합니다.	개체
`metadata: name:` Copy to Clipboard Toggle word wrap	클러스터의 이름입니다. 클러스터의 DNS 레코드는 `{{.metadata.name}}.{{. baseDomain}}` 형식의 모든 하위 도메인입니다. `agent-config.yaml` 파일에 입력된 값은 무시되며, 대신 `install-config.yaml` 파일에 지정된 값이 사용됩니다. 예를 들어 ZTP 매니페스트만 사용하는 경우 `install-config.yaml` 또는 `agent-config.yaml` 파일을 통해 `metadata.name` 을 지정하지 않으면 클러스터 이름이 `agent-cluster` 로 설정됩니다.	소문자 및 하이픈(`-`)의 문자열(예: `dev` )입니다.

7.2.2. 선택적 구성 매개변수
링크 복사

선택적 에이전트 구성 매개변수는 다음 표에 설명되어 있습니다.

Expand

표 7.8. 선택적 매개변수
매개변수	설명	값
`rendezvousIP:` Copy to Clipboard Toggle word wrap	부트스트랩 프로세스를 수행하고 `assisted-service` 구성 요소를 실행하는 노드의 IP 주소입니다. `networkConfig` 매개변수에 하나 이상의 호스트의 IP 주소를 지정하지 않는 경우 rendezvous IP 주소를 제공해야 합니다. 이 주소를 제공하지 않으면 제공된 호스트의 `networkConfig` 에서 하나의 IP 주소가 선택됩니다.	IPv4 또는 IPv6 주소.
`bootArtifactsBaseURL:` Copy to Clipboard Toggle word wrap	에이전트 기반 설치 관리자를 사용하여 iPXE 스크립트를 생성할 때 PXE(Preboot Execution Environment) 자산을 업로드할 서버의 URL입니다. 자세한 내용은 "OpenShift Container Platform용 PXE 자산 준비"를 참조하십시오.	문자열.
`additionalNTPSources:` Copy to Clipboard Toggle word wrap	다른 수단을 통해 구성된 모든 NTP 소스에 추가되는 모든 클러스터 호스트에 추가할 NTP(Network Time Protocol) 소스 목록입니다.	호스트 이름 또는 IP 주소 목록입니다.
`hosts:` Copy to Clipboard Toggle word wrap	호스트 구성. 선택적 호스트 목록입니다. 정의된 호스트 수는 `compute.replicas` 및 `controlPlane.replicas` 매개변수 값의 합계인 `install-config.yaml` 파일에 정의된 총 호스트 수를 초과해서는 안 됩니다.	호스트 구성 오브젝트의 배열입니다.
`hosts: hostname:` Copy to Clipboard Toggle word wrap	호스트 이름. DHCP(Dynamic Host Configuration Protocol) 또는 역방향 DNS 조회에서 가져온 호스트 이름을 재정의합니다. 이 매개 변수를 통해 호스트 이름을 구성하는 것은 선택 사항이지만 각 호스트에는 이러한 방법 중 하나에서 제공하는 고유한 호스트 이름이 있어야 합니다.	문자열.
`hosts: interfaces:` Copy to Clipboard Toggle word wrap	호스트의 인터페이스에 대한 이름 및 MAC 주소 매핑 테이블을 제공합니다. `NetworkConfig` 섹션이 `agent-config.yaml` 파일에 제공된 경우 이 테이블을 포함해야 하며 값이 `NetworkConfig` 섹션에 제공된 매핑과 일치해야 합니다.	호스트 구성 오브젝트의 배열입니다.
`hosts: interfaces: name:` Copy to Clipboard Toggle word wrap	호스트의 인터페이스 이름입니다.	문자열.
`hosts: interfaces: macAddress:` Copy to Clipboard Toggle word wrap	호스트에 있는 인터페이스의 MAC 주소입니다.	다음 예와 같은 MAC 주소: `00-B0-D0-63-C2-26`.
`hosts: role:` Copy to Clipboard Toggle word wrap	호스트가 `마스터` 또는 `작업자` 노드인지 여부를 정의합니다. `agent-config.yaml` 파일에 역할이 정의되어 있지 않으면 클러스터 설치 중에 역할이 무작위로 할당됩니다.	`마스터` 또는 `작업자`.
`hosts: rootDeviceHints:` Copy to Clipboard Toggle word wrap	특정 장치에 대한 RHCOS(Red Hat Enterprise Linux CoreOS) 이미지의 프로비저닝을 활성화합니다. 설치 프로그램은 장치를 검색한 순서대로 검사하고 검색된 값을 팁과 비교합니다. 힌트 값과 일치하는 첫 번째 검색된 장치를 사용합니다. 이 장치는 설치 중에 운영 체제가 작성된 장치입니다.	키-값 쌍으로 이루어진 사전입니다. 자세한 내용은 "OpenShift 설치를 위한 환경 설정" 페이지의 "루트 장치 팁"을 참조하십시오.
`hosts: rootDeviceHints: deviceName:` Copy to Clipboard Toggle word wrap	RHCOS 이미지가 프로비저닝되는 장치의 이름입니다.	문자열.
`hosts: networkConfig:` Copy to Clipboard Toggle word wrap	호스트 네트워크 정의입니다. 구성은 nmstate 설명서에 정의된 Host Network Management API와 일치해야 합니다.	호스트 네트워크 구성 오브젝트로 이루어진 사전입니다.

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat

맨 위로 이동