你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Azure 资源管理器模板创建 Azure AI Studio 中心

重要

本文介绍的某些功能可能仅在预览版中提供。 此预览版未提供服务级别协议,不建议将其用于生产工作负载。 某些功能可能不受支持或者受限。 有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

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

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

  • Azure 资源组(如果尚不存在)
  • 一个 Azure AI Studio 中心
  • Azure 存储帐户
  • Azure Key Vault
  • Azure 容器注册表
  • Azure Application Insights
  • Azure AI 服务(由模板创建)

先决条件

  • 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-hub.bicep 定义中心。
dependent-resources.bicep 定义中心的依赖资源,例如 Azure 存储帐户、容器注册表、Key Vault 和 Application Insights。

重要

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

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

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

Azure 资源管理器模板

虽然 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 替换为资源组的名称,将 eastus 替换为要使用的 Azure 区域:

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

    提示

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

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

    操作完成后,可以使用中心创建项目、管理资源并与其他人协作。

后续步骤