Gerenciar workspaces do Quantum com a CLI do Azure

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

1. 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
   

2. Faça logon no Azure usando suas credenciais. Você verá uma lista de assinaturas associadas à sua conta.

   az login
   

3. Especifique a assinatura que você quer usar.

   az account set -s <Your subscription ID>
   

4. 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:

1. 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.

2. 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
   

3. 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
   

4. 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"

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

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

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.