Administración de áreas de trabajo cuánticas con la CLI de Azure

Artículo
10/28/2023

En esta guía, aprenderá a usar la interfaz de la línea de comandos (CLI) de Azure para crear áreas de trabajo de Azure Quantum, así como las cuentas de almacenamiento y los grupos de recursos necesarios, con el fin de empezar a ejecutar sus aplicaciones cuánticas en Azure Quantum.

Requisitos previos

Para usar el servicio Azure Quantum, necesita:

Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, regístrese gratuitamente y regístrese para obtener una suscripción de pago por uso.
Un grupo de recursos de Azure donde reside el área de trabajo cuántica.
Una cuenta de almacenamiento en el grupo de recursos que se va a asociar al área de trabajo cuántico. Se pueden asociar varias áreas de trabajo a la misma cuenta.
LaCLI de Azure.
Microsoft Quantum Development Kit.

Configuración del entorno

Instalación de la extensión quantum de la CLI de Azure. Abra un símbolo del sistema y ejecute el siguiente comando, que también actualiza la extensión si ya hay instalada una versión anterior:
```
az extension add --upgrade -n quantum
```
Inicie sesión en Azure con sus credenciales. Verá una lista de suscripciones asociadas a su cuenta.
```
az login
```
Especifique la suscripción que desea usar.
```
az account set -s <Your subscription ID>
```
Si es la primera vez que va a crear áreas de trabajo cuánticas en su suscripción, registre el proveedor de recursos con este comando:
```
az provider register --namespace Microsoft.Quantum
```

Creación de un área de trabajo de Azure Quantum

Para crear un área de trabajo de Azure Quantum, debe saber lo siguiente:

La ubicación o el nombre de la región de Azure donde se encontrará el recurso. Puede usar la lista de regiones y sus códigos de administrador de recursos que admite la herramienta de la CLI de Azure (por ejemplo, westus).
El grupo de recursos asociado a la nueva área de trabajo, por ejemplo, MyResourceGroup.
Una cuenta de almacenamiento en el mismo grupo de recursos y la misma suscripción que el área de trabajo cuántica. Es posible crear una nueva cuenta de almacenamiento desde la CLI de Az, por ejemplo, MyStorageAccount.
Nombre del área de trabajo cuántica que se creará, por ejemplo, MyQuantumWorkspace.
La lista de proveedores de Azure Quantum que se usarán en el área de trabajo. Un proveedor ofrece un conjunto de planes, cada uno de los cuales representa un plan con los términos y condiciones asociados, el costo y las cuotas. Para crear áreas de trabajo, debe especificar el plan correspondiente junto con los proveedores, a menos que quiera empezar con los proveedores que ofrecen crédito gratuito, se agregan automáticamente al área de trabajo.

Si ya conoce los nombres del proveedor y del plan que se van a usar en el área de trabajo, puede ir directamente al paso 4 a continuación. Si desea empezar con los proveedores que ofrecen crédito gratuito, puede escribir el siguiente comando:

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

Es posible que se le pida que acepte los términos de uso. Para aceptar los términos, escriba Y. Tenga en cuenta que el parámetro -r que se muestra en el paso cuatro, a continuación, no era necesario.

Si necesita determinar qué proveedores y planes usar, continúe como se indica a continuación:

Para recuperar la lista de proveedores cuánticos disponibles, use el comando list (en este ejemplo se usa westus como ubicación):
```
az quantum offerings list \
     -l westus \
     -o table
```
Sugerencia

Si desea ver qué proveedores proporcionan crédito gratuito, use el parámetro --autoadd-only, por ejemplo:
az quantum offerings list --autoadd-only -l westus -o table
Como ya se ha indicado, esos proveedores se agregan automáticamente al área de trabajo. No es preciso especificarlos con el parámetro -r.
Una vez que determine el proveedor y el plan que se incluirán en el área de trabajo, puede revisar los términos con el comando show-terms (añadiendo MyProviderID y MyPlan como valores de ejemplo):
```
az quantum offerings show-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
La salida del comando show-terms incluye un campo booleano accepted que muestra si ya se han aceptado o no los términos de este proveedor, así como un vínculo a los términos de licencia para revisarlos. Si decide aceptar dichos términos, use el comando accept-terms para registrar su aceptación.
```
az quantum offerings accept-terms \
     -l westus \
     -p MyProviderId \
     -k MyPlan
```
Una vez que haya revisado y aceptado todos los términos y condiciones necesarios, puede crear el área de trabajo con el comando create, especificando una lista de combinaciones de proveedor y plan separadas por comas, como en el siguiente ejemplo:
```
az quantum workspace create \
     -l westus \
     -g MyResourceGroup \
     -w MyQuantumWorkspace \
     -a MyStorageAccount \
     -r "MyProvider1/MyPlan1, MyProvider2/MyPlan2"
```

Una vez creado un área de trabajo, puede agregar o quitar proveedores mediante el Azure Portal.

Cambio de la cuenta de almacenamiento predeterminada para un área de trabajo de Quantum

Si tiene que cambiar la cuenta de almacenamiento predeterminada de un área de trabajo existente, puede usar el comando create especificando todas las propiedades actuales junto con la nueva cuenta de almacenamiento. En el ejemplo siguiente, se usa la misma configuración que en el área de trabajo creada en el ejemplo anterior:

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

Importante

En realidad, este procedimiento vuelve a crear el área de trabajo con la nueva cuenta de almacenamiento. Asegúrese de que todas las propiedades distintas de la cuenta de almacenamiento sean exactamente las mismas que las originales; de lo contrario, se crea un segundo área de trabajo.

Eliminación de un área de trabajo cuántica

Si conoce el nombre y el grupo de recursos de un área de trabajo de Quantum que quiera eliminar, puede hacerlo con el comando delete (con los mismos nombres que en el ejemplo anterior):

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

Sugerencia

Si no recuerda el nombre exacto, puede ver toda la lista de áreas de trabajo cuánticas de la suscripción mediante az quantum workspace list -o table.

Después de eliminar un área de trabajo, sigue apareciendo mientras se elimina en la nube. Sin embargo, la propiedad provisioningState del área de trabajo cambia inmediatamente para indicar que se está eliminando. Para ver esta información, use el comando show:

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

Nota:

Si ya ha usado el comando az quantum workspace set para especificar un área de trabajo cuántica predeterminada, llame al comando delete sin parámetros para eliminar (y borrar) el área de trabajo predeterminada.

az quantum workspace delete

Pasos siguientes

Ahora que puede crear y eliminar áreas de trabajo, obtenga información sobre las diferentes targets para ejecutar algoritmos cuánticos en Azure Quantum.