Skip to content

openshift/role

OpenShift cluster agent configuration path

OpenShift Node Role

This parameter defines the role a node will play in the OpenShift cluster. Each role has specific responsibilities and requirements within the cluster architecture.

Requirements

  • Must be one of the defined role values
  • Role assignment must align with hardware requirements
  • Node count must meet minimum requirements for role type

Usage

Available roles:

bootstrap     # Temporary node that initializes the cluster
controlplane  # Control plane node running cluster control services
worker        # Worker node running application workloads
load-balancer # HAProxy load balancer for cluster traffic
resource      # A node that is reserved for use by the built cluster (IPI-Only)

Role requirements: - bootstrap: One node only, temporary (UPI-Only) - controlplane: Three nodes recommended for HA - worker: Minimum one node, scale as needed - load-balancer: Minimum one node, multiple for HA (UPI-Only) - resource: A node that is reserved for use by the built cluster (IPI-Only)

Notes: - Bootstrap node is automatically converted to worker after cluster initialization (UPI-Only) - Control plane nodes should be identical in specifications - Worker nodes can have varying specifications based on workload needs - Load balancers should be placed for optimal network connectivity (UPI-Only) - Resource nodes are used for additional capacity in IPI clusters