Skip to content

openshift-cluster-prep

A task to remove Advanced Cluster Management (ACM) from an OpenShift cluster

OpenShift Cluster Preparation Task

This task prepares the initial configuration required for OpenShift cluster deployment. It generates the install-config.yaml and sets up essential cluster parameters including networking, SSH keys, and registry configurations.

Requirements

Parameters

  • openshift/pull-secret: Red Hat registry authentication credentials
  • openshift/cluster-domain: Base domain for cluster DNS
  • openshift/ssh-key-pub: Public SSH key for node access
  • openshift/network/machineNetwork: Node IP address ranges
  • openshift/network/clusterNetwork: Pod network configuration
  • openshift/network/serviceNetwork: Service IP ranges

Infrastructure

  • Network ranges must not overlap
  • DNS delegation configured for cluster domain
  • Sufficient IP addresses available
  • Valid pull secret from Red Hat

Usage

Basic Setup

# Apply preparation task
drpcli machines tasks add <machine-uuid> openshift-cluster-prep

# Verify configuration
cat /root/cluster/install-config.yaml

Configuration Process

  1. Generates SSH key pair if not exists
  2. Creates install-config.yaml with:
  3. Network configurations
  4. Node counts and roles
  5. Pull secret
  6. SSH key
  7. Registry settings
  8. Stores configuration in cluster profile