Compartir vía

Uso de una plantilla de Azure Resource Manager para crear un centro de Inteligencia artificial de Azure Studio

  • Artículo

Importante

Los elementos marcados (versión preliminar) en este artículo se encuentran actualmente en versión preliminar pública. Esta versión preliminar se ofrece sin acuerdo de nivel de servicio y no se recomienda para las cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Utilice una plantilla de Microsoft Bicep para crear un centro de Inteligencia artificial de Azure 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 centro de Inteligencia artificial de Azure Studio
  • Cuenta de Azure Storage
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Servicios Azure AI (creados por la plantilla)

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-hub.bicep Define el centro.
dependent-resources.bicep Define los recursos dependientes del centro, como la cuenta de Azure Storage, Container Registry, Key Vault 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 centro 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 un centro en el que se usa 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

    aiHubName 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 aiHubName=myai

    Una vez que se completa la operación, puede utilizar el centro para crear proyectos, administrar recursos y colaborar con otros.

Pasos siguientes