openshift-docs/hosted_control_planes/hcp-deploy/hcp-deploy-bm.adoc

:_mod-docs-content-type: ASSEMBLY
[id="hcp-deploy-bm"]
include::_attributes/common-attributes.adoc[]
= Deploying {hcp} on bare metal
:context: hcp-deploy-bm

toc::[]

You can deploy {hcp} by configuring a cluster to function as a management cluster. The management cluster is the {product-title} cluster where the control planes are hosted. In some contexts, the management cluster is also known as the _hosting_ cluster.

[NOTE]
====
The management cluster is not the same thing as the _managed_ cluster. A managed cluster is a cluster that the hub cluster manages.
====

The {hcp} feature is enabled by default.

The {mce-short} supports only the default `local-cluster`, which is a hub cluster that is managed, and the hub cluster as the management cluster. If you have Red{nbsp}Hat Advanced Cluster Management installed, you can use the managed hub cluster, also known as the `local-cluster`, as the management cluster.

A _hosted cluster_ is an {product-title} cluster with its API endpoint and control plane that are hosted on the management cluster. The hosted cluster includes the control plane and its corresponding data plane. You can use the {mce-short} console or the hosted control plane command-line interface (`hcp`) to create a hosted cluster.

The hosted cluster is automatically imported as a managed cluster. If you want to disable this automatic import feature, see "Disabling the automatic import of hosted clusters into {mce-short}".

include::modules/hcp-bm-prepare.adoc[leveloffset=+1]

include::modules/hcp-bm-prereqs.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#advanced-config-engine[Advanced configuration]
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#enable-cim[Enabling the central infrastructure management service]

include::modules/hcp-bm-firewall-port-svc-reqs.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../networking/configuring_network_settings/enable-cluster-wide-proxy.adoc#enable-cluster-wide-proxy[Configuring the cluster-wide proxy]

include::modules/hcp-bm-infra-reqs.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../etcd/etcd-practices.adoc#recommended-etcd-practices[Recommended etcd practices]
* xref:../../storage/persistent_storage_local/persistent-storage-using-lvms.adoc[Persistent storage using {lvms}]
* xref:../../hosted_control_planes/hcp-import.adoc#hcp-import-disable_hcp-import[Disabling the automatic import of hosted clusters into {mce-short}]
* xref:../../hosted_control_planes/hcp-prepare/hcp-enable-disable.adoc[Enabling or disabling the {hcp} feature]
* link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#ansible-config-hosted-cluster[Configuring Ansible Automation Platform jobs to run on hosted clusters]

include::modules/hcp-bm-dns.adoc[leveloffset=+1]

include::modules/hcp-custom-dns.adoc[leveloffset=+2]

[id="hcp-bm-create-infra_{context}"]
== Creating an InfraEnv resource

Before you can create a hosted cluster on bare metal, you need an `InfraEnv` resource.

include::modules/hcp-bm-add-nodes-to-inventory.adoc[leveloffset=+2]

include::modules/hcp-bm-create-infra-console.adoc[leveloffset=+2]


[role="_additional-resources"]
[id="addl-res-hcp-bm-infra-console_{context}"]
=== Additional resources

* xref:../../web_console/web-console.adoc#web-console-overview[Accessing the web console]

[id="hcp-bm-create-hc_{context}"]
== Creating a hosted cluster on bare metal

You can create a hosted cluster or import one. When the Assisted Installer is enabled as an add-on to {mce-short} and you create a hosted cluster with the Agent platform, the HyperShift Operator installs the Agent Cluster API provider in the hosted control plane namespace. 

include::modules/hcp-bm-hc.adoc[leveloffset=+2]

[role="_additional-resources"]
.Additional resources

* xref:../../hosted_control_planes/hcp-import.adoc[Manually importing a hosted cluster]
* xref:../../hosted_control_planes/hcp-disconnected/hcp-deploy-dc-bm.adoc#hcp-dc-extract_hcp-deploy-dc-bm[Extracting the release image digest]

include::modules/hcp-bm-hc-console.adoc[leveloffset=+2]

.Next steps

* To access the web console, see xref:../../web_console/web-console.adoc#web-console-overview[Accessing the web console].

include::modules/hcp-bm-hc-mirror.adoc[leveloffset=+2]

.Next steps

* To create credentials that you can reuse when you create a hosted cluster with the console, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#creating-a-credential-for-an-on-premises-environment[Creating a credential for an on-premises environment].
* To access a hosted cluster, see xref:../../hosted_control_planes/hcp-manage/hcp-manage-bm.adoc#hcp-bm-access_hcp-manage-bm[Accessing the hosted cluster].
* To add hosts to the host inventory by using the Discovery Image, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#add-host-host-inventory[Adding hosts to the host inventory by using the Discovery Image].
* To extract the {product-title} release image digest, see link:https://docs.redhat.com/en/documentation/red_hat_advanced_cluster_management_for_kubernetes/2.14/html/clusters/cluster_mce_overview#configure-hosted-disconnected-digest-image[Extracting the {product-title} release image digest].

include::modules/hcp-bm-verify.adoc[leveloffset=+1]

include::modules/hcp-custom-cert.adoc[leveloffset=+1]