Quantum - Premiers pas avec les notebooks QPUs

Découvrez comment configurer un Quantum QPUs 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 QPUs est notre solution managée de notebooks Jupyter et VS Code, conçue pour exécuter des tâches sur un véritable processeur quantique (Quantum Processing Unit). Le notebook fonctionne de la même manière qu'un notebook OVHcloud Quantum Emulators, mais avec un token managé permettant d'accéder à un QPU distant. Des frais supplémentaires seront calculés pour l'utilisation de ce QPU.

Objectif

Ce guide explique comment créer, configurer, consulter, arrêter, redémarrer et supprimer un Quantum QPUs Notebook depuis l'espace client 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'interface en ligne de commande (CLI) ovhai
L'API Quantum
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 accès à l'.
Un utilisateur Public Cloud disposant du rôle Administrator ou Quantum Operator & Objectstore Operator.

En pratique

Processus d'autorisation OVHcloud Quantum Solutions

Si vous utilisez la CLI, l'API ou le SDK, vous devrez suivre un processus d'autorisation avant de créer un Quantum QPUs Notebook. Pour ce faire, procédez comme suit :

Connectez-vous à l' et accédez à la section Public Cloud.
Sélectionnez le projet Public Cloud que vous souhaitez utiliser et cliquez sur la catégorie Quantum QPUs.
Cliquez sur le bouton Créer un notebook. Le processus d'autorisation s'effectue silencieusement en arrière-plan.

Créer un notebook depuis l'espace client OVHcloud 01

Lancer votre premier Quantum Notebook

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

Via l'espace client OVHcloud

Depuis la CLI ovhai

Via l'API AI Solution

Via le SDK Python

Accédez à la section Public Cloud de l' et cliquez sur la catégorie Quantum QPUs. Cliquez sur le bouton Créer un notebook et suivez les instructions pour définir la configuration de votre Quantum Notebook.

1. Nom du notebook

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

2. Localisation du notebook

Sélectionnez ensuite une localisation.

Créer un notebook depuis l'espace client OVHcloud 02

3. Ressources de calcul

Définissez et ajustez le type et la quantité de ressources de calcul (CPU / GPU) pour votre Quantum Notebook. Utilisez les boutons + et - pour augmenter ou diminuer le nombre de CPUs et de GPUs, selon vos besoins.

Cliquez sur Suivant.

Créer un notebook depuis l'espace client OVHcloud 03

4. Frameworks préconfigurés

Choisissez le framework Python Quantum que vous souhaitez utiliser : il sera préinstallé et prêt à l'emploi au lancement de votre notebook. Sélectionnez la version qui correspond à vos besoins. Cliquez ensuite sur Suivant pour continuer.

Créer un notebook depuis l'espace client OVHcloud 04

5. Éditeur de code en direct

Choisissez l'éditeur de code souhaité.

Créer un notebook depuis l'espace client OVHcloud 05

6. Paramètres de confidentialité

Sélectionnez ensuite vos paramètres de confidentialité et cliquez sur Suivant.

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 restreint nécessitera une combinaison utilisateur/mot de passe ou un token Quantum pour accéder au contenu du notebook, afin de garantir un environnement sécurisé.

Créer un notebook depuis l'espace client OVHcloud 06

7. Configuration avancée

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

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é.

Cliquez sur Suivant.

Créer un notebook depuis l'espace client OVHcloud 07

Les clés publiques SSH vous permettent d'accéder à distance à votre notebook. Cette section est facultative : cliquez sur Suivant.

9. Lancer le Quantum Notebook

À la fin du processus, vérifiez vos paramètres et cliquez sur le bouton Order now pour confirmer et lancer la création de votre notebook. Vous serez redirigé vers le tableau de bord de votre notebook :

Créer un notebook depuis l'espace client OVHcloud 10

Info

Notez en bas de l'écran 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 votre onglet Quantum QPUs :

Créer un notebook depuis l'espace client OVHcloud 11

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://bhs.ai.cloud.ovh.net",
token="YOUR_QUANTUM_TOKEN",
)

# Définition des paramètres du notebook
editor_id = "jupyterlab"
framework_id = "pasqal-qpu"
framework_version = "1.6.2-py312-cpu"
framework_qpu_flavor_id = "orion-beta"
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},
"quantumResources": {"qpuFlavorId": framework_qpu_flavor_id},
"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 lien JupyterLab du tableau des Quantum Notebooks ou via la CLI ovhai, l'API Quantum ou le SDK Python.

Via l'espace client OVHcloud

Depuis la CLI ovhai

Via l'API Quantum

Via le SDK Python

Cliquez sur le lien JupyterLab dans la colonne Access :

Accéder à un notebook depuis l'espace client OVHcloud 1

Vous pouvez également accéder au notebook depuis sa page dédiée :

Accéder à un notebook depuis l'espace client OVHcloud 2

Sur la page du notebook, vous trouverez des informations sur celui-ci, notamment ses caractéristiques, sa facturation et les données attachées, ainsi qu'une URL de monitoring pour consulter les métriques en temps réel.

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

from ovhai import AuthenticatedClient
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://bhs.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://bhs.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 :

Via l'espace client OVHcloud

Depuis la CLI ovhai

Via l'API Quantum

Via le SDK Python

Accédez au tableau des Quantum Notebooks et cliquez sur le bouton ... à côté du notebook que vous souhaitez arrêter. Cliquez sur le bouton Arrêter pour arrêter le notebook. Vous pouvez également, depuis le tableau du notebook, cliquer sur le bouton rouge en haut de la page.

Arrêter un notebook depuis l'espace client OVHcloud

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://bhs.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 :

Via l'espace client OVHcloud

Depuis la CLI ovhai

Via l'API Quantum

Via le SDK Python

Accédez au tableau des Quantum Notebooks et cliquez sur le bouton ... à côté du notebook que vous souhaitez redémarrer. Cliquez sur le bouton Démarrer pour redémarrer le notebook. Vous pouvez également, depuis le tableau du notebook, cliquer sur le bouton bleu en haut de la page.

Redémarrer un notebook depuis l'espace client OVHcloud

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 :

Via l'espace client OVHcloud

Depuis la CLI ovhai

Via l'API Quantum

Via le SDK Python

Accédez au tableau des Quantum Notebooks et cliquez sur le bouton ... à côté du notebook que vous souhaitez supprimer. Cliquez sur le bouton Supprimer pour supprimer le notebook. Vous pouvez également cliquer sur le bouton Delete notebook en bas de la page.

Supprimer un notebook depuis l'espace client OVHcloud

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é ?