使用 Bicep 模板创建 Azure 机器学习中心工作区

使用 Microsoft Bicep 模板创建中心工作区,以便在 ML Studio 中使用。 使用模板可以轻松地通过单个协调操作创建资源。 Bicep 模板是一个文本文档,定义部署所需的资源。 它还可以指定部署参数。 使用模板时,参数用于提供输入值。

本文中使用的模板可在 https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics 找到。 源 main.bicep 文件和已编译的 Azure 资源管理器模板 (main.json) 文件均可用。 此模板可创建以下资源:

  • Azure 资源组(如果尚不存在)
  • 类型为“hub”的 Azure 机器学习工作区
  • Azure 存储帐户
  • Azure Key Vault
  • Azure 容器注册表
  • Azure Application Insights

先决条件

  • Azure 订阅。 如果没有订阅,请创建一个试用帐户

  • GitHub 存储库中模板文件的副本。 若要将 GitHub 存储库克隆到本地计算机,可以使用 Git。 使用以下命令将快速入门存储库克隆到本地计算机并导航到 aistudio-basics 目录。

    git clone https://github.com/Azure/azure-quickstart-templates
    cd azure-quickstart-templates/quickstarts/microsoft.machinelearningservices/aistudio-basics
    
  • Bicep 命令行工具。 若要安装 Bicep 命令行工具,请参阅安装 Bicep CLI 一文。

了解模板

Bicep 模板由以下文件组成:

文件 说明
main.bicep 定义参数和变量的主 Bicep 文件。 将参数和变量传递给 modules 子目录中的其他模块。
ai-resource.bicep 定义 Azure AI 中心资源。
dependent-resources.bicep 定义 Azure AI 中心的依赖资源。 Azure 存储帐户、容器注册表、Key Vault 和 Application Insights。

重要

示例模板不一定会使用其创建的 Azure 资源的最新 API 版本。 使用此模板之前,建议对其进行修改以使用最新的 API 版本。 每项 Azure 服务都有自己的 API 版本集。 有关特定服务的 API 的信息,请查看 Azure REST API 参考中的服务信息。

AI 中心资源基于 Azure 机器学习。 有关 Azure 机器学习的最新 API 版本的信息,请参阅 Azure 机器学习 REST API 参考。 若要更新此 API 版本,请查找资源类型的 Microsoft.MachineLearningServices/<resource> 条目,并将其更新为最新版本。 以下示例显示 Azure AI 中心的一个条目,该中心使用 API 版本 2023-08-01-preview

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

Azure Resource Manager 模板

虽然 Bicep 特定于域的语言 (DSL) 用于定义资源,但部署模板时,Bicep 文件将编译为 Azure 资源管理器模板。 GitHub 存储库中包含的 main.json 文件是模板的已编译 Azure 资源管理器版本。 此文件是使用 Bicep 命令行工具从 main.bicep 文件生成的。 例如,部署 Bicep 模板时会生成 main.json 文件。 还可以使用 bicep build 命令手动创建 main.json 文件,无需部署模板。

bicep build main.bicep

有关详细信息,请参阅 Bicep CLI 一文。

配置模板

要运行 Bicep 模板,请使用 aistudio-basics 目录中的以下命令:

  1. 若要创建新的 Azure 资源组,请使用以下命令。 将 exampleRG 替换为资源组的名称,将 chinanorth3 替换为要使用的 Azure 区域:

    az group create --name exampleRG --location chinanorth3
    
  2. 若要运行模板,请使用以下命令。 将 myai 替换为要用于资源的名称。 此值与生成的前缀和后缀一起用于为模板创建的资源创建唯一名称。

    提示

    aiResourceName 必须为 5 个或更少字符。 它不能全为数字或包含以下字符:~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

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