Partilhar via


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

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:

Configuração de ambiente

  1. 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
    
  2. Inicie sessão no Azure com as suas credenciais. Verá uma lista de subscrições associadas à sua conta.

    az login
    
  3. Especifique a subscrição que pretende utilizar.

    az account set -s <Your subscription ID>
    
  4. 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:

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

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