YAML 파일 작성 규칙 (초보자 필독)
가장 중요한 규칙 2가지
- 들여쓰기(띄어쓰기): 절대
Tab 키를 쓰지 마세요! 스페이스바 2칸을 사용해야 합니다.
- 콜론(:) 다음 공백:
key:value (X) -> key: value
(O)
콜론 뒤에는 반드시 한 칸을 띄워야 합니다.
설정은 크게 이름(Key)과 값(Value)으로 나뉩니다.
목록 (List) 작성법
여러 개의 값을 넣으려면 대쉬(-)를 사용합니다.
# 과일 목록 예시
fruits:
- "사과" # 리스트 1
- "바나나" # 리스트 2
- "포도" # 리스트 3
설정 (Object) 작성법
하위 설정을 넣으려면 들여쓰기를 합니다.
# 자동차 설정 예시
car:
color: "Red" # 스페이스 2칸
speed: 100 # 스페이스 2칸
is_active: true # 스페이스 2칸
MAC 주소 수집 프로파일
서버의 네트워크 카드(NIC)의 물리적 주소(MAC)를 가져오는 설정입니다.
description: "기본 MAC 수집 설정"
# 1. 수집할 NIC(네트워크 카드)의 이름 패턴
nic_patterns:
- "NIC.Integrated.1" # 메인보드 내장 랜카드 1번
- "NIC.Slot.*" # 슬롯에 꽂힌 모든 랜카드 (PCIe)
# 2. InfiniBand(고속 네트워크) 카드가 있다면 슬롯 번호를 적으세요
infiniband_slots:
- "PCIeSlot3" # 3번 슬롯에 꽂힌 카드
# 3. iDRAC 전용 포트의 MAC도 필요하면 true로 설정
include_idrac_mac: true
상세 설명
| 항목 |
설명 |
nic_patterns |
가져올 랜카드의 이름입니다. *(별표)는 '모두'를 의미합니다. 예: NIC.*는 모든
랜카드를 다 가져옵니다. |
infiniband_slots |
InfiniBand는 일반 NIC와 달라서 슬롯 번호(예: PCIeSlot3)를 정확히 적어야 합니다. |
서버 정보 수집 프로파일
서버의 펌웨어, BIOS 설정, 하드웨어 상태 등을 확인하는 설정입니다.
description: "서버 점검용 설정"
# 1. 버전 정보를 알고 싶은 펌웨어 이름들
firmware:
- "iDRAC"
- "BIOS"
- "NIC"
# 2. 확인하고 싶은 BIOS 설정값
bios_settings:
- "MemTest" # 메모리 테스트 옵션
- "LogicalProc" # 하이퍼스레딩(논리코어)
# 3. RAID 컨트롤러의 디스크 정보
raid_settings:
- "Disk.Bay.0" # 0번 베이의 하드디스크 정보
# 4. 기타 명령어 실행 (상급자용)
custom_items:
- command: "getsysinfo"
label: "전체 시스템 요약"
GPU 및 GUID 설정
GPU의 시리얼 번호를 수집하거나, iDRAC MAC 주소를 기반으로 GUID를 생성할 때 사용합니다.
description: "GPU 서버용 설정"
# 1. GPU 시리얼 수집 설정 (GPU가 있는 경우 필수)
gpu_settings:
target_slots:
- "Video.Slot.*" # 모든 비디오 카드 수집
sort_order: "slot_index" # 슬롯 순서대로 정렬
# 2. GUID 생성 시 슬롯 우선순위
# iDRAC MAC 말고, 특정 랜카드의 MAC을 GUID로 쓰고 싶을 때 사용
slot_priority:
- 38 # 38번 슬롯 카드의 MAC을 1순위로 사용
- 1 # 없으면 1번 슬롯 사용
output_format: "combined"
팁: GPU 시리얼만 필요하다면
slot_priority 부분은 지워도 됩니다.