Sdílet prostřednictvím

Vytvoření pracovního prostoru centra Azure Machine Learning pomocí šablony Bicep

  • Článek

Pomocí šablony Microsoft Bicep můžete vytvořit pracovní prostor centra pro použití v sadě ML Studio a Azure AI Foundry. Šablona usnadňuje vytváření prostředků jako jediné koordinované operace. Šablona Bicep je textový dokument, který definuje prostředky potřebné pro nasazení. Může také určovat parametry nasazení. Parametry se používají k zadání vstupních hodnot při použití šablony.

Šablonu použitou v tomto článku najdete na adrese https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. main.bicep Zdrojový i zkompilovaný soubor šablony Azure Resource Manageru (main.json) jsou k dispozici. Tato šablona vytvoří následující prostředky:

  • Skupina prostředků Azure (pokud ještě neexistuje)
  • Pracovní prostor Služby Azure Machine Learning typu Hub
  • Účet služby Azure Storage
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Služby Azure AI (vyžadované pro Azure AI Foundry a můžou se vynechat pro případy použití služby Azure Machine Learning)

Požadavky

  • Předplatné Azure. Pokud žádné nemáte, vytvořte si bezplatný účet.

  • Kopie souborů šablony z úložiště GitHub. Pokud chcete naklonovat úložiště GitHub do místního počítače, můžete použít Git. Pomocí následujícího příkazu naklonujte úložiště rychlého startu do místního počítače a přejděte do aistudio-basics adresáře.

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

  • Nástroje příkazového řádku Bicep. Pokud chcete nainstalovat nástroje příkazového řádku Bicep, použijte článek Instalace rozhraní příkazového řádku Bicep.

Principy šablony

Šablona Bicep se skládá z následujících souborů:

Soubor Popis
main.bicep Hlavní soubor Bicep, který definuje parametry a proměnné. Předávání parametrů a proměnných jiným modulům modules v podadresáři
ai-resource.bicep Definuje prostředek centra Azure AI.
dependent-resources.bicep Definuje závislé prostředky pro centrum Azure AI. Účet úložiště Azure, Registr kontejnerů, Key Vault a Application Insights.

Důležité

Ukázkové šablony nemusí vždy používat nejnovější verzi rozhraní API pro prostředky Azure, které vytvoří. Před použitím šablony doporučujeme ji upravit tak, aby používala nejnovější verze rozhraní API. Každá služba Azure má svou vlastní sadu verzí rozhraní API. Informace o rozhraní API pro konkrétní službu najdete v referenčních informacích o službě Azure REST API.

Prostředek centra AI je založený na službě Azure Machine Learning. Informace o nejnovějších verzích rozhraní API pro Azure Machine Learning najdete v referenčních informacích k rozhraní REST API služby Azure Machine Learning. Pokud chcete tuto verzi rozhraní API aktualizovat, vyhledejte Microsoft.MachineLearningServices/<resource> položku pro typ prostředku a aktualizujte ji na nejnovější verzi. Následující příklad je položka pro centrum Azure AI, která používá verzi 2023-08-01-previewrozhraní API:

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

Šablona Azure Resource Manageru

Zatímco jazyk SPECIFICKÝ pro doménu Bicep (DSL) se používá k definování prostředků, soubor Bicep se při nasazení šablony zkompiluje do šablony Azure Resource Manageru. Soubor main.json , který je součástí úložiště GitHub, je zkompilovaná verze Azure Resource Manageru šablony. Tento soubor se vygeneruje ze souboru pomocí nástrojů příkazového main.bicep řádku Bicep. Když například nasadíte šablonu Bicep, vygeneruje main.json soubor. Soubor můžete také vytvořit main.json ručně pomocí bicep build příkazu bez nasazení šablony.

bicep build main.bicep

Další informace najdete v článku o rozhraní příkazového řádku Bicep.

Konfigurace šablony

Pokud chcete spustit šablonu Bicep, použijte z aistudio-basics adresáře následující příkazy:

  1. Pokud chcete vytvořit novou skupinu prostředků Azure, použijte následující příkaz. Nahraďte exampleRG názvem vaší skupiny prostředků a eastus oblastí Azure, která se má použít:

    az group create --name exampleRG --location eastus

  2. Pokud chcete šablonu spustit, použijte následující příkaz. Nahraďte myai názvem, který se má použít pro vaše prostředky. Tato hodnota se používá spolu s vygenerovanými předponami a příponami k vytvoření jedinečného názvu prostředků vytvořených šablonou.

    Tip

    Musí aiResourceName mít 5 nebo méně znaků. Nemůže být zcela číselný ani nesmí obsahovat následující znaky: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

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