TODO: Consider splitting into arch and ops docs.

OpenShift IPI¶

The OpenShift Installer Provisioned Infrastructure (IPI) aims to use the Red Hat installer methods as closely as possible to maintain Red Hat Support and Operation consistency in face of their reference architectures.

Note

This currently uses the Ironic system to virtual media mount isos post initial cluster installation.

Note

The initial cluster is built using PXE-based agent-based installation. This allows for using the more common DRP patterns for initial cluster deployment.

OpenShift Cluster Operations¶

Prerequisties¶

Internet access or replicated registries
Build OpenShift Installer Tool ISO
Define Networking and other parameters
- Required: service networks, machine networks, and cluster networks.
- Required: API and Ingress VIPs from within the Machine Networks
Get your Pull Secret

Setup Resources¶

Create Pool
Add machines to pool
Mark machines for role (controlplane, worker, resource)
- Could be done by classifier / discovery task injection
Set up networking for machines
- Could be done by classifier / discovery task injection

Building Initial Cluster¶

Create Cluster

Context: oc-cluster
Meta:
  BaseContext: oc-cluster
  color: black
  icon: boxes
  machine-role: cluster
Name: cluster-ipi
Workflow: universal-start
Params:
  broker/name: pool-broker
  openshift/api-vip: 10.111.1.55
  openshift/cluster-domain: os.eng.rackn.dev
  openshift/ingress-vip: 10.111.1.56
  openshift/network/clusterNetwork:
    - hostPrefix: 23
      cidr: 172.21.0.0/16
  openshift/network/serviceNetwork:
    - 172.22.0.0/16
  openshift/network/machineNetwork:
    - cidr: 10.111.0.0/20
  openshift/pull-secret: <pull-secret!!>
Profiles:
  - universal-application-openshift-ipi-cluster
  - <openshift-version-tools-profile>

Add Resources to Cluster¶

Add machines to pool
Make machines as resource
Run blueprint on cluster

Destroying Cluster¶

Destroy cluster

Returns machines to unallocated pool state.