Gestire le aree di lavoro di calcolo quantistico con l'interfaccia della riga di comando di Azure

Articolo
10/26/2023

In questa guida si apprenderà come usare l'interfaccia della riga di comando di Azure per creare aree di lavoro di Azure Quantum con i gruppi di risorse e gli account di archiviazione necessari, oltre a come iniziare a eseguire le applicazioni quantistiche in Azure Quantum.

Prerequisiti

Per usare il servizio Azure Quantum, è necessario:

Un account Azure con una sottoscrizione attiva. Se non si ha un account Azure, registrarsi gratuitamente e iscriversi per ottenere una sottoscrizione con pagamento in base al consumo.
Un gruppo di risorse di Azure in cui risiede l'area di lavoro quantistica.
Un account di archiviazione nel gruppo di risorse da associare all'area di lavoro di calcolo quantistico. Più aree di lavoro possono essere associate allo stesso account.
Interfaccia della riga di comando di Azure.
Quantum Development KitMicrosoft .

Configurazione dell'ambiente

Installare l'estensione quantum per l'interfaccia della riga di comando di Azure. Aprire un prompt dei comandi ed eseguire il comando seguente, che aggiorna anche l'estensione se è già installata una versione precedente:
```
az extension add --upgrade -n quantum
```
Accedere ad Azure con le credenziali personali. Viene visualizzato un elenco di sottoscrizioni associate all'account.
```
az login
```
Specificare la sottoscrizione che si vuole usare.
```
az account set -s <Your subscription ID>
```
Se è la prima volta che si creano aree di lavoro di calcolo quantistico nella sottoscrizione, registrare il provider di risorse con questo comando:
```
az provider register --namespace Microsoft.Quantum
```

Creare un'area di lavoro di Azure Quantum

Per creare una nuova area di lavoro di Azure Quantum, è necessario conoscere:

Posizione o nome dell'area di Azure in cui verrà creata la risorsa. È possibile usare l'elenco delle aree e i relativi codici di Resource Manager supportati dallo strumento dell'interfaccia della riga di comando di Azure, ad esempio westus.
Gruppo di risorse associato alla nuova area di lavoro, ad esempio MyResourceGroup.
Un account di archiviazione nello stesso gruppo di risorse e nella stessa sottoscrizione dell'area di lavoro di calcolo quantistico. È possibile creare un nuovo account di archiviazione dallo strumento dell'interfaccia della riga di comando di Azure, ad esempio MyStorageAccount.
Nome dell'area di lavoro di calcolo quantistico da creare, ad esempio MyQuantumWorkspace.
Elenco di provider Azure Quantum da usare nell'area di lavoro. Un provider offre un set di piani, ognuno dei quali rappresenta un piano con termini e condizioni, costi e quote associati. Per creare aree di lavoro, è necessario specificare il piano corrispondente insieme ai provider, a meno che non si voglia iniziare con i provider che offrono credito gratuito, vengono aggiunti automaticamente all'area di lavoro.

Se il provider e i nomi dei piani da usare nell'area di lavoro sono già noti, è possibile passare al passaggio 4, di seguito. Se si vuole iniziare con i provider che offrono credito gratuito, è possibile immettere il comando seguente:

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

Potrebbe essere richiesto di accettare le condizioni per l'utilizzo. Immettere Y per accettare le condizioni. Si noti che il -r parametro illustrato nel passaggio 4, di seguito, non è necessario.

Se è necessario determinare quali provider e piani usare, procedere come segue:

Per recuperare l'elenco dei provider quantistici disponibili, usare il comando list (in questo esempio viene usata la posizione westus):
```
az quantum offerings list \
     -l westus \
     -o table
```
Suggerimento

Se si vuole vedere quali provider offrono credito gratuito, usare il --autoadd-only parametro , ad esempio:
az quantum offerings list --autoadd-only -l westus -o table
Come accennato in precedenza, questi provider vengono aggiunti automaticamente all'area di lavoro. Non è necessario specificarli con il -r parametro .
Dopo aver determinato il provider e il piano da includere nell'area di lavoro, è possibile esaminare le condizioni usando il comando show-terms (aggiungendo MyProviderID e MyPlan come valori di esempio):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
L'output del comando show-terms include un campo booleano accepted che indica se le condizioni per questo provider sono già state accettate o meno, oltre a includere un collegamento alle condizioni di licenza da esaminare. Se si decide di accettare tali condizioni, usare il comando accept-terms per registrare l'accettazione.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Dopo aver esaminato e accettato tutti i termini e le condizioni necessari, è possibile creare l'area di lavoro usando il comando create, specificando un elenco di combinazioni di provider e piani separati da virgole, come nell'esempio seguente:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Dopo aver creato un'area di lavoro, è comunque possibile aggiungere o rimuovere provider usando il portale di Azure.

Modificare l'account di archiviazione predefinito per un'area di lavoro quantistica

Se è necessario modificare l'account di archiviazione predefinito per un'area di lavoro esistente, è possibile usare il create comando , specificando tutte le proprietà correnti insieme al nuovo account di archiviazione. Nell'esempio seguente vengono usate le stesse impostazioni dell'area di lavoro creata nell'esempio precedente:

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

Importante

Questa procedura crea di nuovo l'area di lavoro con il nuovo account di archiviazione. Assicurarsi che tutte le proprietà diverse dall'account di archiviazione corrispondano esattamente all'originale. In caso contrario, viene creata una seconda area di lavoro.

Eliminare un'area di lavoro di calcolo quantistico

Se si conosce il nome e il gruppo di risorse di un'area di lavoro quantistica da eliminare, è possibile farlo con il delete comando (usando gli stessi nomi dell'esempio precedente):

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

Suggerimento

Se non si ricorda il nome esatto, è possibile visualizzare l'intero elenco delle aree di lavoro di calcolo quantistico nella sottoscrizione usando az quantum workspace list -o table.

Dopo aver eliminato un'area di lavoro, l'area di lavoro è ancora elencata mentre viene eliminata nel cloud. Tuttavia, la proprietà provisioningState dell'area di lavoro cambia immediatamente per indicare che è in corso l'eliminazione. È possibile visualizzare queste informazioni usando il comando show:

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

Nota

Se il comando az quantum workspace set è stato usato in precedenza per specificare un'area di lavoro di calcolo quantistico predefinita, è possibile chiamare il comando delete senza parametri per eliminare (e cancellare) l'area di lavoro predefinita.

az quantum workspace delete

Passaggi successivi

Ora che è possibile creare ed eliminare aree di lavoro, è possibile ottenere informazioni sui diversi targets algoritmi quantistici in Azure Quantum.

Share via