3장. BareMetalHost [metal3.io/v1alpha1]

아키텍처

string

호스트의 CPU 아키텍처(예: "x86_64" 또는 "aarch64"). 설정되지 않으면 결국 검사에 의해 채워집니다.

automatedCleaningMode

string

disabled로 설정하면 프로비저닝 및 프로비저닝 해제 중에 자동화된 정리를 건너뜁니다.

bmc

object

호스트의 BMC(Baseboard Management Controller)에 어떻게 연결합니까?

bootMACAddress

string

호스트 프로비저닝에 사용되는 NIC의 MAC 주소입니다. 네트워크 부팅의 경우 이는 PXE 부팅 인터페이스의 MAC 주소입니다. BMC의 MAC 주소는 여기에서 사용해서는 안 됩니다!

bootMode

string

부팅 중에 하드웨어를 초기화하는 방법을 선택합니다. 기본값은 UEFI입니다. 레거시 부팅은 UEFI를 올바르게 지원하지 않는 하드웨어에만 사용해야 합니다. 프로비저닝 후 자동으로 보안 부팅을 끄려면 UEFISecureBoot로 설정합니다.

consumerRef

object

ConsumerRef를 사용하여 호스트를 사용하는 항목에 대한 정보를 저장할 수 있습니다. 비어 있지 않으면 호스트는 "사용 중"으로 간주됩니다. 일반적인 사용 사례는 호스트를 Cluster API에서 사용할 때 Machine 리소스에 대한 링크입니다.

CustomDeploy

object

사용자 정의 배포 절차. 이는 사이트별 배포 램디스크에서 제공하는 사용자 정의 배포 단계를 사용할 수 있는 고급 기능입니다. 대부분의 사용자는 대신 "이미지"를 사용합니다. 이 필드를 설정하면 프로비저닝이 트리거됩니다.

description

string

Description은 호스트를 식별하는 데 사용되는 human-entered 텍스트입니다.

disablePowerOff

boolean

true로 설정하면 노드의 전원 끄기가 비활성화되고 대신 전원 켜기/오프 대신 재부팅이 사용됩니다.

externallyProvisioned

boolean

ExternallyProvisioned는 다른 사용자가 호스트에서 실행 중인 이미지를 프로비저닝했으며 운영자는 전원 상태만 관리함을 의미합니다. 이 필드는 이미 프로비저닝된 호스트와의 통합 및 클러스터 간에 호스트를 피벗할 때 사용됩니다. 확실하지 않은 경우 이 필드를 false로 두십시오.

펌웨어

object

베어 메탈 서버의 펌웨어(BIOS) 구성. 설정하면 호스트가 프로비저닝되기 전에 요청된 설정이 적용됩니다. 일부 공급업체 드라이버만 이 필드를 지원합니다. 대체 방법은 임의의 값을 변경하고 일반 Redfish 기반 드라이버를 지원할 수 있는 HostFirmwareSettings 리소스를 사용하는 것입니다.

hardwareProfile

string

이 호스트의 하드웨어 프로필 이름은 무엇입니까? 하드웨어 프로필은 더 이상 사용되지 않으며 사용해서는 안 됩니다. 대신 별도의 필드 Architecture 및 RootDeviceHints를 사용합니다. 하드웨어 프로필 없이 향후 API 버전을 준비하려면 "empty"로 설정합니다.

image

object

이미지에는 프로비저닝할 이미지의 세부 정보가 있습니다. 이미지를 채우면 호스트가 프로비저닝을 시작합니다.

metaData

object

메타데이터에는 구성 드라이브에 전달되는 호스트 메타데이터가 포함된 보안에 대한 참조가 있습니다. 기본적으로 호스트에 대한 메타데이터가 생성되므로 대부분의 사용자는 이 필드를 설정할 필요가 없습니다.

networkData

object

networkData는 Config Drive로 전달되는 네트워크 구성이 포함된 Secret에 대한 참조를 보유하고 cloud-init와 같은 첫 번째 부팅 소프트웨어에서 해석합니다.

온라인

boolean

호스트의 전원이 켜야 합니까? 호스트가 현재 안정적인 상태(예: 프로비저닝된)인 경우 전원 상태가 이 값과 일치하도록 강제 적용됩니다.

preprovisioningNetworkDataName

string

PreprovisioningNetworkDataName은 사전 프로비저닝 이미지로 전달되는 네트워크 구성이 포함된 로컬 네임스페이스의 시크릿 이름과 NetworkData를 지정하여 재정의하지 않는 경우 구성 드라이브에 해당합니다.

RAID

object

베어 메탈 서버에 대한 RAID 구성 설정하면 호스트가 프로비저닝되기 전에 RAID 설정이 적용됩니다. 그렇지 않으면 현재 설정이 수정되지 않습니다. 하위 필드의 hardwareRAIDVolumes 및 softwareRAIDVolume 중 하나만 동시에 설정할 수 있습니다.

rootDeviceHints

object

프로비저닝 중인 이미지의 장치를 선택하는 방법에 대한 지침을 제공합니다. 기본값은 현재 /dev/sda를 root 장치로 사용하는 것입니다.

테인트

array

테인트는 해당 머신에 적용할 수 있는 모든 권한이 있는 테인트 목록입니다. 이 목록은 머신의 모든 수정 사항을 지속적으로 덮어씁니다.

taints[]

object

이 테인트가 연결된 노드에는 테인트를 허용하지 않는 Pod에 "효과"가 있습니다.

userData

object

userdata에는 Config Drive로 전달되는 사용자 데이터가 포함된 Secret에 대한 참조가 있으며 cloud-init와 같은 첫 번째 부팅 소프트웨어에서 해석됩니다. 사용자 데이터 형식은 최초 부팅 소프트웨어에 따라 다릅니다.

address

string

address에는 네트워크에서 컨트롤러에 액세스하기 위한 URL이 있습니다. 스키마 부분은 호스트와 함께 사용할 드라이버를 지정합니다.

credentialsName

string

BMC 인증 정보가 포함된 시크릿의 이름입니다(키 "사용자 이름" 및 "암호")가 필요합니다.

disableCertificateVerification

boolean

disableCertificateVerification은 HTTPS를 사용하여 BMC에 연결할 때 서버 인증서 확인을 비활성화합니다. 이는 서버 인증서가 자체 서명된 경우 필요하지만 중간자(man-in-the-middle)가 연결을 가로챌 수 있기 때문에 안전하지 않은 경우 필요합니다.

apiVersion

string

참조의 API 버전입니다.

fieldPath

string

전체 오브젝트 대신 오브젝트 조각을 참조하는 경우 이 문자열에는 desiredState.manifest.containers[2]와 같은 유효한 JSON/Go 필드 액세스 문이 포함되어야 합니다. 예를 들어 오브젝트 참조가 Pod 내의 컨테이너에 대한 경우 "spec.containers{name}"과 같은 값을 사용합니다(여기서 "name"은 이벤트를 트리거한 컨테이너 이름을 참조하거나 컨테이너 이름이 "spec.containers[2]"이 Pod에서 인덱스 2가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다.

kind

string

일종의 추천입니다. 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

네임스페이스

string

참조의 네임스페이스입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceVersion

string

이 참조가 수행되는 특정 resourceVersion(있는 경우). 자세한 내용은 https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

uid

string

참조의 UID입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

method

string

사용자 정의 배포 방법 이름. 이 이름은 사용된 배포 램디스크에 따라 다릅니다. 사용자 정의 배포 램디스크가 없는 경우 CustomDeploy를 사용해서는 안 됩니다.

simultaneousMultithreadingEnabled

boolean

단일 물리적 프로세서 코어를 여러 논리 프로세서로 표시할 수 있습니다.

sriovEnabled

boolean

SR-IOV 지원을 사용하면 하이퍼바이저에서 PCI-express 장치의 가상 인스턴스를 생성하여 성능이 증가할 수 있습니다.

virtualizationEnabled

boolean

플랫폼 하드웨어의 가상화 지원.

checksum

string

체크섬은 이미지의 체크섬입니다. "live-iso"를 제외한 모든 형식에 필요합니다.

checksumType

string

ChecksumType은 이미지의 체크섬 알고리즘(예: md5, sha256 또는 sha512)입니다. 체크섬에서 알고리즘을 감지하는 데 특수 값 "auto"를 사용할 수 있습니다. 누락된 경우 MD5가 사용됩니다. 의심의 여지가있는 경우 "auto"를 사용하십시오.

format

string

형식은 이미지 형식(raw, qcow2, …​)을 포함합니다. "live-iso"로 설정하면 url에서 참조하는 ISO 9660 이미지가 라이브 부팅되고 디스크에 배포되지 않습니다.

url

string

URL은 배포할 이미지의 위치입니다.

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

hardwareRAIDVolumes

``

하드웨어 RAID용 논리 디스크 목록입니다. rootDeviceHints를 사용하지 않는 경우 첫 번째 볼륨은 root 볼륨입니다. 이 필드의 값을 [] 로 설정하여 모든 하드웨어 RAID 구성을 지울 수 있습니다.

SoftwareRAIDVolumes

``

소프트웨어 RAID용 논리 디스크 목록입니다. rootDeviceHints를 사용하지 않는 경우 첫 번째 볼륨은 root 볼륨입니다. HardwareRAIDVolumes가 설정된 경우 이 항목이 유효하지 않습니다. 생성된 소프트웨어 RAID 장치의 수는 1 또는 2여야 합니다. 소프트웨어 RAID 장치가 하나뿐인 경우 RAID-1이어야 합니다. 두 개가 있는 경우 첫 번째는 RAID-1이어야 하며 두 번째 항목의 RAID 수준은 0, 1 또는 1+0일 수 있습니다. 첫 번째 RAID 장치가 배포 장치가 되므로 RAID-1을 적용하면 디스크 오류가 발생할 경우 부팅되지 않은 호스트로 종료할 위험이 줄어듭니다. 소프트웨어 RAID는 항상 삭제됩니다.

deviceName

string

"/dev/vda" 또는 "/dev/vda"와 같은 Linux 장치 이름 또는 "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0"과 같은 Linux 장치 이름입니다. 팁은 실제 값과 정확히 일치해야 합니다.

hctl

string

0:0:0:0과 같은 SCSI 버스 주소입니다. 팁은 실제 값과 정확히 일치해야 합니다.

minSizeGigabytes

integer

장치의 최소 크기(Gigabytes)입니다.

model

string

벤더별 장치 식별자입니다. 팁은 실제 값의 하위 문자열입니다.

rotational

boolean

장치가 회전 미디어를 사용해야 하는 경우 true이고, 그렇지 않으면 false입니다.

serialNumber

string

장치 일련 번호입니다. 팁은 실제 값과 정확히 일치해야 합니다.

vendor

string

장치의 공급 업체 또는 제조업체의 이름입니다. 팁은 실제 값의 하위 문자열입니다.

wwn

string

고유 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

wwnVendorExtension

string

고유한 벤더 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

wwnWithExtension

string

벤더 확장이 추가된 고유 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

effect

string

필수 항목입니다. 테인트를 허용하지 않는 pod에 테인트의 영향을 미칩니다. 유효한 영향은 NoSchedule, PreferNoSchedule 및 NoExecute입니다.

key

string

필수 항목입니다. 노드에 적용할 taint 키입니다.

timeAdded

string

TimeAdded는 테인트가 추가된 시간을 나타냅니다. NoExecute 테인트에만 작성됩니다.

value

string

taint 키에 해당하는 taint 값입니다.

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

errorCount

integer

ErrorCount는 마지막으로 성공한 작업 이후 호스트가 오류 발생 횟수를 기록합니다.

errorMessage

string

프로비저닝 하위 시스템에서 보고한 마지막 오류 메시지입니다.

errorType

string

ErrorType은 OperationalStatus가 OperationalStatusError일 때 발생하는 오류 유형을 나타냅니다.

goodCredentials

object

마지막 인증 정보는 작동으로 검증할 수 있었습니다.

하드웨어

object

호스트에 있는 하드웨어입니다. 이 필드는 별도의 HardwareData 리소스에 선호되는 다음 API 버전에서 제거됩니다.

hardwareProfile

string

하드웨어 세부 정보와 일치하는 프로필의 이름입니다. 하드웨어 프로필은 더 이상 사용되지 않으며 사용하지 않아야 합니다.

lastUpdated

string

LastUpdated는 이 상태가 마지막으로 관찰된 시기를 식별합니다.

operationHistory

object

OperationHistory는 이 호스트에서 수행된 작업에 대한 정보를 보유합니다.

operationalStatus

string

OperationalStatus에는 호스트 상태가 있음

poweredOn

boolean

호스트의 현재 감지된 전원 상태입니다. 이 필드는 프로비저닝 프로세스가 실행되는 동안 하드웨어의 실제 상태와 간단히 동기화되지 않을 수 있습니다.

provisioning

object

프로비저너가 추적하는 정보입니다.

triedCredentials

object

프로비저닝 백엔드로 마지막 인증 정보입니다.

credentials

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

credentialsVersion

string

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.

cpu

object

시스템의 CPU 세부 정보입니다.

펌웨어

object

시스템 펌웨어 정보.

hostname

string

nics

array

호스트의 네트워크 인터페이스 목록입니다.

nics[]

object

NIC는 호스트의 하나의 네트워크 인터페이스를 설명합니다.

ramMebibytes

integer

호스트의 메모리 양(MB)입니다.

storage

array

호스트에서 사용할 수 있는 스토리지 목록(디스크, SSD 등)입니다.

storage[]

object

스토리지는 호스트에서 하나의 스토리지 장치(디스크, SSD 등)를 설명합니다.

systemVendor

object

시스템 벤더 정보.

arch

string

clockMegahertz

number

ClockSpeed는 ClockSpeed의 클럭 속도입니다.

count

integer

플래그

배열(문자열)

model

string

BIOS

object

이 펌웨어의 BIOS

date

string

이 BIOS의 릴리스/빌드 날짜

vendor

string

이 BIOS의 공급 업체 이름

version

string

BIOS 버전

ip

string

인터페이스의 IP 주소입니다. 해당 주소가 있는 경우 IPv4 또는 IPv6 주소가 됩니다. IPv4 및 IPv6 주소가 모두 듀얼 스택 환경에 있는 경우 각 IP가 하나씩 출력됩니다.

mac

string

장치 MAC 주소

model

string

NIC의 공급 업체 및 제품 ID (예:) "0x8086 0x1572"

name

string

네트워크 인터페이스의 이름(예: "en0")

pxe

boolean

NIC가 PXE 부팅 가능 여부

speedGbps

integer

초당 Gigabits의 장치 속도

vlanId

integer

태그되지 않은 VLAN ID

vlans

array

사용 가능한 VLAN

vlans[]

object

VLAN은 VLAN의 이름과 ID를 나타냅니다.

id

integer

VLANID는 12비트 802.1Q VLAN 식별자입니다.

name

string

alternateNames

배열(문자열)

디스크의 대체 Linux 장치 이름 목록(예: "/dev/sda"). 이 목록은 전체 목록이 아니며 재부팅 시 이름이 안정적이지 않을 수 있습니다.

hctl

string

장치의 SCSI 위치

model

string

하드웨어 모델

name

string

디스크의 Linux 장치 이름(예: "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0"). 이 이름은 사용 가능한 경우 재부팅 시 안정적입니다.

rotational

boolean

이 디스크가 회전 스토리지를 나타내는지 여부입니다. 이 필드는 사용에 권장되지 않습니다. 대신 'Type' 필드를 사용하는 것이 좋습니다. 이 필드는 결국 더 이상 사용되지 않습니다.

serialNumber

string

장치의 일련 번호

sizeBytes

integer

disk의 크기

type

string

장치 유형, HDD, SSD, NVME 중 하나.

vendor

string

장치 공급 업체의 이름

wwn

string

장치의 WWN

wwnVendorExtension

string

장치의 WWN 벤더 확장

wwnWithExtension

string

확장 기능이 있는 WWN

제조업체

string

productName

string

serialNumber

string

프로비저닝 해제

object

OperationMetric에는 메트릭을 추적하는 데 사용되는 작업(검사, 프로비저닝 등)에 대한 메타데이터가 포함되어 있습니다.

inspect

object

OperationMetric에는 메트릭을 추적하는 데 사용되는 작업(검사, 프로비저닝 등)에 대한 메타데이터가 포함되어 있습니다.

프로비저닝

object

OperationMetric에는 메트릭을 추적하는 데 사용되는 작업(검사, 프로비저닝 등)에 대한 메타데이터가 포함되어 있습니다.

register

object

OperationMetric에는 메트릭을 추적하는 데 사용되는 작업(검사, 프로비저닝 등)에 대한 메타데이터가 포함되어 있습니다.

end

``

start

``

end

``

start

``

end

``

start

``

end

``

start

``

ID

string

기본 프로비저닝 툴의 호스트 ID(예: Ironic 노드 UUID)입니다.

bootMode

string

bootMode는 호스트를 프로비저닝하는 데 사용되는 부팅 모드를 나타냅니다.

CustomDeploy

object

호스트에 적용된 사용자 정의 배포 절차.

펌웨어

object

적용된 펌웨어 설정입니다.

image

object

이미지에는 호스트에 성공적으로 프로비저닝된 마지막 이미지의 세부 정보가 있습니다.

RAID

object

적용된 RAID 구성입니다.

rootDeviceHints

object

호스트를 프로비저닝하는 데 사용되는 루트 장치 팁입니다.

상태

string

프로비저너가 호스트에서 수행하는 작업을 나타내는 지표입니다.

method

string

사용자 정의 배포 방법 이름. 이 이름은 사용된 배포 램디스크에 따라 다릅니다. 사용자 정의 배포 램디스크가 없는 경우 CustomDeploy를 사용해서는 안 됩니다.

simultaneousMultithreadingEnabled

boolean

단일 물리적 프로세서 코어를 여러 논리 프로세서로 표시할 수 있습니다.

sriovEnabled

boolean

SR-IOV 지원을 사용하면 하이퍼바이저에서 PCI-express 장치의 가상 인스턴스를 생성하여 성능이 증가할 수 있습니다.

virtualizationEnabled

boolean

플랫폼 하드웨어의 가상화 지원.

checksum

string

체크섬은 이미지의 체크섬입니다. "live-iso"를 제외한 모든 형식에 필요합니다.

checksumType

string

ChecksumType은 이미지의 체크섬 알고리즘(예: md5, sha256 또는 sha512)입니다. 체크섬에서 알고리즘을 감지하는 데 특수 값 "auto"를 사용할 수 있습니다. 누락된 경우 MD5가 사용됩니다. 의심의 여지가있는 경우 "auto"를 사용하십시오.

format

string

형식은 이미지 형식(raw, qcow2, …​)을 포함합니다. "live-iso"로 설정하면 url에서 참조하는 ISO 9660 이미지가 라이브 부팅되고 디스크에 배포되지 않습니다.

url

string

URL은 배포할 이미지의 위치입니다.

hardwareRAIDVolumes

``

하드웨어 RAID용 논리 디스크 목록입니다. rootDeviceHints를 사용하지 않는 경우 첫 번째 볼륨은 root 볼륨입니다. 이 필드의 값을 [] 로 설정하여 모든 하드웨어 RAID 구성을 지울 수 있습니다.

SoftwareRAIDVolumes

``

소프트웨어 RAID용 논리 디스크 목록입니다. rootDeviceHints를 사용하지 않는 경우 첫 번째 볼륨은 root 볼륨입니다. HardwareRAIDVolumes가 설정된 경우 이 항목이 유효하지 않습니다. 생성된 소프트웨어 RAID 장치의 수는 1 또는 2여야 합니다. 소프트웨어 RAID 장치가 하나뿐인 경우 RAID-1이어야 합니다. 두 개가 있는 경우 첫 번째는 RAID-1이어야 하며 두 번째 항목의 RAID 수준은 0, 1 또는 1+0일 수 있습니다. 첫 번째 RAID 장치가 배포 장치가 되므로 RAID-1을 적용하면 디스크 오류가 발생할 경우 부팅되지 않은 호스트로 종료할 위험이 줄어듭니다. 소프트웨어 RAID는 항상 삭제됩니다.

deviceName

string

"/dev/vda" 또는 "/dev/vda"와 같은 Linux 장치 이름 또는 "/dev/disk/by-path/pci-0000:01:00.0-scsi-0:2:0:0"과 같은 Linux 장치 이름입니다. 팁은 실제 값과 정확히 일치해야 합니다.

hctl

string

0:0:0:0과 같은 SCSI 버스 주소입니다. 팁은 실제 값과 정확히 일치해야 합니다.

minSizeGigabytes

integer

장치의 최소 크기(Gigabytes)입니다.

model

string

벤더별 장치 식별자입니다. 팁은 실제 값의 하위 문자열입니다.

rotational

boolean

장치가 회전 미디어를 사용해야 하는 경우 true이고, 그렇지 않으면 false입니다.

serialNumber

string

장치 일련 번호입니다. 팁은 실제 값과 정확히 일치해야 합니다.

vendor

string

장치의 공급 업체 또는 제조업체의 이름입니다. 팁은 실제 값의 하위 문자열입니다.

wwn

string

고유 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

wwnVendorExtension

string

고유한 벤더 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

wwnWithExtension

string

벤더 확장이 추가된 고유 스토리지 식별자입니다. 팁은 실제 값과 정확히 일치해야 합니다.

credentials

object

SecretReference는 시크릿 참조를 나타냅니다. 모든 네임스페이스에서 시크릿을 검색하기에 충분한 정보가 있습니다.

credentialsVersion

string

name

string

이름은 시크릿 리소스를 참조하는 네임스페이스 내에서 고유합니다.

네임스페이스

string

네임스페이스는 시크릿 이름을 고유해야 하는 공간을 정의합니다.