Hantera kvantarbetsytor med Azure CLI

Artikel
10/28/2023

I den här guiden lär du dig att använda Azure Command-Line Interface (Azure CLI) för att skapa Azure Quantum-arbetsytor och nödvändiga resursgrupper och lagringskonton och börja köra kvantprogram i Azure Quantum.

Förutsättningar

Om du vill använda Azure Quantum-tjänsten behöver du:

Ett Azure-konto med en aktiv prenumeration. Om du inte har något Azure-konto kan du registrera dig kostnadsfritt och registrera dig för en betala per användning-prenumeration.
En Azure-resursgrupp där kvantarbetsytan finns.
Ett lagringskonto i resursgruppen som ska associeras med kvantarbetsytan. Flera arbetsytor kan associeras med samma konto.
Azure CLI.
Microsoft Quantum Development Kit.

Miljökonfiguration

Installera Azure CLI-tillägget quantum . Öppna en kommandotolk och kör följande kommando, som även uppgraderar tillägget om en tidigare version redan är installerad:
```
az extension add --upgrade -n quantum
```
Logga in på Azure med dina autentiseringsuppgifter. Du ser en lista över prenumerationer som är associerade med ditt konto.
```
az login
```
Ange den prenumeration som du vill använda.
```
az account set -s <Your subscription ID>
```
Om det är första gången du skapar kvantarbetsytor i din prenumeration registrerar du resursprovidern med det här kommandot:
```
az provider register --namespace Microsoft.Quantum
```

Skapa en Azure Quantum-arbetsyta

Om du vill skapa en ny Azure Quantum-arbetsyta behöver du veta:

Platsen eller Azure-regionens namn där resursen ska finnas. Du kan använda listan över regioner och deras resource manager-koder som stöds av Azure CLI-verktyget, till exempel westus.
Den resursgrupp som är associerad med den nya arbetsytan, till exempel MyResourceGroup.
Ett lagringskonto i samma resursgrupp och prenumeration som kvantarbetsytan. Det går att skapa ett nytt lagringskonto från Az CLI-verktyget, till exempel MyStorageAccount.
Namnet på den kvantarbetsyta som ska skapas, till exempel MyQuantumWorkspace.
Listan över Azure Quantum-providers som ska användas på arbetsytan. En leverantör erbjuder en uppsättning planer som var och en representerar en plan med tillhörande villkor, kostnader och kvoter. Om du vill skapa arbetsytor måste du ange motsvarande plan tillsammans med leverantörerna, såvida du inte vill börja med de leverantörer som erbjuder kostnadsfri kredit – de läggs automatiskt till på din arbetsyta.

Om du redan känner till provider- och plannamnen som ska användas på din arbetsyta kan du gå vidare till steg fyra nedan. Om du vill börja med de leverantörer som erbjuder kostnadsfri kredit kan du ange följande kommando:

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

Du kan uppmanas att godkänna användningsvillkoren. Ange Y för att godkänna villkoren. Observera att parametern -r som visas i steg fyra, nedan, inte krävdes.

Om du behöver avgöra vilka leverantörer och planer som ska användas fortsätter du på följande sätt:

Om du vill hämta listan över tillgängliga kvantprovidrar använder du list kommandot (i det här exemplet används westus som plats):
```
az quantum offerings list \
     -l westus \
     -o table
```
Tips

Om du vill se vilka leverantörer som ger kostnadsfri kredit använder du parametern --autoadd-only , till exempel:
az quantum offerings list --autoadd-only -l westus -o table
Som tidigare nämnts läggs dessa leverantörer automatiskt till i din arbetsyta. Du behöver inte ange dem med parametern -r .
När du har fastställt providern och planerar att inkludera i din arbetsyta kan du granska villkoren med kommandot show-terms (lägga till myproviderID och MyPlan som exempelvärden):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Utdata från show-terms kommandot innehåller ett booleskt fält accepted som visar om villkoren för den här providern redan har accepterats eller inte, samt en länk till de licensvillkor som ska granskas. Om du bestämmer dig för att godkänna dessa villkor använder accept-terms du kommandot för att registrera ditt godkännande.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
När du har granskat och accepterat alla obligatoriska villkor kan du skapa din arbetsyta med kommandot create och ange en lista över kombinationer av provider och abonnemang avgränsade med kommatecken, som i följande exempel:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

När du har skapat en arbetsyta kan du fortfarande lägga till eller ta bort leverantörer med hjälp av Azure Portal.

Ändra standardlagringskontot för en kvantarbetsyta

Om du behöver ändra standardlagringskontot för en befintlig arbetsyta kan du använda create kommandot och ange alla aktuella egenskaper tillsammans med det nya lagringskontot. I följande exempel används samma inställningar som arbetsytan som skapades i föregående exempel:

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

Viktigt

Den här proceduren återskapar faktiskt arbetsytan med det nya lagringskontot. Kontrollera att alla andra egenskaper än lagringskontot är exakt samma som originalet, annars skapas en andra arbetsyta.

Ta bort en kvantarbetsyta

Om du känner till namnet och resursgruppen för en kvantarbetsyta som du vill ta bort kan du göra det med delete kommandot (med samma namn som i föregående exempel):

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

Tips

Om du inte kommer ihåg det exakta namnet kan du visa hela listan över kvantarbetsytor i din prenumeration med hjälp av az quantum workspace list -o table.

När du har tagit bort en arbetsyta visas den fortfarande när den tas bort i molnet. Egenskapen för provisioningState arbetsytan ändras dock omedelbart för att indikera att den tas bort. Du kan se den här informationen med hjälp show av kommandot:

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

Anteckning

Om du tidigare använde az quantum workspace set kommandot för att ange en standardarbetsyta för kvantarbetsytan kan du anropa delete kommandot utan parametrar för att ta bort (och rensa) standardarbetsytan.

az quantum workspace delete

Nästa steg

Nu när du kan skapa och ta bort arbetsytor kan du lära dig mer om hur targets du kör kvantalgoritmer i Azure Quantum.

Share via