Get started with DSS

This guide describes how you can get started with Data Science Stack (DSS). From setting up MicroK8s in your host environment, all the way to running your first notebook.

Data Science Stack is a ready-made environment that makes it seamless to run GPU-enabled containerised Machine Learning (ML) environments. It provides easy access to a solution for developing and optimising ML models, utilising your machine’s GPUs and allowing users to utilise different ML environment images based on their needs.

Prerequisites

  • Ubuntu 22.04 LTS.

  • Snap installed.

  • 50GB of disk space is recommended. This includes the requirements for MicroK8s.

Setting up MicroK8s

DSS relies on a container orchestration system, capable of exposing the host GPUs to the workloads. MicroK8s is used as the orchestration system. All the workloads and state managed by DSS are running on top of MicroK8s.

You can install MicroK8s using snap as follows:

sudo snap install microk8s --channel 1.28/stable --classic
sudo microk8s enable hostpath-storage
sudo microk8s enable dns
sudo microk8s enable rbac

Install the DSS CLI

DSS is a Command Line Interface (CLI)-based environment. Now, install the DSS CLI using the following command:

sudo snap install data-science-stack --channel latest/stable

Initialise DSS

Next, you need to initialise DSS on top of MicroK8s and prepare MLflow:

dss initialize --kubeconfig="$(sudo microk8s config)"

Note

The initialisation might take a few minutes to complete. While the process is in progress, you will see the following message: Waiting for deployment mlflow in namespace dss to be ready...

Once initialised, you should see an output like this:

Deployment mlflow in namespace dss is ready

Launch a Notebook

At this point, DSS is set up and you are ready to start managing containerised notebook environments. You can use the DSS CLI to launch and access them using JupyterLab.

Start your first Jupyter Notebook with the following command:

dss create my-tensorflow-notebook --image=kubeflownotebookswg/jupyter-tensorflow-cuda:v1.8.0

Once the command succeeds, it returns a URL that can be used to connect to the JupyterLab User Interface (UI) of that notebook. For example, you should expect an output like this:

Executing create command
Waiting for deployment my-tensorflow-notebook in namespace dss to be ready...
Deployment my-tensorflow-notebook in namespace dss is ready
Success: Notebook my-tensorflow-notebook created successfully.
Access the notebook at http://10.152.183.42:80.

Once you know the URL, open a web browser and enter the URL into the address bar. This will direct you to the notebook UI where you can start working with your notebook.

Next Steps