Gérer des espaces de travail quantiques avec Azure CLI

Article
10/28/2023

Dans ce guide, vous allez découvrir comment utiliser l’interface de ligne de commande Azure (Azure CLI) pour créer des espaces de travail Azure Quantum ainsi que les groupes de ressources et comptes de stockage nécessaires. Vous commencerez également à exécuter vos applications quantiques dans Azure Quantum.

Prérequis

Pour utiliser le service Azure Quantum, vous avez besoin des éléments suivants :

Compte Azure avec un abonnement actif. Si vous n’avez pas de compte Azure, inscrivez-vous gratuitement et inscrivez-vous à un abonnement avec paiement à l’utilisation.
Un groupe de ressources Azure où réside l’espace de travail quantique.
Un compte de stockage dans le groupe de ressources à associer à l’espace de travail quantique. Plusieurs espaces de travail peuvent être associés au même compte.
Interface de ligne de commande Azure.
Microsoft Quantum Development Kit.

Configuration de l’environnement

Installez l’extension Azure CLI quantum. Ouvrez une invite de commandes et exécutez la commande suivante, qui met également à niveau l’extension si une version précédente est déjà installée :
```
az extension add --upgrade -n quantum
```
Connectez-vous à Azure avec vos informations d’identification. Vous voyez une liste d’abonnements associés à votre compte.
```
az login
```
Spécifiez l’abonnement que vous souhaitez utiliser.
```
az account set -s <Your subscription ID>
```
Si vous créez des espaces de travail quantiques dans votre abonnement pour la première fois, inscrivez le fournisseur de ressources avec cette commande :
```
az provider register --namespace Microsoft.Quantum
```

Créer un espace de travail Azure Quantum

Pour créer un espace de travail Azure Quantum, vous devez savoir :

Le nom de la localisation ou de la région Azure où la ressource existera. Vous pouvez utiliser la liste des régions et codes de gestionnaire des ressources correspondants pris en charge par l’outil Azure CLI (par exemple, westus).
Le groupe de ressources associé au nouvel espace de travail, par exemple MyResourceGroup.
Un compte de stockage dans le même groupe de ressources et le même abonnement que l’espace de travail quantique. Il est possible de créer un compte de stockage à partir de l’outil Az CLI, par exemple MyStorageAccount.
Nom de l’espace de travail quantique à créer, par exemple MyQuantumWorkspace.
Liste des fournisseurs Azure Quantum à utiliser dans l’espace de travail. Un fournisseur propose un ensemble de plans, chacun représentant un plan auquel sont associés des conditions générales, des coûts et des quotas. Pour créer des espaces de travail, vous devez spécifier le plan correspondant ainsi que les fournisseurs, sauf si vous souhaitez commencer par les fournisseurs qui offrent un crédit gratuit : ils sont automatiquement ajoutés à votre espace de travail.

Si vous connaissez déjà les noms du fournisseur et du plan à utiliser dans votre espace de travail, vous pouvez passer à l’étape 4 ci-dessous. Si vous souhaitez commencer avec les fournisseurs qui offrent un crédit gratuit, vous pouvez entrer la commande suivante :

az quantum workspace create \
   -l MyLocation \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyStorageAccount

Vous pouvez être invité à accepter les conditions d’utilisation. Entrez Y pour accepter les conditions générales. Notez que le paramètre -r à l’étape quatre, ci-dessous, n’était pas obligatoire.

Si vous devez déterminer les fournisseurs et les plans à utiliser, procédez comme suit :

Pour récupérer la liste des fournisseurs Quantum disponibles, utilisez la commande list (cet exemple utilise westus comme région) :
```
az quantum offerings list \
     -l westus \
     -o table
```
Conseil

Si vous souhaitez voir quels fournisseurs donnent un crédit gratuit, utilisez le paramètre --autoadd-only, par exemple :
az quantum offerings list --autoadd-only -l westus -o table
Comme mentionné précédemment, ces fournisseurs sont automatiquement ajoutés à votre espace de travail. Vous n’avez pas besoin de les spécifier avec le paramètre -r.
Après avoir déterminé le fournisseur et le plan à inclure dans votre espace de travail, vous pouvez consulter les conditions à l’aide de la commande show-terms (en ajoutant MyProviderID et MyPlan comme exemples de valeurs) :
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
La sortie de la commande show-terms ci-dessus comprend un champ booléen accepted qui indique si les termes de ce fournisseur ont déjà été acceptés ou non ainsi qu’un lien vers les termes du contrat de licence à consulter. Si vous décidez d’accepter ces termes, utilisez la commande accept-terms pour enregistrer votre acceptation.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Après avoir consulté et accepté l’ensemble des conditions générales nécessaires, vous pouvez créer votre espace de travail à l’aide de la commande create en spécifiant une liste de combinaisons de fournisseurs et de plans séparées par des virgules, comme dans l’exemple suivant :
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Une fois que vous avez créé un espace de travail, vous pouvez toujours ajouter ou supprimer des fournisseurs à l’aide de la Portail Azure.

Modifier le compte de stockage par défaut pour un espace de travail quantique

Si vous souhaitez modifier le compte de stockage par défaut pour un espace de travail existant, vous pouvez utiliser la commande create en spécifiant toutes les propriétés actuelles ainsi que le nouveau compte de stockage. L’exemple suivant utilise les mêmes paramètres que ceux de l’espace de travail créé dans l’exemple précédent :

az quantum workspace create \
   -l westus \
   -g MyResourceGroup \
   -w MyQuantumWorkspace \
   -a MyNEWStorageAccount \
   -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"

Important

Cette procédure recrée l’espace de travail avec le nouveau compte de stockage. Vérifiez que toutes les propriétés autres que le compte de stockage sont exactement identiques à l’original, sinon un deuxième espace de travail est créé.

Supprimer un espace de travail quantique

Si vous connaissez le nom et le groupe de ressources d’un espace de travail quantique que vous souhaitez supprimer, vous pouvez le faire avec la commande delete (en utilisant les mêmes noms que dans l’exemple précédent) :

az quantum workspace delete \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

Conseil

Si vous ne vous souvenez pas du nom exact, vous pouvez afficher la liste complète des espaces de travail quantiques associés à votre abonnement à l’aide de la commande az quantum workspace list -o table.

Une fois que vous avez supprimé un espace de travail, il est toujours répertorié pendant sa suppression dans le cloud. Toutefois, la propriété provisioningState de l’espace de travail change immédiatement pour indiquer la suppression. Vous pouvez voir ces informations en utilisant la commande show suivante :

az quantum workspace show \
   -g MyResourceGroup \
   -w MyQuantumWorkspace

Notes

Si vous avez déjà utilisé la commande az quantum workspace set pour spécifier un espace de travail quantique par défaut, vous pouvez alors appeler la commande delete sans paramètre pour supprimer (et effacer) l’espace de travail par défaut.

az quantum workspace delete

Étapes suivantes

Maintenant que vous pouvez créer et supprimer des espaces de travail, découvrez les différents targets à exécuter des algorithmes quantiques dans Azure Quantum.