Oracle Cloud Infrastructure Documentation

Agent-based Installer for OpenShift Container Platform

Provision the OpenShift Container Platform on Oracle Cloud Infrastructure (OCI) using Red Hat's Agent-based Installer.

The Agent-based Installer is designed for advanced users who require customized infrastructure configurations or working in disconnected (offline) environments.

Compared to Assisted Installer, this method requires prior knowledge of OCI services, including Networking, Load Balancer, DNS, Compute, Object Storage, IAM and Tagging, and may take longer to complete.

Provisioning Resources for the Agent-based Installer

For Agent-based Installer, you can provision the OCI resources required by the OpenShift cluster in two ways:
  • By using an OCI-provided Terraform script: This method is recommended for users in a connected environment or with less complex cluster configuration requirements. It can also serve as a starting point for later additions and modifications.
    Note

    For fully disconnected (air-gapped) environments, those requiring firewall changes, mirror servers, and internal content or container image repositories, additional manual setup and configuration is required.
  • By manual provisioning: This method is recommended for users who require advanced configurations not yet supported by the Terraform, or if Terraform is unavailable for use in your environment.
Note

OpenShift requires Manage permissions to perform operations on instances, volumes, and networking resources. Deploy OpenShift in a dedicated compartment to avoid conflicts with other applications that might be running in the same compartment.

Option 1: Provisioning Resources Using Terraform

Use the OCI provided Terraform script to automate provisioning of new cluster resources. The latest version of the Terraform stack is available on the Stack information page within the Red Hat OpenShift plugin.

For more information, see Installing a Cluster with Agent-based Installer Using Terraform.