Управление квантовыми рабочими областями с помощью Azure CLI

Статья
08/19/2024

В этом руководстве содержатся сведения по использованию интерфейса командной строки Azure (Azure CLI) для создания рабочих областей Azure Quantum и необходимых групп ресурсов и учетных записей хранения, а также по запуску квантовых приложений в Azure Quantum.

Предварительные требования

Чтобы использовать службу Azure Quantum, вам потребуется:

Учетная запись Azure с активной подпиской. Если у вас нет учетной записи Azure, зарегистрируйтесь бесплатно и зарегистрируйтесь для получения подписки с оплатой по мере использования.
Группа ресурсов Azure, в которой находится квантовая рабочая область.
Учетная запись хранения в группе ресурсов, с которой будет связана квантовая рабочая область. С одной и той же учетной записью можно связать несколько рабочих областей.
Интерфейс командной строки Azure.
Microsoft Quantum Development Kit.

Настройка среды

Установите расширение Azure CLI quantum. Откройте командную строку и выполните следующую команду, которая также обновляет расширение, если уже установлена предыдущая версия:
```
az extension add --upgrade -n quantum
```
Войдите в Azure со своими учетными данными. Вы увидите список подписок, связанных с вашей учетной записью.
```
az login
```
Укажите подписку, которую требуется использовать.
```
az account set -s <Your subscription ID>
```
Если вы впервые создаете квантовые рабочие области в вашей подписке, зарегистрируйте поставщика ресурсов с помощью этой команды:
```
az provider register --namespace Microsoft.Quantum
```

Создание рабочей области Azure Quantum

Чтобы создать рабочую область Azure Quantum, необходимо знать следующее:

Расположение или имя региона Azure, в котором будет находиться ресурс. Можно использовать список регионов и их коды Resource Manager, поддерживаемые инструментом Azure CLI, например westus.
Группа ресурсов, связанная с новой рабочей областью, например MyResourceGroup.
Учетная запись хранения в той же группе ресурсов и подписке, что и квантовая рабочая область. Можно создать новую учетную запись хранения с помощью инструмента Az CLI, например MyStorageAccount.
Имя создаваемой квантовой рабочей области, например MyQuantumWorkspace.
Список поставщиков Azure Quantum для использования в рабочей области. Поставщик предлагает набор планов, каждый из которых представляет собой план со связанными условиями, затратами и квотами. Чтобы создать рабочие области, необходимо указать соответствующий план вместе с поставщиками, если вы не хотите начать с поставщиков, которые предлагают бесплатные кредиты— они автоматически добавляются в рабочую область.

Если вам уже известны поставщики и планы для использования в рабочей области, вы можете перейти к шагу 4 ниже. Если вы хотите начать с поставщиков, которые предлагают бесплатный кредит, можно ввести следующую команду:

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

Возможно, вам будет предложено принять условия использования. Чтобы принять условия, введите Y. Обратите внимание, что параметр -r, показанный на шаге 4 ниже, не является обязательным.

Если вам необходимо определить, каких поставщиков и какие планы использовать, выполните следующие действия:

Чтобы получить список доступных поставщиков квантовых вычислений, используйте команду list (в этом примере в качестве расположения используется westus).
```
az quantum offerings list \
     -l westus \
     -o table
```
Совет

Если вы хотите узнать, какие поставщики предоставляют бесплатный кредит, используйте параметр --autoadd-only, например:
az quantum offerings list --autoadd-only -l westus -o table
Как упоминалось ранее, эти поставщики автоматически добавляются в рабочую область. Их не нужно указывать в параметре -r.
После определения поставщика и плана для включения в рабочую область можно просмотреть условия с помощью команды show-terms (добавив в качестве примеров значений MyProviderID и MyPlan).
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Выходные данные команды show-terms включают логическое поле accepted, которое показывает, приняты ли уже условия для этого поставщика или нет, а также ссылку на условия лицензии для ознакомления. Если вы решите принять эти условия, используйте команду accept-terms, чтобы записать свое согласие.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
После просмотра и принятия всех необходимых положений и условий можно создать рабочую область с помощью команды create, указав список комбинаций поставщиков и планов, разделенных запятыми, как в следующем примере.
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

После создания рабочей области вы по-прежнему можете добавлять или удалять поставщиков с помощью портал Azure.

Изменение учетной записи хранения по умолчанию для квантовой рабочей области

Если необходимо изменить учетную запись хранения по умолчанию для существующей рабочей области, можно использовать команду create, указав все текущие свойства вместе с новой учетной записью хранения. В следующем примере используются те же параметры, что и для создания рабочей области в предыдущем примере:

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

Важно!

Эта процедура фактически повторно создает рабочую область с новой учетной записью хранения. Убедитесь, что все свойства, отличные от учетной записи хранения, точно совпадают с исходными. В противном случае создается вторая рабочая область.

Удаление квантовой рабочей области

Если вам известны имя и группа ресурсов квантовой рабочей области, которую требуется удалить, вы можете удалить рабочую область с помощью команды delete (используя те же имена, что и в предыдущем примере).

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

Совет

Если вы не помните точное имя, то можете просмотреть весь список квантовых рабочих областей в вашей подписке, выполнив команду az quantum workspace list -o table.

После удаления рабочей области она по-прежнему отображается в списке, пока она удаляется в облаке. Однако свойство provisioningState рабочей области немедленно изменяется, что указывает на удаление этой рабочей области. Можно просмотреть эту информацию, используя команду show.

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

Примечание

Если вы ранее использовали команду az quantum workspace set для указания квантовой рабочей области по умолчанию, то можно вызвать команду delete без параметров, чтобы удалить (и очистить) рабочую область по умолчанию.

az quantum workspace delete

Дальнейшие действия

Теперь, когда вы можете создавать и удалять рабочие области, ознакомьтесь с различными targets квантовыми алгоритмами в Azure Quantum.

Поделиться через