第3章 BareMetalHost [metal3.io/v1alpha1]

automatedCleaningMode

string

無効に設定すると、プロビジョニングおよびプロビジョニング解除中に自動クリーニングが回避されます。

bmc

object

BMC に接続するにはどうすればよいですか ?

bootMACAddress

string

PXE はどの MAC アドレスで起動しますか ?これは一部のタイプではオプションですが、vbmc によって駆動される libvirtVM では必須です。

bootMode

string

起動時にハードウェアを初期化する方法を選択します。デフォルトは UEFI です。

consumerRef

object

ConsumerRef は、ホストを使用しているものに関する情報を格納するために使用できます。空でない場合、ホストは使用中と見なされます。

customDeploy

object

カスタムデプロイ手順。

description

string

説明は、ホストを識別するために使用される人間が入力したテキストです

externallyProvisioned

ブール値

ExternallyProvisioned は、他の何かがホスト上で実行されているイメージを管理していることを意味し、Operator は電源ステータスとハードウェアインベントリー検査のみを管理する必要があります。イメージフィールドに入力すると、このフィールドは無視されます。

firmware

object

ベアメタルサーバーの BIOS 設定

hardwareProfile

string

このホストのハードウェアプロファイルの名前は何ですか ?これを設定する必要があるのは、検査でプロファイルを自動的に判別できない場合のみです。

image

object

イメージは、プロビジョニングされるイメージの詳細を保持します。

metaData

object

メタデータは、コンフィグドライブに渡されるホストメタデータ(meta_data.json など)を含むシークレットへの参照を保持します。

networkData

object

networkData は、コンフィグドライブに渡されるネットワーク設定(network_data.json のコンテンツなど)を含むシークレットへの参照を保持します。

online

ブール値

サーバーはオンラインである必要がありますか ?

preprovisioningNetworkDataName

string

preprovisioningNetworkDataName は、事前プロビジョニングイメージに渡されるローカル namespace の Secret の名前です（例：network_data.json のコンテンツ）。また、NetworkData を指定して上書きされていない場合は Config Drive に渡されます。

raid

object

ベアメタルサーバーの RAID 設定

rootDeviceHints

object

プロビジョニングするイメージのデバイスを選択する方法についてのガイダンスを提供します。

taints

array

テイントは、対応するマシンに適用するテイントの完全で信頼できるリストです。このリストは、継続的にマシンに加えられた変更を上書きします。

taints[]

object

このテイントが接続されているノードは、テイントを許容しない Pod に影響を及ぼします。

userData

object

UserData は、ホストが起動する前にホストに渡されるユーザーデータを含むシークレットへの参照を保持します。

address

string

アドレスは、ネットワーク上のコントローラーにアクセスするための URL を保持します。

credentialsName

string

BMC クレデンシャルを含むシークレットの名前 (キー username および password が必要)。

disableCertificateVerification

ブール値

DisableCertificateVerification は、HTTPS を使用して BMC に接続するときに、サーバー証明書の検証を無効にします。これは、サーバー証明書が自己署名されている場合に必要ですが、中間者が接続を傍受できるため、安全ではありません。

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

namespace

string

参照先の namespace。詳細: 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

カスタムデプロイメソッド名。この名前は、使用されるデプロイ RAM ディスクに固有です。カスタムデプロイ RAM ディスクがない場合は、CustomDeploy を使用しないでください。

simultaneousMultithreadingEnabled

ブール値

単一の物理プロセッサーコアを複数の論理プロセッサーとして表示できるようにします。これは、次のオプションをサポートします:true、false。

sriovEnabled

ブール値

SR-IOV のサポートにより、ハイパーバイザーは PCI-express デバイスの仮想インスタンスを作成することができ、潜在的に性能を向上させることができます。これは、次のオプションをサポートします:true、false。

virtualizationEnabled

ブール値

プラットフォームハードウェアの仮想化をサポートします。これは、次のオプションをサポートします:true、false。

checksum

string

チェックサムは、イメージのチェックサムです。

checksumType

string

ChecksumType は、イメージのチェックサムアルゴリズムです。例:md5、sha256、sha512

format

string

DiskFormat には、イメージのフォーマット (raw、qcow2、…) が含まれています。生のイメージをストリーミングするには、raw に設定する必要があります。live-iso は、URL によって参照される iso がライブブートされ、ディスクにデプロイされないことを意味します。この場合、チェックサムオプションは不要であり、指定されている場合は無視されます。

url

string

URL は、デプロイするイメージの場所です。

name

string

名前は、namespace 内で一意であり、シークレットのリソースを参照します。

namespace

string

namespace は、シークレットの名前が一意でなければならないスペースを定義します。

name

string

名前は、namespace 内で一意であり、シークレットのリソースを参照します。

namespace

string

namespace は、シークレットの名前が一意でなければならないスペースを定義します。

hardwareRAIDVolumes

``

ハードウェア RAID の論理ディスクのリスト。rootDeviceHints が使用されていない場合、最初のボリュームはルートボリュームです。このフィールドの値を [] に設定して、すべてのハードウェア RAID 設定をクリアできます。

softwareRAIDVolumes

``

ソフトウェア RAID の論理ディスクのリスト。rootDeviceHints が使用されていない場合、最初のボリュームはルートボリュームです。HardwareRAIDVolumes が設定されている場合、この項目は無効になります。作成されるソフトウェア RAID デバイスの数は、1 または 2 である必要があります。ソフトウェア RAID デバイスが 1 つしかない場合は、RAID-1 である必要があります。2 つある場合、最初の 1 つは RAID-1 である必要があり、2 番目の RAID レベルは 0、1、または 1+0 にすることができます。最初の RAID デバイスがデプロイメントデバイスになるため、RAID-1 を適用すると、ディスク障害が発生した場合にノードが起動しない状態になるリスクが軽減されます。ソフトウェア RAID は常に削除されます。

deviceName

string

/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

デバイスの最小サイズ (ギガバイト単位)。

model

string

ベンダー固有のデバイス識別子。ヒントは、実際の値のサブ文字列になります。

rotational

ブール値

デバイスが回転メディアを使用する必要がある場合は true、それ以外の場合は false。

serialNumber

string

デバイスのシリアル番号。ヒントは、実際の値と完全に一致する必要があります。

ベンダー

string

デバイスのベンダーまたはメーカーの名前。ヒントは、実際の値のサブ文字列になります。

wwn

string

一意のストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

wwnVendorExtension

string

一意のベンダーストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

wwnWithExtension

string

ベンダーエクステンションを追加した一意のストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

effect

string

必須。テイントを許容しない Pod に対するテイントの影響。有効な効果は、NoSchedule、PreferNoSchedule、および NoExecute です。

key

string

必須。ノードに適用されるテイントキー。

timeAdded

string

TimeAdded は、テイントが追加された時刻を表します。NoExecute テイントのためにのみ書かれています。

value

string

テイントキーに対応するテイント値。

name

string

名前は、namespace 内で一意であり、シークレットのリソースを参照します。

namespace

string

namespace は、シークレットの名前が一意でなければならないスペースを定義します。

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

ブール値

ホストの電源がオンになっているかどうかのインジケーター

provisioning

object

プロビジョニング担当者が追跡する情報。

triedCredentials

object

プロビジョニングバックエンドに送信した最後のクレデンシャル

credentials

object

SecretReference は、シークレットリファレンスを表します。任意の名前空間でシークレットを取得するのに十分な情報があります

credentialsVersion

string

name

string

名前は、namespace 内で一意であり、シークレットのリソースを参照します。

namespace

string

namespace は、シークレットの名前が一意でなければならないスペースを定義します。

cpu

object

CPU は、ホスト上の 1 つのプロセッサーを表します。

firmware

object

ファームウェアは、ホスト上のファームウェアを表します。

hostname

string

nics

array

nics[]

object

NIC は、ホスト上の 1 つのネットワークインターフェイスを記述します。

ramMebibytes

integer

storage

array

storage[]

object

ストレージは、ホスト上の 1 つのストレージデバイス (ディスク、SSD など) を表します。

systemVendor

object

HardwareSystemVendor は、ハードウェアシステム全体に関する詳細を格納します。

arch

string

clockMegahertz

number

ClockSpeed は MHz 単位のクロック速度です

count

integer

flags

array (string)

model

string

bios

object

このファームウェアの BIOS

date

string

この BIOS のリリース/ビルド日

ベンダー

string

この BIOS のベンダー名

version

string

BIOS のバージョン

ip

string

インターフェイスの IP アドレス。存在する場合、これは IPv4 または IPv6 アドレスになります。IPv4 アドレスと IPv6 アドレスの両方がデュアルスタック環境に存在する場合、各 IP に 1 つずつ、合計 2 つの NIC が出力されます。

mac

string

デバイスの MAC アドレス

model

string

NIC のベンダー ID と製品 ID、例:"0x8086 0x1572"

name

string

ネットワークインターフェイスの名前 (例:en0)

pxe

ブール値

NIC が PXE ブータブルかどうか

speedGbps

integer

デバイスの速度 (ギガビット/秒)

vlanId

integer

タグなし VLANID

vlans

array

利用可能な VLAN

vlans[]

object

VLAN は、VLAN の名前と ID を表します

id

integer

VLANID は、12 ビットの 802.1QVLAN 識別子です。

name

string

hctl

string

デバイスの SCSI ロケーション

model

string

ハードウェアモデル

name

string

ディスクの Linux デバイス名 (例:/dev/sda)。これは再起動後も安定しない可能性があることに注意してください。

rotational

ブール値

このディスクが回転ストレージを表すかどうか。このフィールドの使用は推奨されていません。代わりにタイプフィールドを使用することを推奨します。このフィールドは最終的に非推奨になります。

serialNumber

string

デバイスのシリアル番号

sizeBytes

integer

ディスクのサイズ (バイト単位)

type

string

デバイスタイプ、HDD、SSD、NVME のいずれか。

ベンダー

string

デバイスのベンダーの名前

wwn

string

デバイスの WWN

wwnVendorExtension

string

デバイスの WWN ベンダー拡張

wwnWithExtension

string

拡張子が付いた WWN

manufacturer

string

productName

string

serialNumber

string

deprovision (プロビジョニング解除)

object

OperationMetric には、メトリックの追跡に使用される操作 (検査、プロビジョニングなど) に関するメタデータが含まれています。

inspect

object

OperationMetric には、メトリックの追跡に使用される操作 (検査、プロビジョニングなど) に関するメタデータが含まれています。

provision (プロビジョニング)

object

OperationMetric には、メトリックの追跡に使用される操作 (検査、プロビジョニングなど) に関するメタデータが含まれています。

register

object

OperationMetric には、メトリックの追跡に使用される操作 (検査、プロビジョニングなど) に関するメタデータが含まれています。

end

``

start

``

end

``

start

``

end

``

start

``

end

``

start

``

ID

string

基盤となるプロビジョニングツールからのマシンの UUID

bootMode

string

BootMode は、ノードのプロビジョニングに使用されるブートモードを示します

customDeploy

object

ホストに適用されるカスタムデプロイ手順。

firmware

object

ユーザーが設定した BIOS

image

object

イメージは、ホストに正常にプロビジョニングされた最後のイメージの詳細を保持します。

raid

object

ユーザーが設定したレイド

rootDeviceHints

object

ユーザーが設定した RootDevicehints

state

string

プロビジョニング担当者がホストに対して行っていることの指標。

method

string

カスタムデプロイメソッド名。この名前は、使用されるデプロイ RAM ディスクに固有です。カスタムデプロイ RAM ディスクがない場合は、CustomDeploy を使用しないでください。

simultaneousMultithreadingEnabled

ブール値

単一の物理プロセッサーコアを複数の論理プロセッサーとして表示できるようにします。これは、次のオプションをサポートします:true、false。

sriovEnabled

ブール値

SR-IOV のサポートにより、ハイパーバイザーは PCI-express デバイスの仮想インスタンスを作成することができ、潜在的に性能を向上させることができます。これは、次のオプションをサポートします:true、false。

virtualizationEnabled

ブール値

プラットフォームハードウェアの仮想化をサポートします。これは、次のオプションをサポートします:true、false。

checksum

string

チェックサムは、イメージのチェックサムです。

checksumType

string

ChecksumType は、イメージのチェックサムアルゴリズムです。例:md5、sha256、sha512

format

string

DiskFormat には、イメージのフォーマット (raw、qcow2、…) が含まれています。生のイメージをストリーミングするには、raw に設定する必要があります。live-iso は、URL によって参照される iso がライブブートされ、ディスクにデプロイされないことを意味します。この場合、チェックサムオプションは不要であり、指定されている場合は無視されます。

url

string

URL は、デプロイするイメージの場所です。

hardwareRAIDVolumes

``

ハードウェア RAID の論理ディスクのリスト。rootDeviceHints が使用されていない場合、最初のボリュームはルートボリュームです。このフィールドの値を [] に設定して、すべてのハードウェア RAID 設定をクリアできます。

softwareRAIDVolumes

``

ソフトウェア RAID の論理ディスクのリスト。rootDeviceHints が使用されていない場合、最初のボリュームはルートボリュームです。HardwareRAIDVolumes が設定されている場合、この項目は無効になります。作成されるソフトウェア RAID デバイスの数は、1 または 2 である必要があります。ソフトウェア RAID デバイスが 1 つしかない場合は、RAID-1 である必要があります。2 つある場合、最初の 1 つは RAID-1 である必要があり、2 番目の RAID レベルは 0、1、または 1+0 にすることができます。最初の RAID デバイスがデプロイメントデバイスになるため、RAID-1 を適用すると、ディスク障害が発生した場合にノードが起動しない状態になるリスクが軽減されます。ソフトウェア RAID は常に削除されます。

deviceName

string

/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

デバイスの最小サイズ (ギガバイト単位)。

model

string

ベンダー固有のデバイス識別子。ヒントは、実際の値のサブ文字列になります。

rotational

ブール値

デバイスが回転メディアを使用する必要がある場合は true、それ以外の場合は false。

serialNumber

string

デバイスのシリアル番号。ヒントは、実際の値と完全に一致する必要があります。

ベンダー

string

デバイスのベンダーまたはメーカーの名前。ヒントは、実際の値のサブ文字列になります。

wwn

string

一意のストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

wwnVendorExtension

string

一意のベンダーストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

wwnWithExtension

string

ベンダーエクステンションを追加した一意のストレージ ID。ヒントは、実際の値と完全に一致する必要があります。

credentials

object

SecretReference は、シークレットリファレンスを表します。任意の名前空間でシークレットを取得するのに十分な情報があります

credentialsVersion

string

name

string

名前は、namespace 内で一意であり、シークレットのリソースを参照します。

namespace

string

namespace は、シークレットの名前が一意でなければならないスペースを定義します。