1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/cluster-bare-metal-operator.adoc

66 lines
2.4 KiB
Plaintext

// Module included in the following assemblies:
//
// * operators/operator-reference.adoc
// * installing/overview/cluster-capabilities.adoc
ifeval::["{context}" == "operator-reference"]
:operator-ref:
endif::[]
ifeval::["{context}" == "cluster-capabilities"]
:cluster-caps:
endif::[]
:_mod-docs-content-type: REFERENCE
[id="cluster-bare-metal-operator_{context}"]
ifdef::operator-ref[= Cluster Baremetal Operator]
ifdef::cluster-caps[= Bare-metal capability]
ifdef::operator-ref[]
[NOTE]
====
The Cluster Baremetal Operator is an optional cluster capability that can be disabled by cluster administrators during installation. For more information about optional cluster capabilities, see "Cluster capabilities" in _Installing_.
====
endif::operator-ref[]
ifdef::cluster-caps[]
The Cluster Baremetal Operator provides the features for the `baremetal` capability.
endif::cluster-caps[]
The Cluster Baremetal Operator (CBO) deploys all the components necessary to take a bare-metal server to a fully functioning worker node ready to run {product-title} compute nodes. The CBO ensures that the metal3 deployment, which consists of the Bare Metal Operator (BMO) and Ironic containers, runs on one of the control plane nodes within the {product-title} cluster. The CBO also listens for {product-title} updates to resources that it watches and takes appropriate action.
ifdef::cluster-caps[]
The bare-metal capability is required for deployments using installer-provisioned infrastructure. Disabling the bare-metal capability can result in unexpected problems with these deployments.
[IMPORTANT]
====
If the bare-metal capability is disabled, the cluster cannot provision or manage bare-metal nodes. Only disable the capability if there are no `BareMetalHost` resources in your deployment. The `baremetal` capability depends on the `MachineAPI` capability. If you enable the `baremetal` capability, you must also enable `MachineAPI`.
====
[NOTE]
====
It is recommended that cluster administrators only disable the bare-metal capability during installations with user-provisioned infrastructure that do not have any `BareMetalHost` resources in the cluster.
====
endif::cluster-caps[]
ifdef::operator-ref[]
== Project
link:https://github.com/openshift/cluster-baremetal-operator[cluster-baremetal-operator]
endif::operator-ref[]
ifeval::["{context}" == "operator-reference"]
:!operator-ref:
endif::[]
ifeval::["{context}" == "cluster-caps"]
:!cluster-caps:
endif::[]