Skip to content

Install a Cluster

Prerequisites

Install prerequisites as per System Requirements document.

Create OpenShift Projects

Run:ai cluster installation uses several namespaces (or projects in OpenShift terminology). Run the following:

oc new-project runai
oc new-project runai-reservation
oc new-project runai-scale-adjust

The last namespace (runai-scale-adjust) is only required if the cluster is a cloud cluster and is configured for auto-scaling.

Cluster Installation

Perform the cluster installation instructions explained in Cluster install. When creating a new cluster, select the OpenShift target platform.

Info

To install a specific version, add --version <version> to the install command. You can find available versions by running helm search repo -l runai-cluster.

Perform the cluster installation instructions explained in Cluster install. When creating a new cluster, select the OpenShift target platform.

On the second tab of the cluster wizard, when copying the helm command for installation, you will need to use the pre-provided installation file instead of using helm repositories. As such:

  • Do not add the helm repository and do not run helm repo update.
  • Instead, edit the helm upgrade command.
    • Replace runai/runai-cluster with runai-cluster-<version>.tgz.
    • Add --set global.image.registry=<Docker Registry address> where the registry address is as entered in the preparation section
    • Add --set global.customCA.enabled=true and perform the instructions for local certificate authority.

The command should look like the following: 

helm upgrade -i runai-cluster runai-cluster-<version>.tgz \
    --set controlPlane.url=... \
    --set controlPlane.clientSecret=... \
    --set cluster.uid=... \
    --set cluster.url=... --create-namespace \
    --set global.image.registry=registry.mycompany.local \
    --set global.customCA.enabled=true

(Optional) Customize Installation

To customize specific aspects of the cluster installation see customize cluster installation.

Next Steps

Continue to create Run:ai Projects.