IBM Cloud Docs
Getting started with Red Hat OpenShift for HPC

Getting started with Red Hat OpenShift for HPC

Red Hat® OpenShift® for HPC enables you to deploy Red Hat OpenShift clusters on IBM Cloud® infrastructure for running HPC workloads. The deployment is performed by using Terraform and IBM Cloud Schematics as automation frameworks. The following steps outline the high-level flow of events that are performed:

  1. Create a workspace with the Terraform code from IBM Cloud Schematics. This step defines the set of configuration properties that are used to perform the automation.
  2. Generate a plan to confirm whether the configuration properties are valid, so that when you run the Terraform code, all of the resources are provisioned correctly. If the validation fails, fix the configuration properties and try again.
  3. Apply a plan triggers the actual deployment of the IBM Cloud resources to have an HPC cluster up and running by the time the deployment completes. If the deployment fails, identify the reason for failure, fix the problem, and try again. If a change is needed to the configuration properties, it might be better to generate a plan again.

Before you can deploy your Red Hat OpenShift cluster, you need to create or gather some information. To get started, complete the following steps.

Check your permissions for IBM Cloud services

You need to make sure that you have the appropriate permissions for the IBM Cloud services that are used by the offering to create and manage cluster resources. For more information, see the following links:

Generate API key

Generate an API key for your IBM Cloud account where the Red Hat OpenShift cluster will be deployed. For more information, see Managing user API keys.

Create SSH key

Create an SSH key in your IBM Cloud account. This is your SSH key that you will use to access the Red Hat OpenShift cluster. Ensure that the SSH key is present in the same resource group and region where the cluster is being provisioned. The offering supports passing multiple, comma-separated SSH keys, if the cluster needs multiple SSH keys. For more information, see Managing SSH keys.

Next steps

After you've gathered the necessary input values to define your cluster configuration, you are ready to deploy your Red Hat OpenShift cluster. The Red Hat OpenShift cluster can be deployed on IBM Cloud by using the IBM Cloud Schematics UI, Schematics CLI, or the Schematics APIs. If you want to deploy your cluster by using the CLI or API, review the prerequisites for your interface of choice:

After you've created and gathered your information and reviewed any additional prerequisites for your interface of choice, you are ready to begin Creating a workspace.