Prerequisites
To install OpenShift Container Platform using either the Assisted Installer or the Agent-based Installer, complete the following prerequisites:
Cloud Accounts and Resources
You need the following accounts for your OpenShift Container Platform cluster installation:
- Red Hat account and access to either the Assisted Installer or the Agent-based Installer.
- OCI account with an Identity Domain and permissions to manage the following resources:
You also need the following resources:
- An internet domain to be used for serving the OpenShift Container Platform console that runs on cluster resources in OCI.
- An SSH key pair to use for the cluster installation.
- The pull secret provided in the Red Hat Hybrid Cloud Console. See Using image pull secrets in the Red Hat documentation for more information.
- Optional: A new compartment created for the cluster resources. You can also use an existing compartment. See Understanding Compartments and Creating a Compartment for more information.
- Optional: An Object Storage bucket created to store the discovery ISO image discussed later in this documentation. You can also use an existing bucket. See Creating an Object Storage Bucket for more information.
Note
- For Agent-based Installer users: If you use a firewall in your OCI environment and you plan to use a Telemetry service, ensure that your firewall is configured to allow OpenShift Container Platform to access the sites required. See Configuring your firewall for OpenShift Container Platform in the Red Hat documentation for details on setting up your firewall's allowlist for OpenShift.
- Before you create a OCI virtual machines (VM) for your cluster, refer to Red Hat Enterprise Linux (RHEL) certified shapes, instance types, to identify the supported OCI VM shapes. See Cloud instance types on the Red Hat Ecosystem Catalog portal for details.
Configuration Files
From the oracle-quickstart / oci-openshift GitHub web page, click the Code button on the right side of the page, and then click Download ZIP. The ZIP archive includes the following:
-
OCI CCM and CSI custom manifests:
Important
You must edit theoci-ccm.ymlandoci-csi.ymlfiles as discussed in the installation instructions in this documentation before you can use them to create a cluster. -
Machine Configuration manifests:
- Terraform example configurations file. For the Assisted Installer, this file is used to provision infrastructure resources in the OCI Resource Manager service. For the Agent-based Installer, use this file as a reference for configuration settings.