共用方式為


使用 Azure Resource Manager 範本建立 Azure AI Foundry 中樞

重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版本沒有服務等級協定,不建議將其用於生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款

使用 Microsoft Bicep 範本來建立 Azure AI Foundry 的中樞。 範本可讓您輕鬆地以單一、協調的作業建立資源。 Bicep 範本是文字文件,其定義部署所需的資源。 它也可以指定部署參數。 參數用來在使用範本時提供輸入值。

您可以在 https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics 找到本文中使用的範本。 來源 main.bicep 檔案和已編譯的 Azure Resource Manager 範本 (main.json) 檔案都可供使用。 此範本會建立下列資源︰

  • Azure 資源群組 (如果尚不存在)
  • Azure AI Foundry 中樞
  • Azure 儲存體帳戶
  • Azure Key Vault
  • Azure Container Registry
  • 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 Machine Learning 為基礎。 如需 Azure Machine Learning 最新 API 版本的相關資訊,請參閱 Azure Machine Learning REST API 參考。 若要更新此 API 版本,請尋找資源類型的 Microsoft.MachineLearningServices/<resource> 項目,並將其更新為最新版本。 下列範例是使用 2023-08-01-preview API 版本之中樞的項目:

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

Azure Resource Manager 範本

雖然 Bicep 網域特定語言 (DSL) 會用來定義資源,當您部署範本時,Bicep 檔案會編譯成 Azure Resource Manager 範本。 GitHub 存放庫中所包含的 main.json 檔案是已編譯的 Azure Resource Manager 範本版本。 此檔案是使用 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 取代為您資源所使用的名稱。 這個值會與產生的首碼和尾碼一起使用,為範本所建立的資源建立唯一名稱。

    提示

    aiHubName 必須少於或等於 5 個字元。 它不能完全是數值或包含下列字元:~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?

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

    作業完成後,您可以使用中樞來建立專案、管理資源,以及與其他人共同作業。

下一步