Search
SupportConsoleDevelopersStart a trialContact

Chapter 15. Optional: Installing on Oracle Cloud Infrastructure (OCI)

download PDF

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.

Important

For OpenShift Container Platform 4.14 and 4.15, the OCI integration is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see Technology Preview Features - Scope of Support.

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

  1. Log in to the Red Hat Hybrid Cloud Console.
  2. Click Create cluster.
  3. On the Cluster type page, click the Datacenter tab.
  4. In the Assisted Installer section, click Create cluster.

  5. On the Cluster Details page, complete the following fields:

    1. In the Cluster name field, specify the name of your cluster, such as ocidemo.
    2. 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.
    3. In the OpenShift version field, specify OpenShift 4.15 or a later version.
    4. In the CPU architecture field, specify x86_64 or Arm64.
    5. From the Integrate with external partner platforms list, select Oracle Cloud Infrastructure. The Include custom manifests checkbox is automatically selected.
  6. Click Next.
  7. On the Operators page, click Next.

  8. On the Host Discovery page, perform the following actions:

    1. Click Add host to display a dialog box.
    2. 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.
    3. Click Generate Discovery ISO to generate the discovery image ISO file.
    4. 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

  1. From the Red Hat Hybrid Cloud Console, go to the Host discovery page.
  2. Under the Role column, assign a node role, either Control plane node or Worker, for each targeted hostname. Click Next.
  3. Accept the default settings for the Storage and Networking pages.
  4. Click Next to go to the Custom manifests page.
  5. In the Folder field, select manifests.
  6. In the File name field, enter a value such as oci-ccm.yml.
  7. In the Content section, click Browse. Select the CCM manifest located in custom_ manifest/manifests/oci-ccm.yml.

  8. 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.
  9. Complete the Review and create step to create your OpenShift Container Platform cluster on OCI.
  10. Click Install cluster to finalize the cluster installation.
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.