Quantum - Premiers pas avec les notebooks Emulators

Découvrez comment configurer un Quantum Emulators Notebook

Warning

Certains liens de cette documentation renvoient vers la solution AI and Machine Learning. L'informatique quantique partage la même infrastructure as a service, vous pouvez donc être redirigé vers une autre section de cette documentation.

Introduction

Un notebook est un document qui intègre du code, des éléments de texte enrichi et du multimédia, ce qui en fait un outil pratique pour l'analyse et la visualisation quantiques.

OVHcloud Quantum Emulators est notre solution managée de notebooks Jupyter et VS Code. Vous pouvez lancer facilement des notebooks avec les ressources CPU et GPU nécessaires, tout en bénéficiant d'avantages tels que des dépendances et des frameworks Quantum préinstallés, un accès utilisateur sécurisé et une gestion des données simplifiée.

Objectif

Ce guide explique comment créer, configurer, consulter, arrêter, redémarrer et supprimer un Quantum Emulators Notebook depuis la console OVHcloud (UI). Cette méthode est simple d'utilisation et idéale pour les débutants.

Vous pouvez également utiliser l'une des méthodes suivantes :

L'API Quantum
L'interface en ligne de commande (CLI) ovhai
Le SDK Python ovhai

Chaque méthode présente ses propres avantages, selon votre niveau d'expertise et le workflow que vous préférez.

Prérequis

Un projet Public Cloud dans votre compte OVHcloud.
Un utilisateur Public Cloud disposant du rôle Administrator ou Quantum Operator & ObjectStore operator.

Accès à la console OVHcloud

Lien direct :
Pour accéder à vos services : Public Cloud > Sélectionnez votre projet > Quantum > Emulators

En pratique

Processus d'autorisation OVHcloud Quantum Solutions

Si vous utilisez l'API, la CLI ou le SDK, vous devrez suivre un processus d'autorisation avant de créer un Quantum Emulators Notebook. Pour ce faire, cliquez sur Emulators sous Quantum dans le menu de gauche de votre projet Public Cloud : si le bandeau Autorisez ce projet pour les services IA s'affiche, cliquez sur Autoriser le projet.

Lancer votre premier Quantum Notebook

Pour créer un Quantum Notebook, procédez comme suit :

Console OVHcloud

API AI Solution

CLI ovhai

SDK Python

Dans le menu de gauche de votre projet Public Cloud, cliquez sur Emulators sous Quantum.

Cliquez sur le bouton Créer un notebook. La page Créer un notebook s'ouvre : définissez la configuration de votre Quantum Notebook dans les sections ci-dessous. Un récapitulatif de votre configuration et son prix estimé par heure s'affichent sur la droite.

Nom

Donnez un nom à votre notebook. Cela facilitera sa gestion lorsque vous aurez créé plusieurs Quantum Notebooks.

Région

Sélectionnez ensuite une région.

Flavor

Sélectionnez le matériel sur lequel tourne votre notebook (flavor CPU ou GPU) dans le tableau Flavor, puis ajustez la Quantité de ressources selon vos besoins.

Framework

Choisissez le framework Python quantique que vous souhaitez utiliser, qui sera préinstallé et prêt à l'emploi au lancement de votre notebook. Sélectionnez la Version adaptée à vos besoins.

Éditeur

Choisissez l'éditeur de code que vous souhaitez.

Confidentialité

Sélectionnez ensuite vos paramètres de confidentialité : Privé (l'accès requiert un token) ou Public (accès sans token).

Warning

L'accès public exposera vos données et votre code à toute personne disposant du lien du Quantum Notebook. Veillez à ne pas l'utiliser avec des données sensibles. À l'inverse, l'accès privé nécessitera une combinaison utilisateur/mot de passe ou un token Quantum pour accéder au contenu du notebook, garantissant un environnement sécurisé.

Expiration

Le notebook est arrêté automatiquement après 7 jours de fonctionnement consécutifs ; votre configuration et vos données sont enregistrées. Vous pouvez activer Redémarrer automatiquement après expiration.

Configuration avancée

Par défaut, votre Quantum Notebook dispose d'un stockage éphémère (stockage local). Mais dans cette section, vous pouvez également associer des conteneurs Object Storage (Volumes) et des dépôts Git (Git Public) à votre notebook afin d'accéder facilement à vos données distantes, et ajouter des Labels.

Si vous souhaitez en savoir plus sur la configuration des conteneurs et des dépôts Git dans le notebook, vous pouvez consulter cette documentation AI & Machine Learning. Pour l'instant, nous allons lancer un notebook classique, sans aucun volume externe ajouté.

La Clé SSH (facultative) vous permet d'accéder à distance à votre notebook.

Lancer le Quantum Notebook

À la fin du processus, vérifiez le récapitulatif de vos paramètres et cliquez sur le bouton Créer le notebook pour confirmer et lancer la création de votre notebook.

Info

Cliquez sur Équivalent CLI pour afficher la commande CLI ovhai équivalente. Cette commande vous permet de lancer exactement le même notebook depuis la CLI.

Lorsque votre notebook est créé, il apparaît dans la liste de vos notebooks Quantum Emulators.

Créez un bearer token depuis la CLI ovhai. Pour des instructions plus détaillées sur la création d'un token, consultez la documentation gérer les tokens d'accès.
Accédez à la région souhaitée et suivez les instructions pour créer un Quantum Notebook.

API AI Solution GRA, pour Gravelines, France.
API AI Solution BHS, pour Beauharnois, Canada.

Méthode POST Submit a new notebook

Warning

Veillez à sélectionner Bearer Auth au lieu d'OAuth 2.0, qui est sélectionné par défaut.

Créer un notebook avec l'authentification par token de l'API

Warning

Avertissement version alpha : ce paquet est actuellement en phase alpha de développement. Les API et les fonctionnalités du paquet peuvent ne pas être entièrement testées.

Créez un bearer token depuis la CLI ovhai. Pour des instructions plus détaillées sur la création d'un token, consultez la documentation gérer les tokens d'accès.
Installez le SDK Python ovhai et suivez les instructions de la page ovhai PyPI pour créer un Quantum Notebook.
Enfin, ouvrez votre terminal et exécutez pip install ovhai.

Voici un exemple simple pour vous aider à démarrer facilement :

from ovhai import AuthenticatedClient
from ovhai.api.notebook import notebook_new
from ovhai.models import NotebookSpec, Notebook
from ovhai.ovhai_types import Response

client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)

# Définition des paramètres du notebook
editor_id = "jupyterlab"
framework_id = "alicebob"
framework_version = "1.2.0-py312-cpu"
nb_cpu = 1

# Création de la requête de création du notebook
notebook_specs = {
"env": {"editorId": editor_id, "frameworkId": framework_id, "frameworkVersion": framework_version},
"resources": {"cpu": nb_cpu},
}

with client as client:
response: Response[Notebook] = notebook_new.sync_detailed(
client=client, body=NotebookSpec.from_dict(notebook_specs)
)

import json
response_content = response.content.decode('utf-8')  # Décodage des octets en chaîne de caractères
response_dict = json.loads(response_content)

status_code = response.status_code
id_ = response_dict['id']
spec = response_dict['spec']
status = response_dict['status']
state = status['state']
info = status['info']
url = response_dict['status']['url']

print(f"Status code: {status_code}")
print(f"ID: {id_}")
print(f"Spec: {spec}")
print(f"State: {state}")
print(f"Info: {info}")
print(f"URL: {url}")

Une fois votre Quantum Notebook créé et en cours d'exécution, vous pouvez y accéder via le bouton Ouvrir JupyterLab de la page du notebook ou via la CLI ovhai, l'API Quantum ou le SDK Python.

Console OVHcloud

API Quantum

CLI ovhai

SDK Python

Dans le menu de gauche de votre projet Public Cloud, cliquez sur Emulators sous Quantum. Cliquez ensuite sur le nom du notebook pour ouvrir son onglet Vue d’ensemble.

Dans la carte Détails de connexion, cliquez sur le bouton Ouvrir JupyterLab (le bouton porte le nom de l'éditeur sélectionné).

Sur la page du notebook, vous trouverez des informations sur le notebook, notamment ses spécifications, son cycle de vie et les données attachées, ainsi qu'un lien de monitoring (Monitoring Grafana) pour les métriques en temps réel.

Exécutez le code suivant pour lister tous les Quantum Notebooks :

from ovhai.api.notebook import notebook_get_all
from ovhai.models import NotebookList
from ovhai.ovhai_types import Response

from ovhai import AuthenticatedClient

client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)

with client as client:
response: Response[NotebookList] = notebook_get_all.sync_detailed(client=client)
import json
response = json.loads(response.content.decode())
for notebook_info in response["items"]:
print(f"ID: {notebook_info['id']}")
print(f"Name: {notebook_info['spec']['name']}")
print(f"Status: {notebook_info['status']['state']}")
print(f"Framework: {notebook_info['spec']['env']['frameworkId']}")
print(f"Framework version: {notebook_info['spec']['env']['frameworkVersion']}")
print(f"Editor: {notebook_info['spec']['env']['editorId']}")
print(f"Access link: {notebook_info['status']['url']}")
print("---------------")

Vous pouvez également obtenir les informations du notebook avec cet exemple de code :

from ovhai.api.notebook import notebook_get
from ovhai import AuthenticatedClient
import json

client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)
id = "YOUR_NOTEBOOK_UUID"

with client as client:
response = notebook_get.sync_detailed(
id=id, client=client
)

print(json.loads(response.content.decode()))

Pour vous connecter à votre Quantum Notebook, vous devrez vous authentifier à l'aide d'une combinaison nom d'utilisateur/mot de passe ou d'un token d'accès.

Avec un nom d'utilisateur et un mot de passe

Saisissez les identifiants de l'utilisateur de votre projet Public Cloud pour vous connecter à votre Quantum Notebook.

Authentification du notebook par identifiants

Avec un token d'accès

Cliquez sur le bouton Login with token et saisissez votre token d'accès pour vous connecter à votre Quantum Notebook.

Arrêter un Quantum Notebook

Vous pouvez arrêter votre Quantum Notebook à tout moment afin de libérer ses ressources de calcul. Cela libère ses ressources de calcul, mais conserve les données de votre notebook et les bibliothèques installées. Par conséquent, aucun frais de calcul supplémentaire ne vous sera facturé, sauf si vous redémarrez le notebook. En revanche, le stockage attaché sera facturé au tarif de l'Object Storage OVHcloud (consultez la documentation sur la facturation des Quantum Notebooks pour plus d'informations). Pour ce faire, procédez comme suit :

Console OVHcloud

API Quantum

CLI ovhai

SDK Python

Dans la liste Emulators (sous Quantum dans le menu de gauche de votre projet Public Cloud), cliquez sur le bouton ... à côté du notebook, puis sur Arrêter. Vous pouvez aussi cliquer sur Arrêter dans la carte Informations générales du notebook. Confirmez avec Arrêter.

Utilisez la méthode notebook_stop pour arrêter le notebook.

from ovhai.api.notebook import notebook_stop
from ovhai import AuthenticatedClient
client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)
id = "YOUR_NOTEBOOK_UUID"

with client as client:
response = notebook_stop.sync_detailed(client=client, id=id)

Pour redémarrer un notebook arrêté, procédez comme suit :

Console OVHcloud

API Quantum

CLI ovhai

SDK Python

Dans la liste Emulators (sous Quantum dans le menu de gauche de votre projet Public Cloud), cliquez sur le bouton ... à côté du notebook, puis sur Démarrer. Vous pouvez aussi cliquer sur Démarrer dans la carte Informations générales du notebook. Confirmez avec Démarrer.

Utilisez la méthode notebook_start pour redémarrer le notebook.

from ovhai.api.notebook import notebook_start
from ovhai import AuthenticatedClient
client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)
id = "YOUR_NOTEBOOK_UUID"

with client as client:
response = notebook_start.sync_detailed(
id=id, client=client
)

Le notebook doit être arrêté avant de pouvoir être supprimé. Pour supprimer un notebook, procédez comme suit :

Console OVHcloud

API Quantum

CLI ovhai

SDK Python

Dans la liste Emulators (sous Quantum dans le menu de gauche de votre projet Public Cloud), cliquez sur le bouton ... à côté du notebook, puis sur Supprimer. Vous pouvez aussi cliquer sur Supprimer le notebook dans la carte Informations générales du notebook. Confirmez avec Supprimer.

Utilisez la méthode notebook_delete pour supprimer le notebook.

from ovhai.api.notebook import notebook_delete
from ovhai import AuthenticatedClient

client = AuthenticatedClient(
base_url="https://gra.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)
id = "YOUR_NOTEBOOK_UUID"

with client as client:
response = notebook_delete.sync_detailed(
id=id, client=client, force=False
)

print(response.content.decode())

Découvrez comment accéder à vos données Object Storage et à vos dépôts Git depuis vos notebooks via l'interface graphique ici.
Découvrez les fonctionnalités techniques, les capacités et les limites de l'offre Public Cloud Quantum Notebooks ici.
Obtenez des conseils pour déboguer vos notebooks en cas de problème ici.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Votre avis nous intéresse !

Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.

N’hésitez pas à nous faire part de vos questions, retours et suggestions concernant les Quantum Notebooks :

Dans le canal #quantum-computing du serveur Discord OVHcloud.

Cette page vous a-t-elle aidé ?