Sdílet prostřednictvím

Vytvoření centra Azure AI Foundry pomocí šablony Azure Resource Manageru

  • Článek

Důležité

Položky označené (Preview) v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Pomocí šablony Microsoft Bicep vytvořte centrum pro 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)
  • Centrum Azure AI Foundry
  • Účet služby Azure Storage
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Služby Azure AI (vytvořené šablonou)

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-hub.bicep Definuje centrum.
dependent-resources.bicep Definuje závislé prostředky pro centrum, jako je účet služby Azure Storage, Container Registry, 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.

Centrum 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, 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í aiHubName 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 aiHubName=myai

    Po dokončení operace můžete pomocí centra vytvářet projekty, spravovat prostředky a spolupracovat s ostatními.

Další kroky