Gerir áreas de trabalho quânticas com a CLI do Azure

Artigo
08/19/2024

Neste guia, saiba como utilizar a Interface de Command-Line do Azure (CLI do Azure) para criar áreas de trabalho do Azure Quantum e os grupos de recursos e contas de armazenamento necessários e começar a executar as suas aplicações quânticas no Azure Quantum.

Pré-requisitos

Para utilizar o serviço Azure Quantum, precisa de:

Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta do Azure, registe-se gratuitamente e inscreva-se numa subscrição pay as you go.
Um grupo de recursos do Azure onde reside a área de trabalho quântica.
Uma conta de armazenamento no grupo de recursos a associar à área de trabalho quântica. Várias áreas de trabalho podem ser associadas à mesma conta.
CLI do Azure.
A Microsoft Quantum Development Kit.

Configuração de ambiente

Instale a extensão da CLI quantum do Azure. Abra uma linha de comandos e execute o seguinte comando, que também atualiza a extensão se uma versão anterior já estiver instalada:
```
az extension add --upgrade -n quantum
```
Inicie sessão no Azure com as suas credenciais. Verá uma lista de subscrições associadas à sua conta.
```
az login
```
Especifique a subscrição que pretende utilizar.
```
az account set -s <Your subscription ID>
```
Se esta for a primeira vez que cria áreas de trabalho quânticas na sua subscrição, registe o fornecedor de recursos com este comando:
```
az provider register --namespace Microsoft.Quantum
```

Criar uma área de trabalho do Azure Quantum

Para criar uma nova área de trabalho do Azure Quantum, tem de saber:

A localização ou o nome da região do Azure onde o recurso irá residir. Pode utilizar a lista de regiões e os respetivos códigos do resource manager suportados pela ferramenta da CLI do Azure, por exemplo , westus.
O grupo de recursos associado à nova área de trabalho, por exemplo , MyResourceGroup.
Uma conta de armazenamento no mesmo grupo de recursos e subscrição que a área de trabalho quântica. É possível criar uma nova conta de armazenamento a partir da ferramenta da CLI do Az, por exemplo, MyStorageAccount.
O nome da área de trabalho quântica a criar, por exemplo, MyQuantumWorkspace.
A lista de fornecedores do Azure Quantum a utilizar na área de trabalho. Um fornecedor oferece um conjunto de planos, cada um deles representando um plano com termos e condições, custos e quotas associados. Para criar áreas de trabalho, tem de especificar o plano correspondente juntamente com os fornecedores, a menos que queira começar com os fornecedores que oferecem crédito gratuito – estes são automaticamente adicionados à sua área de trabalho.

Se já souber os nomes do fornecedor e do plano a utilizar na área de trabalho, pode avançar para o passo quatro abaixo. Se quiser começar com os fornecedores que oferecem crédito gratuito, pode introduzir o seguinte comando:

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

Poderá ser-lhe pedido que aceite os termos de utilização. Introduza Y para aceitar os termos. Tenha em atenção que o -r parâmetro mostrado no passo quatro, abaixo, não era obrigatório.

Se precisar de determinar quais os fornecedores e planos a utilizar, proceda da seguinte forma:

Para obter a lista de fornecedores quânticos disponíveis, utilize o list comando (este exemplo utiliza westus como a localização):
```
az quantum offerings list \
     -l westus \
     -o table
```
Dica

Se quiser ver que fornecedores dão crédito gratuito, utilize o --autoadd-only parâmetro, por exemplo:
az quantum offerings list --autoadd-only -l westus -o table
Conforme mencionado anteriormente, esses fornecedores são adicionados automaticamente à sua área de trabalho. Não precisa de especificá-los com o -r parâmetro .
Depois de determinar o fornecedor e planear incluir na área de trabalho, pode rever os termos com o comando (adicionar os show-terms valores MyProviderID e MyPlan como exemplo):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
O resultado do show-terms comando inclui um campo accepted Booleano que mostra se os termos para este fornecedor já foram aceites ou não, bem como uma ligação para os termos de licenciamento a rever. Se decidir aceitar esses termos, utilize o accept-terms comando para registar a sua aceitação.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Depois de rever e aceitar todos os termos e condições necessários, pode criar a área de trabalho com o create comando , especificando uma lista de combinações de fornecedores e planos separadas por vírgulas, como no exemplo seguinte:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Depois de criar uma área de trabalho, ainda pode adicionar ou remover fornecedores com o portal do Azure.

Alterar a conta de armazenamento predefinida para uma área de trabalho quântica

Se precisar de alterar a conta de armazenamento predefinida de uma área de trabalho existente, pode utilizar o create comando e especificar todas as propriedades atuais juntamente com a nova conta de armazenamento. O exemplo seguinte utiliza as mesmas definições que a área de trabalho criada no exemplo anterior:

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

Importante

Este procedimento recria a área de trabalho com a nova conta de armazenamento. Certifique-se de que todas as propriedades que não a conta de armazenamento são exatamente as mesmas que as originais. Caso contrário, é criada uma segunda área de trabalho.

Eliminar uma área de trabalho quântica

Se souber o nome e o grupo de recursos de uma área de trabalho quântica que pretende eliminar, pode fazê-lo com o delete comando (com os mesmos nomes do exemplo anterior):

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

Dica

Se não se lembrar do nome exato, pode ver toda a lista de áreas de trabalho quânticas na sua subscrição com az quantum workspace list -o table.

Depois de eliminar uma área de trabalho, esta continua listada enquanto está a ser eliminada na cloud. No entanto, a provisioningState propriedade da área de trabalho muda imediatamente para indicar que está a ser eliminada. Pode ver estas informações com o show comando :

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

Nota

Caso tenha utilizado o az quantum workspace set comando anteriormente para especificar uma área de trabalho quântica predefinida, pode chamar o delete comando sem parâmetros para eliminar (e limpar) a área de trabalho predefinida.

az quantum workspace delete

Passos seguintes

Agora que pode criar e eliminar áreas de trabalho, saiba mais sobre os diferentes targets para executar algoritmos quânticos no Azure Quantum.

Partilhar via