Workflow for remote nodes

The following document wants to summarize the different events and the tags used by the ztp-cluster-deploy playbooks

Environment preparation

• Playbook: ai-deploy-cluster-remoteworker
• Tag: prepare-environment
• Actions: host preparation. It adds all the dependencies for the process (packages, assisted installer pods, etc…)

Control plane cluster creation

The following steps create a control plane using Assisted Installer, and using libvirt vms as hosts.

Create cluster in assisted installer

• Playbook: ai-deploy-cluster-remoteworker
• Tag: create-cluster
• Actions: adds the cluster entry into assisted installer, with the specific network configuration

Provision virtual machines and enroll into the cluster

• Playbook: ai-deploy-cluster-remoteworker
• Tag: enroll-hosts
• Actions: provision 3 vms to act as masters and enrolls them into assisted installer service

Start OpenShift installation

• Playbook: ai-deploy-cluster-remoteworker
• Tag: deploy-cluster
• Actions: perform the OpenShift installation of the control plane

Expose ports to the outer world

[Optional]

• Playbook: ai-deploy-cluster-remoteworker
• Tag: expose-endpoints
• Actions: exposes the ports for OpenShift api and apps to the outer world. Just needed if you need to test and you don’t have internal access

Enroll cluster into ACM

• Playbook: acm-spoke
• Actions: when run on the spoke cluster, it enrolls the spoke into ACM hub

Add remote workers

The following steps are adding extra workers to an existing control plane, using Assisted Installer

Create cluster into assisted installer

• Playbook: ai-deploy-cluster-remoteworker
• Tag: create-cluster-day2
• Actions: Creates a symbolic cluster in Assisted Installer (named cluster_name-day2), that allows Assisted Installer to add remote workers to that cluster

Generate small ISO to provision remote worker nodes

• Playbook: ai-deploy-cluster-remoteworker
• Tag: modify-iso-day2
• Actions: Extracts the ISO generated by Assisted Installer, and performs the needed actions (strip rootfs, inject kernel arguments, inject network configuration) to produce the small ISO, that will be used for VirtualMedia provisioning

Provision remote workers

• Playbook: ai-deploy-cluster-remoteworker
• Tag: add-remote-workers
• Actions: Using Virtual Media, will provision all the remote workers with the generated small ISO, so the nodes are enrolled into Assisted Installer

Install OpenShift on the workers

• Playbook: ai-deploy-cluster-remoteworker
• Tag: deploy-cluster-day2
• Actions: Performs the openshift installation, so the nodes are added into the existing OpenShift cluster