Skip to content

openshift-cluster-add-nodes

A blueprint for adding or removing nodes in the OpenShift cluster

This blueprint manages the lifecycle of nodes in the OpenShift cluster by provisioning new nodes and decommissioning removed nodes based on pool status and parameters.

Behavior

The blueprint operates on machines in the cluster's pool based on their status:

Adding Nodes

  • Machines with openshift/role parameter and Free pool status will be provisioned
  • Nodes can be assigned role controlplane or worker

Removing Nodes

  • Machines without openshift/role parameter and Allocated pool status will be decommissioned
  • Nodes are cordoned, drained, and deleted from the cluster
  • Machines are released back to the pool
  • Note: Removing control plane nodes is not officially supported and may cause cluster instability

Requirements

Access Requirements

  • Cluster admin privileges
  • Valid kubeconfig

Cluster State

  • Operational API server
  • Healthy etcd cluster

Usage

To Add Nodes

  1. Add machines to the cluster's pool
  2. Set the openshift/role parameter (controlplane or worker). The openshift-controlplane and openshift-worker profiles can be used to set this parameter.
  3. Run this blueprint
  4. Nodes will be provisioned and joined to the cluster

To Remove Nodes

  1. Verify you are not removing a controlplane node as this is not supported
  2. Remove the openshift/role parameter from the machine
  3. Run this blueprint
  4. Nodes will be gracefully removed from the cluster
  5. Machines will be freed back to the pool

Select this blueprint from the cluster management menu when you need to add or remove nodes.

Objects that Reference openshift-cluster-add-nodes

Not used in current content packs

Objects used by openshift-cluster-add-nodes