6.4.3. 클러스터 구성 참조
ISO 이미지를 생성할 때 대상 클러스터에서 구성이 검색되고 새 노드에 적용됩니다. ISO 이미지를 생성하기 전에 nodes-config.yaml 파일 또는 oc adm node-image create 명령에 추가한 플래그를 지정하여 이러한 구성을 덮어쓸 수 있습니다.
- YAML 파일 매개변수
nodes-config.yaml파일에 지정할 수 있는 구성 매개변수는 다음 표에 설명되어 있습니다.Expand 표 6.2. nodes-config.yaml parameters 매개변수 설명 값 hosts:호스트 구성.
호스트 구성 오브젝트의 배열입니다.
hosts: hostname:호스트 이름. DHCP(Dynamic Host Configuration Protocol) 또는 역방향 DNS 조회에서 가져온 호스트 이름을 재정의합니다. 이 매개 변수를 통해 호스트 이름을 구성하는 것은 선택 사항이지만 각 호스트에는 이러한 방법 중 하나에서 제공하는 고유한 호스트 이름이 있어야 합니다.
문자열.
hosts: interfaces:호스트의 인터페이스에 대한 이름 및 MAC 주소 매핑 테이블을 제공합니다.
NetworkConfig섹션이nodes-config.yaml파일에 제공된 경우 이 테이블을 포함해야 하며 값이NetworkConfig섹션에 제공된 매핑과 일치해야 합니다.호스트 구성 오브젝트의 배열입니다.
hosts: interfaces: name:호스트의 인터페이스 이름입니다.
문자열.
hosts: interfaces: macAddress:호스트에 있는 인터페이스의 MAC 주소입니다.
다음 예와 같은 MAC 주소:
00-B0-D0-63-C2-26.hosts: rootDeviceHints:특정 장치에 대한 RHCOS(Red Hat Enterprise Linux CoreOS) 이미지의 프로비저닝을 활성화합니다. 노드 추가 툴에서 장치를 검색한 순서대로 검사하고 검색된 값을 팁과 비교합니다. 힌트 값과 일치하는 첫 번째 검색된 장치를 사용합니다.
키-값 쌍으로 이루어진 사전입니다. 자세한 내용은 "OpenShift 설치를 위한 환경 설정" 페이지의 "루트 장치 팁"을 참조하십시오.
hosts: rootDeviceHints: deviceName:RHCOS 이미지가 프로비저닝되는 장치의 이름입니다.
문자열.
hosts: networkConfig:호스트 네트워크 정의입니다. 구성은 nmstate 설명서에 정의된 Host Network Management API와 일치해야 합니다.
호스트 네트워크 구성 오브젝트로 이루어진 사전입니다.
cpuArchitecture:선택 사항입니다. 추가하는 노드의 아키텍처를 지정합니다. 이 매개변수를 사용하면 필요한 경우 클러스터의 기본값을 덮어쓸 수 있습니다.
문자열.
sshKey:선택 사항입니다. 클러스터 시스템에 대한 액세스를 인증하는 SSH 키가 포함된 파일입니다.
문자열.
bootArtifactsBaseURL:선택 사항입니다. iPXE 스크립트를 생성할 때 PXE(Preboot Execution Environment) 자산을 업로드할 서버의 URL을 지정합니다. ISO 이미지 대신 PXE 자산을 생성하려면
--pxe플래그를 설정해야 합니다.문자열.
- 명령 플래그 옵션
oc adm node-image create명령과 함께 명령 플래그를 사용하여 생성 중인 노드를 구성할 수 있습니다.다음 표에서는 단일 노드 사용 사례에 국한되지 않는 명령 플래그를 설명합니다.
Expand 표 6.3. 일반 명령 플래그 플래그 설명 값 --certificate-authority관리 컨테이너 이미지 레지스트리와 통신할 때 사용할 인증 기관 번들의 경로입니다.
--insecure플래그를 사용하면 이 플래그가 무시됩니다.문자열
--dir제공된 경우 구성 파일이 포함된 경로입니다. 이 경로는 생성된 아티팩트를 저장하는 데도 사용됩니다.
문자열
--insecureHTTP를 통해 레지스트리에 푸시 및 가져오기 작업을 수행할 수 있습니다.
부울
-o,--output-name생성된 출력 이미지의 이름입니다.
문자열
p,--pxe부팅 가능한 ISO 파일 대신 PXE(Preboot Execution Environment) 자산을 생성합니다.
이 플래그가 설정되면
nodes-config.yaml파일에서bootArtifactsBaseURL매개변수를 사용하여 PXE 자산을 업로드할 서버의 URL을 지정할 수도 있습니다.부울
-a,--registry-config레지스트리 자격 증명의 경로입니다. 또는
REGISTRY_AUTH_FILE환경 변수를 지정할 수 있습니다. 기본 경로는${XDG_RUNTIME_DIR}/containers/auth.json,/run/containers/${UID}/auth.json,${XDG_CONFIG_HOME}/containers/auth.json,${DOCKER_CONFIG},~/.docker/config.json,~/.dockercfg입니다.Podman을 통해 Docker 자격 증명의 우선 순위를 지정하기 위해 더 이상 사용되지 않는REGISTRY_AUTH_PREFERENCE환경 변수를 "docker" 값으로 변경할 수 있습니다.문자열
-r,--report프로세스가 성공했는지 여부에 관계없이 노드 생성 프로세스에 대한 보고서를 생성합니다. 이 플래그를 지정하지 않으면 오류가 발생한 경우에만 보고서가 생성됩니다.
부울
--skip-verification검색된 콘텐츠의 무결성 확인을 건너뛰는 옵션입니다. 이는 권장되지 않지만 이전 이미지 레지스트리에서 이미지를 가져올 때 필요할 수 있습니다. 레지스트리가 신뢰할 수 있는 것으로 알려진 경우에만 확인을 바이패스합니다.
부울
다음 표에서는 단일 노드를 생성할 때만 사용할 수 있는 명령 플래그를 설명합니다.
Expand 표 6.4. 단일 노드 전용 명령 플래그 플래그 설명 값 -c,--cpu-architecture노드를 설치하는 데 사용할 CPU 아키텍처입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며
--mac-address플래그를 정의해야 합니다.문자열
--hostname노드에 설정할 호스트 이름입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며
--mac-address플래그를 정의해야 합니다.문자열
-m,--mac-address구성을 적용할 호스트를 식별하는 데 사용되는 MAC 주소입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며
--mac-address플래그를 정의해야 합니다.문자열
--network-config-path노드에 적용할 NMState 구성이 포함된 YAML 파일의 경로입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며
--mac-address플래그를 정의해야 합니다.문자열
--root-device-hint이미지 루트 파일 시스템의 스토리지 위치를 지정하기 위한 팁입니다. 허용되는 형식은 <
hint_name>:<value> 입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며--mac-address플래그를 정의해야 합니다.문자열
-k,--ssh-key-path노드에 액세스하는 데 사용되는 SSH 키의 경로입니다. 이 플래그는 단일 노드만 생성하는 데 사용할 수 있으며
--mac-address플래그를 정의해야 합니다.문자열