Prerequisites
Learn about the prerequisites for installing OpenShift Container Platform using either the Assisted Installer or the Agent-based Installer,
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 an OCI instance for your cluster, refer to Red Hat Enterprise Linux (RHEL) certified shapes, instance types, to identify the supported OCI VM and bare metal shapes. See Cloud instance types on the Red Hat Ecosystem Catalog portal for details.
Configuration Files
From the OpenShift on OCI Releases page on GitHub, select the link for the latest release. For example, for release v1.0.0, select the link for "v1.0.0". Then, find Assets section of the page and download the create-cluster-vX.X.X.zip file. This file contains the terraform required for provisioning the infrastructure for the cluster and all the required manifests.
The create-cluster-vX.X.X.zip file includes:
- Custom Manifests: The manifest files needed for the installation of Red Hat OpenShift clusters on OCI. For more information about each manifest and when to use them, see Custom Manifests.
- Terraform Stacks: The Terraform stack code for provisioning OCI resources to create and manage OpenShift clusters on OCI. For more information, see Terraform Defined Resources for OpenShift.Note
To make any edits to the manifests, you can clone the entire oracle-quickstart / oci-openshift repository and access thecustom_manifestsandterraform-stacksdirectories directly.