Installing Red Hat® OpenShift® Container Platform
IBM Cloud® Paks can be deployed on a wide variety of environments to suit your enterprise's needs. Before you deploy your IBM Cloud Pak though, you must install Red Hat® OpenShift® Container Platform on your environment.
No matter which environment you plan on installing your IBM Cloud Pak to, the steps for installing it are the same, and it all starts with installing Red Hat OpenShift Container Platform in that environment. The following diagram illustrates the three fundamental steps that it takes to install an IBM Cloud Pak:
Red Hat OpenShift Container Platform 4.x clusters are automatically registered to the Red Hat OpenShift Cluster Manager (OCM) after they are created and are subscribed to a limited 60-day Red Hat OpenShift Container Platform evaluation subscription. To convert to the production version of Red Hat OpenShift Container Platform, you must complete the following tasks before you install Red Hat OpenShift Container Platform:
- Access Passport Advantage® and link the production version of Red Hat OpenShift Container Platform to your Red Hat customer account. For more information about linking your entitlement, see Linking Red Hat entitlements from your IBM Cloud Paks.
- Before the 60-day Red Hat OpenShift Container Platform evaluation subscription expires, you must edit the cluster subscription settings in OCM to attach the IBM Cloud Pak production version of your Red Hat OpenShift Container Platform entitlements. For more information about configuring your cluster, see Cloud Pak OpenShift Clusters Using Evaluation Entitlements.
You can install most IBM Cloud Paks only on Extended Update Service (EUS) Red Hat OpenShift Container Platform releases (even-numbered point releases, for example 4.8 and 4.10). In most cases, the latest versions of the IBM Cloud® Paks support the latest two EUS versions of Red Hat OpenShift Container Platform. For more information about EUS versioning, see Red Hat OpenShift Extended Update Support (EUS) Overview. For more information about Red Hat OpenShift Container Platform compatibility per IBM Cloud Pak, see IBM Cloud Pak and Red Hat OpenShift Container Platform compatibility.
IBM Cloud Paks can be deployed on multi-node clusters. For development or proof of concept environments, you require less compute power. For production environments on a larger highly available cluster with multiple dedicated nodes, you require more compute power. The larger configuration provides better performance, better cluster stability, and increased ease of scaling the cluster to support workload growth. For more information about specific production-level requirements for each IBM Cloud Pak®, see System requirements.
The following sections contain links to resources about installing Red Hat OpenShift Container Platform on your choice of environment, and what the recommended storage is for that environment:
On-premises
If you want to ensure that your environment is running securely behind your firewall, or you have an existing on-premises Red Hat OpenShift Container Platform cluster, you can deploy your IBM Cloud Pak® in your own private cloud.
Managed on-premises
You can deploy a managed Red Hat OpenShift Container Platform cluster on your on-premises infrastructure with IBM Cloud Satellite. For details, see IBM Cloud Satellite overview.
Self-managed on-premises
You can deploy a self-managed Red Hat OpenShift Container Platform cluster on your on-premises infrastructure by following the Red Hat OpenShift Container Platform documentation:
- For Red Hat OpenShift Container Platform 4.8, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.10, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.12, see Cluster installer activities
For a higher level view of installing IBM Cloud Paks on Red Hat OpenShift Container Platform see Installing OpenShift Container Platform clusters.
For more details about installing and setting up a Red Hat OpenShift Container Platform installation, see Installing Red Hat software 4.6 or later.
For more information about what to do next, see What's next?.
IBM Cloud
If you already use IBM Cloud® to run business-critical applications, or if you don't want to set up and manage your own hardware, you can deploy your IBM Cloud Pak on a managed IBM Cloud Red Hat OpenShift Container Platform cluster.
Managed IBM Cloud
You can deploy a managed Red Hat OpenShift Container Platform cluster on IBM Cloud infrastructure by using one of the following deployment methods:
IBM Cloud catalog
For details, see Red Hat OpenShift on IBM Cloud in the IBM Cloud catalog. You must select a supported version of Red Hat OpenShift Container Platform.
Terraform® for managed Red Hat OpenShift Container Platform
For more information about IBM Cloud Terraform, see Sample Terraform templates for IBM Cloud.
Self-managed IBM Cloud
You can deploy a self-managed Red Hat OpenShift Container Platform cluster on your IBM Cloud infrastructure by following the Red Hat OpenShift Container Platform documentation:
- For Red Hat OpenShift Container Platform 4.8, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.10, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.12, see Cluster installer activities
For a higher level view of installing IBM Cloud Paks on Red Hat OpenShift Container Platform see Installing OpenShift Container Platform clusters.
For more details about installing and setting up a Red Hat OpenShift Container Platform installation, see Installing Red Hat software 4.6 or later.
For more information about what to do next, see What's next?.
Amazon Web Services (AWS)
If you already use AWS to run business-critical applications, or if you don't want to set up and manage your own hardware, you can deploy your IBM Cloud Pak on AWS.
Managed AWS
You can deploy a managed Red Hat OpenShift Container Platform cluster on AWS infrastructure by using one of the following deployment methods:
AWS marketplace
For details, see Red Hat OpenShift Service on AWS (ROSA) in the AWS marketplace.
IBM Cloud Satellite
For details, see IBM Cloud Satellite in the IBM Cloud marketplace.
Self-managed AWS
You can deploy a self-managed Red Hat OpenShift Container Platform cluster on your AWS infrastructure by using the following method:
Manual installation
Follow the Red Hat OpenShift Container Platform documentation for installing on AWS:
- For Red Hat OpenShift Container Platform 4.8, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.10, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.12, see Cluster installer activities
For a higher level view of installing IBM Cloud Paks on Red Hat OpenShift Container Platform see Installing OpenShift Container Platform clusters.
For more details about installing and setting up a Red Hat OpenShift Container Platform installation, see Installing Red Hat software 4.6 or later.
For more information about what to do next, see What's next?.
Microsoft Azure
If you already use Microsoft Azure and you don't want to set up and manage your own hardware, you can deploy your IBM Cloud Pak on Azure.
Managed Microsoft Azure
You can deploy a managed Red Hat OpenShift Container Platform cluster on Azure infrastructure by using the following deployment method:
Azure marketplace
For more information about creating a managed cluster in Microsoft Azure from the Azure marketplace, see Create an Azure Red Hat OpenShift 4 cluster.
Self-managed Microsoft Azure
You can deploy a self-managed Red Hat OpenShift Container Platform cluster on Azure infrastructure by using the following deployment method:
Manual installation
Follow the Red Hat OpenShift Container Platform documentation for installing on Microsoft Azure:
- For Red Hat OpenShift Container Platform 4.8, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.10, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.12, see Cluster installer activities
For a higher level view of installing IBM Cloud Paks on Red Hat OpenShift Container Platform see Installing OpenShift Container Platform clusters.
For more details about installing and setting up a Red Hat OpenShift Container Platform installation, see Installing Red Hat software 4.6 or later.
For more information about what to do next, see What's next?.
Google Cloud
If you already use Google Cloud and you don't want to set up and manage your own hardware, you can deploy your IBM Cloud Pak on Google Cloud.
Managed Google Cloud
Managed Red Hat OpenShift Container Platform on Google Cloud infrastructure is not supported.
Self-managed Google Cloud
You can deploy a self-managed Red Hat OpenShift Container Platform cluster on your Google Cloud infrastructure by following the Red Hat OpenShift Container Platform documentation:
- For Red Hat OpenShift Container Platform 4.8, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.10, see Cluster installer activities
- For Red Hat OpenShift Container Platform 4.12, see Cluster installer activities
For a higher level view of installing IBM Cloud Paks on Red Hat OpenShift Container Platform see Installing OpenShift Container Platform clusters.
For more details about installing and setting up a Red Hat OpenShift Container Platform installation, see Installing Red Hat software 4.6 or later.
For more information about what to do next, see What's next?.
What's next?
After you install Red Hat OpenShift Container Platform on your chosen environment, you must configure compatible storage for it. For more information about configuring storage based on the installation environment, see Configuring storage.