Kubernetes#
RAPIDS integrates with Kubernetes in many ways depending on your use case.
Interactive Notebook#
For single-user interactive sessions you can run the RAPIDS docker image which contains a conda environment with the RAPIDS libraries and Jupyter for interactive use.
You can run this directly on Kubernetes as a Pod
and expose Jupyter via a Service
. For example:
# rapids-notebook.yaml
apiVersion: v1
kind: Service
metadata:
name: rapids-notebook
labels:
app: rapids-notebook
spec:
type: NodePort
ports:
- port: 8888
name: http
targetPort: 8888
nodePort: 30002
selector:
app: rapids-notebook
---
apiVersion: v1
kind: Pod
metadata:
name: rapids-notebook
labels:
app: rapids-notebook
spec:
securityContext:
fsGroup: 0
containers:
- name: rapids-notebook
image: rapidsai/rapidsai-core:22.06-cuda11.5-runtime-ubuntu20.04-py3.9
resources:
limits:
nvidia.com/gpu: 1
ports:
- containerPort: 8888
name: notebook
$ kubectl apply -f rapids-notebook.yaml
This makes Jupyter accessible on port 30002
of your Kubernetes nodes via NodePort
service. Alternatvely you could use a LoadBalancer
service type if you have one configured or a ClusterIP
and use kubectl
to port forward the port locally and access it that way.
$ kubectl port-forward service/rapids-notebook 8888
Then you can open port 8888
in your browser to access Jupyter and use RAPIDS.

Helm Chart#
Individual users can also install the Dask Helm Chart which provides a Pod
running Jupyter alongside a Dask cluster consisting of pods running the Dask scheduler and worker components. You can customize this helm chart to run the RAPIDS container images as both the notebook server and Dask cluster components so that everything can benefit from GPU acceleration.
Find out more on the Dask Helm Chart page.
Dask Operator#
Dask has an operator that empowers users to create Dask clusters as native Kubernetes resources. This is useful for creating, scaling and removing Dask clusters dynamically and in a flexible way. Usually this is used in conjunction with an interactive session such as the interactive notebook example above or from another service like KubeFlow Notebooks. By dynamically launching Dask clusters configured to use RAPIDS on Kubernetes user’s can burst beyond their notebook session to many GPUs spreak across many nodes.
Find out more on the Dask Operator page.
Dask Kubernetes (classic)#
Warning
Unless you are already using the classic Dask Kubernetes integration we recommend using the Dask Operator instead.
Dask has an older tool for dynamically launching Dask clusters on Kubernetes that does not use an operator. It is possible to configure this to run RAPIDS too but it is being phased out in favour of the operator.
Find out more on the Dask Kubernetes page.
Dask Gateway#
Some organisations may want to provide Dask cluster provisioning as a central service where users are abstracted from the underlying platform like Kubernetes. This can be useful for reducing user permissions, limiting resources that users can consume and exposing things in a centralised way. For this you can deploy Dask Gateway which provides a server that users interact with programatically and in turn launches Dask clusters on Kubernetes and proxies the connection back to the user.
Users can configure what they want their Dask cluster to look like so it is possible to utilize GPUs and RAPIDS for an accelerated cluster.
Find out more on the Dask Gateway page.
KubeFlow#
If you are using KubeFlow you can integrate RAPIDS right away by using the RAPIDS container images within notebooks and pipelines and by using the Dask Operator to launch GPU accelerated Dask clusters.
Find out more on the KubeFlow page.