Správa kvantových pracovních prostorů pomocí Azure CLI

Článek
08/19/2024

V této příručce se naučíte používat rozhraní Azure Command-Line (Azure CLI) k vytvoření pracovních prostorů Azure Quantum a požadovaných skupin prostředků a účtů úložiště a spuštění kvantových aplikací v Azure Quantum.

Požadavky

Abyste mohli službu Azure Quantum používat, potřebujete:

Účet Azure s aktivním předplatným. Pokud nemáte účet Azure, zaregistrujte se zdarma a zaregistrujte si předplatné s průběžnými platbou.
Skupina prostředků Azure, ve které se nachází kvantový pracovní prostor.
Účet úložiště ve skupině prostředků, který bude přidružený k kvantovému pracovnímu prostoru. Ke stejnému účtu je možné přidružit více pracovních prostorů.
Rozhraní příkazového řádku Azure.
Microsoft Quantum Development Kit.

Nastavení prostředí

Nainstalujte rozšíření Azure CLI quantum . Otevřete příkazový řádek a spusťte následující příkaz, který také upgraduje rozšíření, pokud už je nainstalovaná předchozí verze:
```
az extension add --upgrade -n quantum
```
Přihlaste se k Azure pomocí svých přihlašovacích údajů. Zobrazí se seznam předplatných přidružených k vašemu účtu.
```
az login
```
Zadejte předplatné, které chcete použít.
```
az account set -s <Your subscription ID>
```
Pokud ve vašem předplatném vytváříte kvantové pracovní prostory poprvé, zaregistrujte poskytovatele prostředků pomocí tohoto příkazu:
```
az provider register --namespace Microsoft.Quantum
```

Vytvoření pracovního prostoru Azure Quantum

Pokud chcete vytvořit nový pracovní prostor Azure Quantum, potřebujete vědět:

Umístění nebo název oblasti Azure, ve které bude prostředek žít. Můžete použít seznam oblastí a jejich kódy Resource Manageru podporované nástrojem Azure CLI, například westus.
Skupina prostředků přidružená k novému pracovnímu prostoru, například MyResourceGroup.
Účet úložiště ve stejné skupině prostředků a předplatném jako kvantový pracovní prostor. Nový účet úložiště je možné vytvořit pomocí nástroje Az CLI, například MyStorageAccount.
Název kvantového pracovního prostoru, který se má vytvořit, například MyQuantumWorkspace.
Seznam poskytovatelů Azure Quantum, kteří se mají použít v pracovním prostoru. Poskytovatel nabízí sadu plánů, z nichž každý představuje plán s přidruženými podmínkami, náklady a kvótami. Pokud chcete vytvořit pracovní prostory, musíte zadat odpovídající plán spolu s poskytovateli, pokud nechcete začít s poskytovateli, kteří nabízejí bezplatný kredit – automaticky se přidají do vašeho pracovního prostoru.

Pokud už znáte názvy poskytovatelů a plánů, které se mají použít ve vašem pracovním prostoru, můžete přeskočit ke kroku 4 níže. Pokud chcete začít s poskytovateli, kteří nabízejí bezplatný kredit, můžete zadat následující příkaz:

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

Může se zobrazit výzva k přijetí podmínek použití. Zadáním Y příkazu přijměte podmínky. Všimněte si -r , že parametr uvedený v kroku 4 níže nebyl povinný.

Pokud potřebujete určit, které poskytovatele a plány použít, postupujte takto:

Pokud chcete načíst seznam dostupných kvantových zprostředkovatelů, použijte list příkaz (v tomto příkladu se jako umístění používá westus ):
```
az quantum offerings list \
     -l westus \
     -o table
```
Tip

Pokud chcete zjistit, kteří poskytovatelé poskytují bezplatný kredit, použijte --autoadd-only parametr , například:
az quantum offerings list --autoadd-only -l westus -o table
Jak už jsme zmínili, tito poskytovatelé se automaticky přidají do vašeho pracovního prostoru. Nemusíte je zadávat pomocí parametru -r .
Jakmile určíte poskytovatele a plánujete zahrnout do pracovního prostoru, můžete zkontrolovat termíny pomocí show-terms příkazu (jako příklad přidejte hodnoty MyProviderID a MyPlan ):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Výstup show-terms příkazu obsahuje logické pole accepted , které ukazuje, jestli už byly podmínky pro tohoto poskytovatele přijaty, nebo ne, a také odkaz na licenční podmínky ke kontrole. Pokud se rozhodnete tyto podmínky přijmout, zaznamenejte své přijetí pomocí accept-terms příkazu .
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Jakmile si projdete a přijmete všechny požadované podmínky a ujednání, můžete vytvořit pracovní prostor pomocí create příkazu a zadat seznam kombinací poskytovatelů a plánů oddělených čárkami, jako v následujícím příkladu:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Po vytvoření pracovního prostoru můžete stále přidávat nebo odebírat poskytovatele pomocí Azure Portal.

Změna výchozího účtu úložiště pro kvantový pracovní prostor

Pokud potřebujete změnit výchozí účet úložiště pro existující pracovní prostor, můžete použít create příkaz , který spolu s novým účtem úložiště zadá všechny aktuální vlastnosti. Následující příklad používá stejné nastavení jako pracovní prostor vytvořený v předchozím příkladu:

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

Důležité

Tímto postupem se pracovní prostor ve skutečnosti znovu vytvoří s novým účtem úložiště. Ujistěte se, že všechny vlastnosti kromě účtu úložiště jsou přesně stejné jako původní, jinak se vytvoří druhý pracovní prostor.

Odstranění kvantového pracovního prostoru

Pokud znáte název a skupinu prostředků kvantového pracovního prostoru, který chcete odstranit, můžete to udělat pomocí delete příkazu (se stejnými názvy jako v předchozím příkladu):

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

Tip

Pokud si nepamatujete přesný název, můžete pomocí příkazu zobrazit celý seznam kvantových pracovních prostorů ve vašem předplatném az quantum workspace list -o table.

Po odstranění se pracovní prostor stále zobrazuje, i když se odstraňuje v cloudu. Vlastnost pracovního prostoru se ale okamžitě změní, provisioningState což znamená, že se pracovní prostor odstraňuje. Tyto informace můžete zobrazit pomocí show příkazu :

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

Poznámka

Pokud jste dříve použili az quantum workspace set příkaz k určení výchozího kvantového pracovního prostoru, můžete voláním delete příkazu bez parametrů odstranit (a vymazat) výchozí pracovní prostor.

az quantum workspace delete

Další kroky

Když teď můžete vytvářet a odstraňovat pracovní prostory, seznamte se s různými targets způsoby spouštění kvantových algoritmů v Azure Quantum.

Sdílet prostřednictvím