Gerenciar workspaces do Quantum com a CLI do Azure

Artigo
08/19/2024

Neste guia, aprenda a usar a CLI do Azure (Interface de Linha de Comando do Azure) para criar workspaces no Azure Quantum e os grupos de recursos e contas de armazenamento necessários e comece a executar seus aplicativos quantum no Azure Quantum.

Pré-requisitos

Para usar o serviço do Azure Quantum, você precisa de:

Uma conta do Azure com uma assinatura ativa. Se você não tiver uma conta do Azure, registre-se gratuitamente e inscreva-se em uma assinatura paga conforme o uso.
Um grupo de recursos do Azure no qual reside o workspace quântico.
Uma conta de armazenamento no grupo de recursos a ser associada ao workspace do Quantum. Vários workspaces podem ser associados à mesma conta.
O CLI do Azure.
O Microsoft Quantum Development Kit.

Configuração do ambiente

Instale a extensão quantum da CLI do Azure. Abra um prompt de comando e execute o seguinte comando, que também atualizará a extensão se uma versão anterior já estiver instalada:
```
az extension add --upgrade -n quantum
```
Faça logon no Azure usando suas credenciais. Você verá uma lista de assinaturas associadas à sua conta.
```
az login
```
Especifique a assinatura que você quer usar.
```
az account set -s <Your subscription ID>
```
Se esta for a primeira vez que você cria workspaces do Quantum em sua assinatura, registre o provedor de recursos com este comando:
```
az provider register --namespace Microsoft.Quantum
```

Criar um workspace do Azure Quantum

Para criar um workspace do Azure Quantum, você precisa saber:

O local ou o nome da região do Azure em que o recurso residirá. Você pode usar a lista de regiões e seus códigos do gerenciador de recursos compatíveis com a ferramenta CLI do Azure, por exemplo, westus.
O grupo de recursos associado ao novo workspace, por exemplo, MyResourceGroup.
Uma conta de armazenamento no mesmo grupo de recursos e assinatura como o workspace do Quantum. É possível criar uma conta de armazenamento por meio da ferramenta Az CLI, por exemplo, MyStorageAccount.
O nome do workspace do Quantum a ser criado, por exemplo, MyQuantumWorkspace.
A lista de provedores do Azure Quantum para usar no espaço de trabalho. Um provedor oferece um conjunto de planos, cada um dos quais representa um plano com termos e condições associados, custos e cotas. Para criar workspaces, você precisa especificar o plano correspondente junto com os provedores, a menos que você queira começar com os provedores que oferecem crédito gratuito– eles são adicionados automaticamente ao seu workspace.

Se você já souber os nomes do provedor e do plano a serem usados no workspace, prossiga para a etapa quatro, abaixo. Se você quiser começar com os provedores que oferecem crédito gratuito, insira o seguinte comando:

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

Talvez seja solicitado que você aceite os termos de uso. Insira Y para aceitar os termos. Observe que o parâmetro -r mostrado na etapa quatro, abaixo, não era necessário.

Se você precisar determinar quais provedores e planos usar, prossiga da seguinte maneira:

Para recuperar a lista de provedores quantum disponíveis, use o comando list (este exemplo usa westus como o local):
```
az quantum offerings list \
     -l westus \
     -o table
```
Dica

Se quiser ver quais provedores dão crédito gratuito, use o parâmetro --autoadd-only, por exemplo:
az quantum offerings list --autoadd-only -l westus -o table
Conforme mencionado anteriormente, esses provedores são adicionados automaticamente ao seu workspace. Você não precisa especificá-los com o parâmetro -r.
Depois de determinar o provedor e o plano a serem incluídos no workspace, revise os termos usando o comando show-terms (adicionando o seu MyProviderID e MyPlan como valores de exemplo):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
A saída do comando show-terms inclui um campo booliano accepted que mostra se os termos deste provedor já foram aceitos ou não, bem como um link para os termos de licença a serem analisados. Se você decidir aceitar esses termos, use o comando accept-terms a seguir para registrar o seu aceite.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Depois de revisar e aceitar todos os termos e as condições necessárias, crie seu workspace usando o comando create, especificando uma lista de combinações de provedor e planos separados por vírgulas, como no exemplo abaixo:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Depois de criar um workspace, você ainda poderá adicionar ou remover provedores usando o portal do Azure.

Alterar a conta de armazenamento padrão para um workspace do Quantum

Se precisar alterar a conta de armazenamento padrão de um workspace existente, você poderá usar o comando create, especificando todas as propriedades atuais juntamente com a nova conta de armazenamento. O exemplo seguinte usa as mesmas configurações que o workspace criado no exemplo anterior:

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

Importante

Esse procedimento realmente recria o workspace com a nova conta de armazenamento. Verifique se todas as propriedades diferentes da conta de armazenamento são exatamente iguais às originais; caso contrário, um segundo workspace será criado.

Excluir um workspace do Quantum

Se souber o nome e o grupo de recursos do workspace do Quantum que deseja excluir, você poderá fazê-lo com o comando delete (usando os mesmos nomes que o exemplo anterior):

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

Dica

Se você não se lembrar do nome exato, visualize a lista completa de workspaces do Quantum na sua assinatura usando az quantum workspace list -o table.

Depois de excluir um workspace, ele ainda será listado enquanto ele estiver sendo excluído na nuvem. No entanto, a propriedade provisioningState do workspace será alterada imediatamente para indicar que ele está sendo excluído. É possível visualizar essas informações usando o comando show:

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

Observação

Caso você tenha usado o comando az quantum workspace set anteriormente para especificar um workspace do Quantum padrão, chame o comando delete sem os parâmetros para excluir (e limpar) o workspace padrão.

az quantum workspace delete

Próximas etapas

Agora que você pode criar e excluir workspaces, saiba mais sobre o diferente targets para executar algoritmos quânticos no Azure Quantum.

Compartilhar via