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

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

Предпосылки

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

• Учетная запись Azure с активной подпиской. Если у вас нет учетной записи Azure, зарегистрируйтесь бесплатно и зарегистрируйтесь для подписки с оплатой по мере использования.
• Группа ресурсов Azure, в которой расположена квантовая рабочая область.
• Учетная запись хранения в группе ресурсов, связанная с квантовой рабочей областью. Несколько рабочих областей могут быть связаны с одной учетной записью.
• Azure CLI.
• Корпорация МайкрософтQuantum Development Kit.

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

1. Установите расширение Azure CLI quantum . Откройте командную строку и выполните следующую команду, которая также обновляет расширение, если предыдущая версия уже установлена:

   az extension add --upgrade -n quantum
   

2. Войдите в Azure с помощью учетных данных. Вы увидите список подписок, связанных с вашей учетной записью.

   az login
   

3. Укажите подписку, которую вы хотите использовать.

   az account set -s <Your subscription ID>
   

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

   az provider register --namespace Microsoft.Quantum
   

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

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

• Расположение или имя региона Azure для создания ресурса. Вы можете использовать список кодов диспетчера ресурсов по регионам, поддерживаемый инструментом 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 на шаге четыре ниже, не требуется.

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

1. Чтобы получить список доступных квантовых поставщиков, используйте list команду (в этом примере используется westus в качестве расположения):

   az quantum offerings list \
        -l westus \
        -o table
   

   Подсказка

   Если вы хотите узнать, какие поставщики предоставляют бесплатные --autoadd-only кредиты, используйте этот параметр, например:
   az quantum offerings list --autoadd-only -l westus -o table
   Как упоминалось ранее, эти поставщики автоматически добавляются в рабочую область. Нет необходимости указывать их с параметром -r.

2. После определения поставщика и плана для включения в вашу рабочую среду можно просмотреть условия с помощью команды show-terms (добавив MyProviderID и MyPlan в качестве примеров значений).

   az quantum offerings show-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

3. Выходные данные show-terms команды включают логическое поле accepted , которое показывает, были ли условия для этого поставщика приняты уже или нет, а также ссылку на условия лицензионного соглашения для проверки. Если вы решите принять эти условия, используйте accept-terms команду для записи принятия.

   az quantum offerings accept-terms \
        -l westus \
        -p MyProviderId \
        -k MyPlan
   

4. После проверки и принятия всех необходимых условий можно создать рабочую область с помощью 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

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

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

az quantum workspace delete

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

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