1
0
mirror of https://github.com/openshift/openshift-docs.git synced 2026-02-05 12:46:18 +01:00
Files
openshift-docs/modules/installation-machine-requirements.adoc
2024-12-20 20:04:49 +00:00

111 lines
4.2 KiB
Plaintext

// Module included in the following assemblies:
//
// * installing/installing_aws/installing-aws-user-infra.adoc
// * installing/installing_aws/installing-restricted-networks-aws.adoc
// * installing/installing_azure/installing-azure-user-infra.adoc
// * installing/installing_bare_metal/upi/installing-bare-metal.adoc
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
// * installing/installing_gcp/installing-gcp-user-infra.adoc
// * installing/installing_gcp/installing-gcp-user-infra-vpc.adoc
// * installing/installing_gcp/installing-restricted-networks-gcp.adoc
// * installing/installing_platform_agnostic/installing-platform-agnostic.adoc
// * installing/installing_ibm_power/installing-ibm-power.adoc
// * installing/installing_ibm_power/installing-restricted-networks-ibm-power.adoc
// * installing/installing_ibm_z/installing-ibm-z-reqs.adoc
// * installing/installing_azure/installing-restricted-networks-azure-user-provisioned.adoc
// * installing/installing_vsphere/upi/upi-vsphere-installation-reqs.adoc
ifeval::["{context}" == "installing-bare-metal"]
:bare-metal:
endif::[]
ifeval::["{context}" == "installing-bare-metal-network-customizations"]
:bare-metal:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:bare-metal:
endif::[]
ifeval::["{context}" == "installing-ibm-z-reqs"]
:ibm-z:
endif::[]
ifeval::["{context}" == "installing-ibm-power"]
:ibm-power:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
:ibm-power:
endif::[]
:_mod-docs-content-type: REFERENCE
[id="installation-machine-requirements_{context}"]
= Required machines for cluster installation
The smallest {product-title} clusters require the following hosts:
.Minimum required hosts
[options="header"]
|===
|Hosts |Description
|One temporary bootstrap machine
|The cluster requires the bootstrap machine to deploy the {product-title} cluster
on the three control plane machines. You can remove the bootstrap machine after
you install the cluster.
|Three control plane machines
|The control plane machines run the Kubernetes and {product-title} services that form the control plane.
|At least two compute machines, which are also known as worker machines.
|The workloads requested by {product-title} users run on the compute machines.
|===
ifdef::bare-metal[]
[NOTE]
====
As an exception, you can run zero compute machines in a bare metal cluster that consists of three control plane machines only. This provides smaller, more resource efficient clusters for cluster administrators and developers to use for testing, development, and production. Running one compute machine is not supported.
====
endif::bare-metal[]
[IMPORTANT]
====
ifdef::ibm-z[]
To improve high availability of your cluster, distribute the control plane machines over different hypervisor instances on at least two physical machines.
endif::ibm-z[]
ifndef::ibm-z[]
To maintain high availability of your cluster, use separate physical hosts for
these cluster machines.
endif::ibm-z[]
====
ifndef::ibm-z,ibm-power[]
The bootstrap and control plane machines must use {op-system-first} as the operating system. However, the compute machines can choose between {op-system-first}, {op-system-base-full} 8.6 and later.
endif::ibm-z,ibm-power[]
ifdef::ibm-z,ibm-power[]
The bootstrap, control plane, and compute machines must use {op-system-first} as the operating system.
endif::ibm-z,ibm-power[]
ifndef::openshift-origin[]
Note that {op-system} is based on {op-system-base-full} 9.2 and inherits all of its hardware certifications and requirements.
endif::[]
See link:https://access.redhat.com/articles/rhel-limits[Red Hat Enterprise Linux technology capabilities and limits].
ifeval::["{context}" == "installing-bare-metal"]
:!bare-metal:
endif::[]
ifeval::["{context}" == "installing-bare-metal-network-customizations"]
:!bare-metal:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
:!bare-metal:
endif::[]
ifeval::["{context}" == "installing-ibm-z-reqs"]
:!ibm-z:
endif::[]
ifeval::["{context}" == "installing-ibm-power"]
:!ibm-power:
endif::[]
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
:!ibm-power:
endif::[]