For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/public-cloud/ai-machine-learning/ai-training-start-use-notebooks.md.
  • English

AI Training - Start a job with a notebook Docker image

View as Markdown

Learn how to start a simple interactive notebook leveraging GPUs over AI Training service.

 

Requirements

 

Instructions

Step 1 - Begin as a classic job submission

Follow the same steps as a classic job submission described here until you reach the Docker image step.

 

Step 2 - Select the notebook corresponding to your needs

A job is basically a Docker container that is run within the OVHcloud infrastructure.

Notebooks are daemon jobs, meaning they will run indefinitely until the user requests an interruption.

AI Training offers several notebook images with different configurations. You can choose the configuration that best suits your needs.

Currently, the following configurations are available:

  • PyTorch: An OVHcloud preset image including JupyterLab notebook, Visual Studio Code IDE, and pytorch libraries
  • Tensorflow 2: An OVHcloud preset image containing JupyterLab notebook, Visual Studio Code IDE, and tensorflow 2 libraries
  • Hugging Face Transformers: An OVHcloud preset image containing JupyterLab notebook, Visual Studio Code IDEand hugging face libraries
  • MXNet: An OVHcloud preset image containing JupyterLab notebook, Visual Studio Code IDE, and mxnet libraries
  • Fast.ai: An OVHcloud preset image containing JupyterLab notebook, Visual Studio Code IDE, and fast.ai libraries
  • auto gluon: An OVHcloud preset image containing JupyterLab notebook, Visual Studio Code IDE, and AutoGluon + mxnet libraries

Manager AI order docker

 

Step 3 - Continue as a classic job submission

Continue to follow the same steps as a classic job submission described here until you reach Step 10 - Consulting your job.

Warning

NOTE: If you want to be able to save your notebook files on your object storage, we strongly advise that you plug a read and write volume on your job before submitting. That volume will be synchronized with your object storage at the end of the job.

 

Step 4 - Access notebook URL

Once your job is Running, in the job Access panel, you should see the Container access link. Click on it, and you will be redirected to your job URL.

Manager AI dashboard - step 2

 

Step 5 - Log in as an AI Training user

If you are not authenticated as an AI Training user, you should see a screen asking for your username and password.

Info

If you have never created a user for AI Training yet, you can follow the instructions here.

Fill in the fields and click Connect.

PaaS AI docker - step 3

 

Step 6 - Use your notebook

In most provided preset images, you can choose which editor you prefer between JupyterLab and VisualStudio code.

PaaS AI docker - step 4

Select the one that you want to use, and you will be redirected to the corresponding editor.

PaaS AI docker - step 5

By default, the home directory of your job is located under /workspace. It means that you will have read and write access to that directory as well as your read and write mounted volumes.

Warning

NOTE: If you are missing a library or a configuration, you can add it directly in the command line of the notebook's console as long as you don't need privileged access (root access). Example: pip install <...>

For installing specific libraries that require privileged access, you will have to build your own notebook image and use it as a custom image at Step 2 instead of a preset image. More information about creating your own Docker image can be found here.

Info

If you open a console tab in your notebook and type nvidia-smi, you will see the available GPUs that you can use on your notebook.

PaaS AI docker - step 6

From the Jupyter Notebook interface, the !nvidia-smi command will retrieve the same information.

PaaS AI docker 06

 

Step 7 - Stop your notebook

Once you are done working with your notebook, don't forget to stop it.

You can do it by selecting more options ... and then Stop.

Then, in the pop-up window, click Stop.

Manager AI service list more options

After some time, your job should go into an Interrupted state, meaning that the job has been stopped.

Info

Before going into the Interrupted state, your job may run through the Finalizing state. During this phase, all data inside read & write volumes are saved inside their linked containers in your object storage.

Manager AI dashboard interrupted

 

Go further

Browse all the AI & Machine Learning guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about AI & Machine Learning on the OVHcloud US website.

If you need training or technical assistance to implement our solutions, contact your sales representative or click on this link to get a quote and ask our Professional Services experts for a custom analysis of your project.