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

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

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

참고

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

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

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

Expand

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

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

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

Expand

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

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2026 Red Hat

맨 위로 이동