Oracle Cloud Infrastructure Documentation

Agent-based Installer for OpenShift Container Platform

Learn about using Red Hat's Agent-based Installer to provision OpenShift Container Platform on OCI.

The Agent-based Installer is provided for advanced users who need customized infrastructure configurations, and for users working in disconnected environments. Installing a cluster using this method requires prior knowledge OCI infrastructure services including Networking, Load Balancer, DNS, Compute, Object Storage, IAM and Tagging. Expect the agent-based installer to take more time than the Assisted Installer.

Provisioning Resources for the Agent-based Installer

For the OCI resources required by the OpenShift cluster (for example, the Compute instances, VCN, load balancers, and other infrastructure), you can provision these resources with an OCI-provided Terraform script, using the OCI Resource Manager service, or you provision the resources manually. If you're in a disconnected environment, or you need to configure a firewall or do other advanced configuration, you must provision resources manually.

Note

To run OpenShift, the application requires manage permissions to perform CRUD operations on Instances, Volumes, and Networking resources. We recommend that customers deploy OpenShift in a dedicated compartment to avoid potential conflicts with other applications that may be running in the same compartment.

Option 1: Using Terraform to Provision Resources

OCI provides a Terraform script for provisioning new compute nodes, which is available in the OpenShift on OCI Releases page on GitHub. Navigate to this page and select the link for the latest release (for example, for release v1.0.0, select the link for "v1.0.0"). From the Assets section, download the create-cluster-vX.X.X.zip file.

Important

  • Ensure to run the create-resource-attribution-tags stack before running the create-cluster stack to avoid cluster installation failure. See the Prerequisites topic for more information.
  • The create-resource-attribution-tags stack only needs to be run once. If the tag namespace and defined-tags are already created, you can directly proceed with cluster installation.
  • To run OpenShift, the application requires manage permissions to perform CRUD operations on Instances, Volumes, and Networking resources. We recommend that customers deploy OpenShift in a dedicated compartment to avoid potential conflicts with other applications that might be running in the same compartment.