3장. BareMetalHost [metal3.io/v1alpha1]

아키텍처

string

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

automatedCleaningMode

string

disabled로 설정하면 프로비저닝 및 프로비저닝 해제 중에 자동화된 정리를 방지할 수 있습니다.

bmc

object

BMC에 어떻게 연결할 수 있습니까?

bootMACAddress

string

어떤 MAC 주소를 PXE 부팅합니까? 일부 유형의 경우 선택 사항이지만 vbmc에 의해 구동되는 libvirt VM에 필요합니다.

bootMode

string

부팅 중에 하드웨어를 초기화하는 방법을 선택합니다. 기본값은 UEFI입니다.

consumerRef

object

ConsumerRef를 사용하여 호스트를 사용하는 항목에 대한 정보를 저장할 수 있습니다. 비어 있지 않으면 호스트는 "사용 중"으로 간주됩니다.

customDeploy

object

사용자 정의 배포 절차.

description

string

Description is a human-entered text used to help identify the host

externallyProvisioned

boolean

ExternallyProvisioned는 다른 사용자가 호스트에서 실행 중인 이미지를 관리하고 있음을 의미하며, Operator는 전원 상태 및 하드웨어 인벤토리 검사만 관리해야 합니다. Image 필드가 입력되면 이 필드는 무시됩니다.

펌웨어

object

베어 메탈 서버에 대한 BIOS 구성

hardwareProfile

string

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

image

object

이미지에는 프로비저닝할 이미지의 세부 정보가 있습니다.

metaData

object

메타데이터에는 구성 드라이브에 전달되는 호스트 메타데이터(예: meta_data.json)가 포함된 보안에 대한 참조가 있습니다.

networkData

object

networkData는 구성 드라이브에 전달되는 네트워크 구성(예: network_data.json의 콘텐츠)을 포함하는 보안에 대한 참조를 보유합니다.

온라인

boolean

서버가 온라인 상태여야 합니까?

preprovisioningNetworkDataName

string

PreprovisioningNetworkDataName은 사전 프로비저닝 이미지로 전달되는 네트워크 구성(예: 사전 프로비저닝 이미지에 전달되는 network_data.json의 콘텐츠)과 NetworkData를 지정하여 재정의하지 않는 경우 구성 드라이브에 있는 로컬 네임스페이스의 시크릿 이름입니다.

RAID

object

베어 메탈 서버에 대한 RAID 구성

rootDeviceHints

object

프로비저닝 중인 이미지의 장치를 선택하는 방법에 대한 지침을 제공합니다.

테인트

array

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

taints[]

object

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

userData

object

userdata는 부팅하기 전에 호스트에 전달할 사용자 데이터가 포함된 Secret에 대한 참조를 보유합니다.

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가 있는 컨테이너를 참조하는 경우). 이 구문은 오브젝트의 일부를 참조하는 잘 정의된 방법을 사용하는 경우에만 선택됩니다. TODO: 이 설계는 최종적이지 않으며 이 필드는 향후 변경될 수 있습니다.

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

단일 물리적 프로세서 코어를 여러 논리 프로세서로 표시할 수 있습니다. 이는 다음 옵션을 지원합니다: true, false.

sriovEnabled

boolean

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

virtualizationEnabled

boolean

플랫폼 하드웨어의 가상화 지원. 이는 다음 옵션을 지원합니다: true, false.

checksum

string

체크섬은 이미지의 체크섬입니다.

checksumType

string

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

형식

string

DiskFormat에는 이미지 형식(raw, qcow2, …​)이 포함되어 있습니다. 원시 이미지 스트리밍을 위해 raw로 설정해야 합니다. 참고 Live-iso는 url에서 참조하는 iso가 라이브 부팅되고 디스크에 배포되지 않으며 이 경우 체크섬 옵션이 필요하지 않으며 지정된 경우 무시됩니다.

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

호스트에 있는 하드웨어입니다.

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

storage

array

storage[]

object

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

systemVendor

object

HardwareSystemVendor는 전체 하드웨어 시스템에 대한 세부 정보를 저장합니다.

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

VLAN

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

manufacturer

string

productName

string

serialNumber

string

프로비저닝 해제

object

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

inspect

object

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

프로비저닝

object

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

등록

object

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

end

``

start

``

end

``

start

``

end

``

start

``

end

``

start

``

ID

string

기본 프로비저닝 툴의 시스템의 UUID

bootMode

string

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

customDeploy

object

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

펌웨어

object

사용자가 설정한 BIOS

image

object

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

RAID

object

사용자가 설정한 Raid

rootDeviceHints

object

사용자가 설정한 RootDevicehints

상태

string

프로비저너가 호스트로 무엇을 하는지에 대한 지표입니다.

method

string

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

simultaneousMultithreadingEnabled

boolean

단일 물리적 프로세서 코어를 여러 논리 프로세서로 표시할 수 있습니다. 이는 다음 옵션을 지원합니다: true, false.

sriovEnabled

boolean

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

virtualizationEnabled

boolean

플랫폼 하드웨어의 가상화 지원. 이는 다음 옵션을 지원합니다: true, false.

checksum

string

체크섬은 이미지의 체크섬입니다.

checksumType

string

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

형식

string

DiskFormat에는 이미지 형식(raw, qcow2, …​)이 포함되어 있습니다. 원시 이미지 스트리밍을 위해 raw로 설정해야 합니다. 참고 Live-iso는 url에서 참조하는 iso가 라이브 부팅되고 디스크에 배포되지 않으며 이 경우 체크섬 옵션이 필요하지 않으며 지정된 경우 무시됩니다.

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

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