Compartir por

Creación de un área de trabajo del centro de Azure Machine Learning mediante una plantilla de Bicep

  • Artigo

Use una plantilla Microsoft Bicep para crear un área de trabajo del centro para su uso en ML Studio y AI Studio. Una plantilla facilita la creación de recursos como una operación única y coordinada. Una plantilla Bicep es un documento de texto que define los recursos necesarios para una implementación. También puede especificar parámetros de implementación. Los parámetros se emplean para proporcionar valores de entrada cuando se usa la plantilla.

La plantilla utilizada en este artículo se encuentra en https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. Tanto el archivo main.bicep fuente como la plantilla compilada de Azure Resource Manager (main.json) están disponibles. Esta plantilla crea los siguientes recursos:

  • Un grupo de recursos de Azure (si aún no existe)
  • Un área de trabajo de Azure Machine Learning de tipo "hub"
  • Cuenta de Azure Storage
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Servicios de Azure AI (necesarios para AI Studio y se pueden quitar para casos de uso de Azure Machine Learning)

Requisitos previos

  • Suscripción a Azure. En caso de no tener ninguna, cree una cuenta gratuita.

  • Una copia de los archivos de plantilla del repositorio de GitHub. Para clonar el repositorio de GitHub en su máquina local, puede utilizar Git. Utilice el siguiente comando para clonar el repositorio de inicio rápido en su máquina local y navegue hasta el directorio aistudio-basics.

    git clone https://github.com/Azure/azure-quickstart-templates
cd azure-quickstart-templates/quickstarts/microsoft.machinelearningservices/aistudio-basics

  • Las herramientas de línea de comandos de Bicep. Para instalar las herramientas de línea de comandos de Bicep, utilice el artículo Instalar la CLI de Bicep.

Descripción de la plantilla

La plantilla Bicep se compone de los siguientes archivos:

Archivo Descripción
main.bicep El archivo principal de Bicep que define los parámetros y variables. Pasa los parámetros y variables a otros módulos del subdirectorio modules.
ai-resource.bicep Define el recurso del centro Azure AI.
dependent-resources.bicep Define los recursos dependientes para el centro Azure AI. Cuenta de Azure Storage, Registro de contenedor, Almacén de claves y Application Insights.

Importante

Es posible que las plantillas de ejemplo no siempre utilicen la última versión de la API para los recursos de Azure que crea. Antes de usar la plantilla, se recomienda modificarla para que use las versiones más recientes de la API. Cada servicio de Azure tiene su propio conjunto de versiones de API. Para obtener información sobre la API de un servicio específico, compruebe la información del servicio en la referencia de la API REST de Azure.

El recurso centro AI se basa en Azure Machine Learning. Para obtener información sobre las últimas versiones de la API para Azure Machine Learning, consulte la referencia de la API REST de Azure Machine Learning. Para actualizar esta versión de la API, busque la Microsoft.MachineLearningServices/<resource> entrada correspondiente al tipo de recurso y actualícela a la última versión. El siguiente ejemplo es una entrada para el centro Azure AI que utiliza una versión de la API de 2023-08-01-preview:

resource aiResource 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {

Plantilla del Administrador de recursos de Azure

Mientras que el lenguaje específico del dominio (DSL) Bicep se utiliza para definir los recursos, el archivo Bicep se compila en una plantilla de Azure Resource Manager cuando se implementa la plantilla. El archivo main.json incluido en el repositorio de GitHub es una versión compilada de Azure Resource Manager de la plantilla. Este archivo se genera a partir del archivo main.bicep mediante las herramientas de línea de comandos Bicep. Por ejemplo, al implementar la plantilla Bicep se genera el archivo main.json. También puede crear manualmente el archivo main.json utilizando el comando bicep build sin implementar la plantilla.

bicep build main.bicep

Para obtener más información, consulte el artículo Bicep CLI.

Configuración de la plantilla

Para ejecutar la plantilla Bicep, utilice los siguientes comandos desde el directorio aistudio-basics:

  1. Para crear un nuevo grupo de recursos de Azure, use el siguiente comando. Reemplace exampleRG por el nombre de su grupo de recursos y eastus por la región Azure que desea utilizar:

    az group create --name exampleRG --location eastus

  2. Para ejecutar la plantilla, use el siguiente comando. Reemplace myai por el nombre que desee utilizar para sus recursos. Este valor se utiliza, junto con los prefijos y sufijos generados, para crear un nombre único para los recursos creados por la plantilla.

    Sugerencia

    aiResourceName Debe tener 5 o menos caracteres. No puede ser solamente numérica ni contener los caracteres siguientes: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

    az deployment group create --resource-group exampleRG --template-file main.bicep --parameters aiResourceName=myai