Chapter 15. Installing on Oracle Cloud Infrastructure (OCI)
From OpenShift Container Platform 4.14 and later versions, you can use the Assisted Installer to install a cluster on Oracle Cloud Infrastructure by using infrastructure that you provide. Oracle Cloud Infrastructure provides services that can meet your needs for regulatory compliance, performance, and cost-effectiveness. You can access OCI Resource Manager configurations to provision and configure OCI resources.
This section is a summary of the steps required in the Assisted Installer web console to support the integration with Oracle Cloud Infrastructure. It does not document the steps to be performed in Oracle Cloud Infrastructure, nor does it cover the integration between the two platforms. For a complete and comprehensive procedure, see Using the Assisted Installer to install a cluster on OCI.
15.1. Generating an OCI-compatible discovery ISO image
Generate the discovery ISO image in Assisted Installer by completing the required steps. You must upload the image to the Oracle Cloud Infrastructure before you install OpenShift Container Platform on Oracle Cloud Infrastructure.
Prerequisites
- You created a child compartment and an object storage bucket on Oracle Cloud Infrastructure. See Creating OCI resources and services in the OpenShift Container Platform documentation.
- You meet the requirements necessary for installing a cluster. For details, see Prerequisites.
Procedure
- Log in to the Red Hat Hybrid Cloud Console.
- Click Create cluster.
- On the Cluster type page, click the Datacenter tab.
- In the Assisted Installer section, click Create cluster.
On the Cluster Details page, complete the following fields:
-
In the Cluster name field, specify the name of your cluster, such as
ocidemo. -
In the Base domain field, specify the base domain of the cluster, such as
splat-oci.devcluster.openshift.com. Take the base domain from OCI after creating a compartment and a zone. - In the OpenShift version field, specify OpenShift 4.15 or a later version.
-
In the CPU architecture field, specify
x86_64orArm64. - From the Integrate with external partner platforms list, select Oracle Cloud Infrastructure. The Include custom manifests checkbox is automatically selected.
-
In the Cluster name field, specify the name of your cluster, such as
- Click Next.
- On the Operators page, click Next.
On the Host Discovery page, perform the following actions:
- Click Add host to display a dialog box.
-
For the SSH public key field, upload a public SSH key from your local system. You can generate an SSH key pair with
ssh-keygen. - Click Generate Discovery ISO to generate the discovery image ISO file.
- Download the file to your local system. You will then upload the file to the bucket in Oracle Cloud Infrastructure as an Object.
15.2. Assigning node roles and custom manifests
After you provision Oracle Cloud Infrastructure (OCI) resources and upload OpenShift Container Platform custom manifest configuration files to OCI, you must complete the remaining cluster installation steps on the Assisted Installer before you can create an instance OCI.
Prerequisites
- You created a resource stack on OCI, and the stack includes the custom manifest configuration files and OCI Resource Manager configuration resources. For details, see Downloading manifest files and deployment resources in the OpenShift Container Platform documentation.
Procedure
- From the Red Hat Hybrid Cloud Console, go to the Host discovery page.
- Under the Role column, assign a node role, either Control plane node or Worker, for each targeted hostname. Click Next.
- Accept the default settings for the Storage and Networking pages.
- Click Next to go to the Custom manifests page.
-
In the Folder field, select
manifests. -
In the File name field, enter a value such as
oci-ccm.yml. -
In the Content section, click Browse. Select the CCM manifest located in
custom_ manifest/manifests/oci-ccm.yml. Click Add another manifest. Repeat the same steps for the following manifests provided by Oracle:
-
CSI driver manifest:
custom_ manifest/manifests/oci-csi.yml. -
CCM machine configuration:
custom_ manifest/openshift/machineconfig-ccm.yml. -
CSI driver machine configuration:
custom_ manifest/openshift/machineconfig-csi.yml.
-
CSI driver manifest:
- Complete the Review and create step to create your OpenShift Container Platform cluster on OCI.
- Click Install cluster to finalize the cluster installation.
