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


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

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

참고

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

8.2.1. 필수 구성 매개변수

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

Expand
표 8.7. 필수 매개 변수
매개변수설명
apiVersion:
Copy to Clipboard Toggle word wrap

agent-config.yaml 콘텐츠에 대한 API 버전입니다. 현재 버전은 v1beta1 입니다. 설치 프로그램이 이전 API 버전을 지원할 수도 있습니다.

문자열

metadata:
Copy to Clipboard Toggle word wrap

Kubernetes 리소스 ObjectMetaname 매개변수만 사용합니다.

개체

metadata:
  name:
Copy to Clipboard Toggle word wrap

클러스터의 이름입니다. 클러스터의 DNS 레코드는 {{.metadata.name}}.{{. baseDomain}} 형식의 모든 하위 도메인입니다. agent-config.yaml 파일에 입력된 값은 무시되고, 대신 install-config.yaml 파일에 지정된 값이 사용됩니다. install-config.yaml 또는 agent-config.yaml 파일을 통해 metadata.name을 제공하지 않는 경우(예: ZTP 매니페스트만 사용하는 경우) 클러스터 이름은 agent-cluster 로 설정됩니다.

소문자와 하이픈( - )으로 이루어진 문자열(예: dev ).

8.2.2. 선택적 구성 매개변수

다음 표에서는 선택적 에이전트 구성 매개변수를 설명합니다.

Expand
표 8.8. 선택적 매개변수
매개변수설명
rendezvousIP:
Copy to Clipboard Toggle word wrap

부트스트래핑 프로세스를 수행하고 지원 서비스 구성 요소를 실행하는 노드의 IP 주소입니다. networkConfig 매개변수에 호스트의 IP 주소를 하나라도 지정하지 않은 경우 랑데부 IP 주소를 제공해야 합니다. 이 주소가 제공되지 않으면 제공된 호스트의 networkConfig 에서 하나의 IP 주소가 선택됩니다.

IPv4 또는 IPv6 주소.

bootArtifactsBaseURL:
Copy to Clipboard Toggle word wrap

에이전트 기반 설치 프로그램을 사용하여 최소 ISO 이미지를 생성하는 경우, 이 매개변수는 클러스터 설치 중에 rootfs 이미지 파일을 검색할 수 있는 URL을 지정합니다. 이 매개변수는 연결된 환경에서 최소 ISO 이미지를 부팅하는 데 있어 선택 사항입니다.

에이전트 기반 설치 프로그램을 사용하여 iPXE 스크립트를 생성하는 경우, 이 매개변수는 PXE(Preboot Execution Environment) 자산을 업로드할 서버의 URL을 지정합니다. 자세한 내용은 "OpenShift Container Platform을 위한 PXE 자산 준비"를 참조하세요.

문자열.

additionalNTPSources:
Copy to Clipboard Toggle word wrap

모든 클러스터 호스트에 추가할 NTP(네트워크 시간 프로토콜) 소스 목록으로, 다른 방법으로 구성된 모든 NTP 소스에 추가됩니다.

호스트 이름 또는 IP 주소 목록.

hosts:
Copy to Clipboard Toggle word wrap

호스트 구성. 호스트의 선택 목록입니다. 정의된 호스트 수는 install-config.yaml 파일에 정의된 총 호스트 수를 초과할 수 없습니다. 이는 compute.replicascontrolPlane.replicas 매개변수 값의 합계입니다.

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

hosts:
  hostname:
Copy to Clipboard Toggle word wrap

호스트 이름. DHCP(동적 호스트 구성 프로토콜) 또는 역방향 DNS 조회에서 얻은 호스트 이름을 재정의합니다. 각 호스트는 이러한 방법 중 하나를 통해 제공되는 고유한 호스트 이름을 가져야 하지만, 이 매개변수를 통해 호스트 이름을 구성하는 것은 선택 사항입니다.

문자열.

hosts:
  interfaces:
Copy to Clipboard Toggle word wrap

호스트의 인터페이스에 대한 이름 및 MAC 주소 매핑 표를 제공합니다. agent-config.yaml 파일에 NetworkConfig 섹션이 제공된 경우 이 테이블을 포함해야 하며 값은 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

특정 장치에 Red Hat Enterprise Linux CoreOS(RHCOS) 이미지를 프로비저닝할 수 있습니다. 설치 프로그램은 장치를 발견한 순서대로 검사하고, 발견된 값을 힌트 값과 비교합니다. 힌트 값과 일치하는 첫 번째로 발견된 장치를 사용합니다. 이것은 설치 중에 운영 체제가 기록되는 장치입니다.

키-값 쌍의 사전입니다. 자세한 내용은 "OpenShift 설치를 위한 환경 설정" 페이지에서 "루트 장치 힌트"를 참조하세요.

hosts:
  rootDeviceHints:
    deviceName:
Copy to Clipboard Toggle word wrap

RHCOS 이미지가 프로비저닝되는 장치의 이름입니다.

문자열.

hosts:
  networkConfig:
Copy to Clipboard Toggle word wrap

호스트 네트워크 정의. 구성은 nmstate 설명서 에 정의된 호스트 네트워크 관리 API와 일치해야 합니다.

호스트 네트워크 구성 개체의 사전입니다.

minimalISO:
Copy to Clipboard Toggle word wrap

에이전트 기반 설치 프로그램이 전체 ISO 또는 최소 ISO 이미지를 생성하는지 여부를 정의합니다. 이 매개변수를 True 로 설정하면 에이전트 기반 설치 프로그램은 rootfs 이미지 파일 없이 ISO를 생성하고, 대신 rootfs 파일을 가져올 위치에 대한 세부 정보를 포함합니다.

최소 ISO를 생성할 때 bootArtifactsBaseURL 매개변수를 통해 rootfs URL을 지정하지 않으면 에이전트 기반 설치 프로그램은 인터넷에 연결된 환경에서 접근할 수 있는 기본 URL을 포함합니다.

기본값은 False 입니다.

부울.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

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

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

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

Red Hat 소개

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

Theme

© 2025 Red Hat