Tworzenie obszaru roboczego centrum usługi Azure Machine Learning przy użyciu szablonu Bicep

  • Artykuł

Użyj szablonu microsoft Bicep, aby utworzyć obszar roboczy centrum do użycia w programie ML Studio i AI Studio. Szablon ułatwia tworzenie zasobów jako pojedynczej, skoordynowanej operacji. Szablon Bicep to dokument tekstowy, który definiuje zasoby potrzebne do wdrożenia. Może również określać parametry wdrożenia. Parametry są używane do podawania wartości wejściowych podczas korzystania z szablonu.

Szablon używany w tym artykule można znaleźć na stronie https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. Dostępny jest zarówno plik źródłowy main.bicep , jak i skompilowany plik szablonu usługi Azure Resource Manager (main.json). Ten szablon umożliwia utworzenie następujących zasobów:

  • Grupa zasobów platformy Azure (jeśli jeszcze nie istnieje)
  • Obszar roboczy usługi Azure Machine Learning o rodzaju "hub"
  • Konto magazynu platformy Azure
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Usługi Azure AI (wymagane dla programu AI Studio i mogą zostać porzucone w przypadku przypadków użycia usługi Azure Machine Learning)

Wymagania wstępne

  • Subskrypcja platformy Azure. Jeśli jej nie masz, utwórz bezpłatne konto.

  • Kopia plików szablonów z repozytorium GitHub. Aby sklonować repozytorium GitHub na komputer lokalny, możesz użyć narzędzia Git. Użyj następującego polecenia, aby sklonować repozytorium Szybki start na komputer lokalny i przejść do aistudio-basics katalogu.

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

  • Narzędzia wiersza polecenia Bicep. Aby zainstalować narzędzia wiersza polecenia Bicep, użyj artykułu Instalowanie interfejsu wiersza polecenia Bicep.

Opis szablonu

Szablon Bicep składa się z następujących plików:

Plik opis
main.bicep Główny plik Bicep definiujący parametry i zmienne. Przekazywanie parametrów i zmiennych do innych modułów w podkatalogu modules .
ai-resource.bicep Definiuje zasób centrum AI platformy Azure.
dependent-resources.bicep Definiuje zasoby zależne dla centrum azure AI. Konto usługi Azure Storage, rejestr kontenerów, magazyn kluczy i usługa Application Insights.

Ważne

Przykładowe szablony mogą nie zawsze używać najnowszej wersji interfejsu API dla tworzonych zasobów platformy Azure. Przed użyciem szablonu zalecamy zmodyfikowanie go w celu korzystania z najnowszych wersji interfejsu API. Każda usługa platformy Azure ma własny zestaw wersji interfejsu API. Aby uzyskać informacje na temat interfejsu API dla określonej usługi, zapoznaj się z informacjami o usłudze w dokumentacji interfejsu API REST platformy Azure.

Zasób centrum sztucznej inteligencji jest oparty na usłudze Azure Machine Learning. Aby uzyskać informacje na temat najnowszych wersji interfejsu API dla usługi Azure Machine Learning, zobacz dokumentację interfejsu API REST usługi Azure Machine Learning. Aby zaktualizować tę wersję interfejsu Microsoft.MachineLearningServices/<resource> API, znajdź wpis dla typu zasobu i zaktualizuj go do najnowszej wersji. Poniższy przykład to wpis dla centrum azure AI, który używa wersji interfejsu 2023-08-01-previewAPI :

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

Szablon usługi Azure Resource Manager

Podczas gdy język specyficzny dla domeny Bicep (DSL) służy do definiowania zasobów, plik Bicep jest kompilowany w szablonie usługi Azure Resource Manager podczas wdrażania szablonu. Plik main.json zawarty w repozytorium GitHub to skompilowana wersja szablonu usługi Azure Resource Manager. Ten plik jest generowany na podstawie main.bicep pliku przy użyciu narzędzi wiersza polecenia Bicep. Na przykład podczas wdrażania szablonu Bicep generuje main.json plik. Możesz również ręcznie utworzyć main.json plik przy użyciu bicep build polecenia bez wdrażania szablonu.

bicep build main.bicep

Aby uzyskać więcej informacji, zobacz artykuł dotyczący interfejsu wiersza polecenia Bicep.

Konfigurowanie szablonu

Aby uruchomić szablon Bicep, użyj następujących poleceń z aistudio-basics katalogu:

  1. Aby utworzyć nową grupę zasobów platformy Azure, użyj następującego polecenia. Zastąp exampleRG ciąg nazwą grupy zasobów i eastus regionem świadczenia usługi Azure, który ma być używany:

    az group create --name exampleRG --location eastus

  2. Aby uruchomić szablon, użyj następującego polecenia. Zastąp myai ciąg nazwą używaną dla zasobów. Ta wartość jest używana wraz z wygenerowanymi prefiksami i sufiksami w celu utworzenia unikatowej nazwy zasobów utworzonych przez szablon.

    Napiwek

    Musi aiResourceName mieć co najmniej 5 znaków. Nie może być całkowicie numeryczna ani zawierać następujących znaków: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

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