Preparations

Prerequisites¶

See Prerequisites section above.

Prepare Installation Artifacts¶

Run:ai Software Files¶

SSH into a node with kubectl access to the cluster and Docker installed.

kubectl create namespace runai-backend
kubectl apply -f runai-gcr-secret.yaml

tar xvf runai-<version>.tar.gz
cd deploy

kubectl create namespace runai-backend

Run:ai Administration CLI¶

chmod +x runai-adm

Install Helm¶

If helm v3 does not yet exist on the machine, install it now:

tar xvf helm-<version>-linux-amd64.tar.gz
sudo mv linux-amd64/helm /usr/local/bin/

Mark Run:ai System Workers¶

The Run:ai control plane (backend) should be installed on a set of dedicated Run:ai system worker nodes rather than GPU worker nodes. To set system worker nodes run:

kubectl label node <NODE-NAME> node-role.kubernetes.io/runai-system=true

To avoid single-point-of-failure issues, we recommend assigning more than one node in production environments.

Additional Permissions¶

As part of the installation you will be required to install the Run:ai Control Plane and Cluster Helm Charts. The Helm Charts require Kubernetes administrator permissions. You can review the exact permissions provided by using the --dry-run on both helm charts.

Next Steps¶

Continue with installing the Run:ai Control Plane.