Instalación y configuración de la CLI (versión 2)

SE APLICA A: Extensión de ML de la CLI de Azure v2 (actual)

La extensión ml para la CLI de Azure es la interfaz mejorada de Azure Machine Learning. Permite entrenar e implementar modelos desde la línea de comandos, e incluye características que aceleran el escalado vertical y horizontal de la ciencia de datos al tiempo que se hace un seguimiento del ciclo de vida del modelo.

Requisitos previos

Instalación

La nueva extensión para Machine Learning requiere la versión >=2.38.0 de la CLI de Azure. Asegúrese de que se cumple este requisito:

az version

Si no es así, actualice la CLI de Azure.

Compruebe las extensiones de la CLI de Azure que están instaladas:

az extension list

Quite cualquier instalación existente de la extensión ml y también la extensión azure-cli-ml de la CLI v1:

az extension remove -n azure-cli-ml
az extension remove -n ml

Ahora, instale la extensión ml:

az extension add -n ml

Ejecute el comando de ayuda para comprobar la instalación y comprobar los subcomandos disponibles:

az ml -h

Puede actualizar la extensión a la versión más reciente:

az extension update -n ml

Instalación en Linux

Si usa Debian o Ubuntu, la manera más rápida de instalar la versión necesaria de la CLI y la extensión Machine Learning es la siguiente:

curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash 
az extension add -n ml -y

Para obtener información sobre cómo realizar la instalación en otras distribuciones de Linux, visite Instalación de la CLI de Azure para Linux.

Configurar

Inicie sesión:

az login

Si tiene acceso a varias suscripciones de Azure, puede establecer la suscripción de Azure.

az account set -s "<YOUR_SUBSCRIPTION_NAME_OR_ID>"

Opcionalmente, configure variables comunes en el shell para su uso en comandos posteriores:


GROUP="azureml-examples"

LOCATION="eastus"

WORKSPACE="main"

Advertencia

Esto usa la sintaxis de Bash para establecer variables. Ajuste según sea necesario para el shell. También puede reemplazar los valores de los comandos en los ejemplos siguientes en línea en lugar de usar variables.

Si aún no existe, cree el grupo de recursos de Azure:


az group create -n $GROUP -l $LOCATION

Y cree un área de trabajo de Machine Learning:


az ml workspace create -n $WORKSPACE -g $GROUP -l $LOCATION

Los subcomandos de Machine Learning requieren los parámetros --workspace/-w y --resource-group/-g. Para evitar escribirlos repetidamente, configure los valores predeterminados:

az configure --defaults group=$GROUP workspace=$WORKSPACE location=$LOCATION

Sugerencia

La mayoría de los ejemplos de código suponen que ha establecido un área de trabajo y un grupo de recursos predeterminados. Puede invalidar estos valores en la línea de comandos.

Puede mostrar los valores predeterminados actuales mediante --list-defaults/-l:

az configure -l -o table

Sugerencia

La combinación con --output/-o permite formatos de salida más legibles.

Comunicaciones seguras

La extensión de la CLI ml (a veces denominada "CLI v2") para Azure Machine Learning envía datos operativos (parámetros y metadatos de YAML) a través de la red pública de Internet. Todos los comandos de extensión de la CLI ml se comunican con Azure Resource Manager. Esta comunicación se protege mediante HTTPS/TLS 1.2.

Los datos en un almacén de datos que está protegido en una red virtual no se envían a través de la red pública de Internet. Por ejemplo, si los datos de entrenamiento están en la cuenta de almacenamiento predeterminada para el área de trabajo, y la cuenta de almacenamiento está en una red virtual.

Nota:

Con la extensión anterior (azure-cli-ml, a veces denominada "CLI v1"), solo algunos de los comandos se comunican con Azure Resource Manager. En concreto, los comandos que crean, actualizan, eliminan, enumeran o muestran recursos de Azure. Las operaciones como el envío de un trabajo de entrenamiento se comunican directamente con el área de trabajo de Azure Machine Learning. Si el área de trabajo está protegida con un punto de conexión privado, es suficiente para proteger los comandos proporcionados por la extensión azure-cli-ml.

Si su área de trabajo de Azure Machine Learning es pública (es decir, no está detrás de una red virtual), no se requiere ninguna configuración adicional. Las comunicaciones se protegen mediante HTTPS/TLS 1.2.

Pasos siguientes