Freigeben über

Erstellen eines Azure Machine Learning Hub-Arbeitsbereichs mithilfe einer Bicep-Vorlage

  • Artikel

Verwenden Sie eine Microsoft Bicep-Vorlage, um einen Hub-Arbeitsbereich für die Verwendung in ML Studio und AI Studio zu erstellen. Eine Vorlage erleichtert das Erstellen von Ressourcen in einem einzelnen, koordinierten Vorgang. Eine Bicep-Vorlage ist ein Textdokument, das die Ressourcen definiert, die für eine Bereitstellung erforderlich sind. Es kann außerdem bestimmte Bereitstellungsparameter angeben. Parameter werden verwendet, um Eingabewerte bereitzustellen, wenn die Vorlage verwendet wird.

Die in diesem Artikel verwendete Vorlage finden Sie unter https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. Sowohl die Quelldatei main.bicep als auch die kompilierte Datei für die Azure Resource Manager-Vorlage (main.json) sind verfügbar. Diese Vorlage erstellt die folgenden Ressourcen:

  • Eine Azure-Ressourcengruppe (wenn noch keine vorhanden ist)
  • Ein Azure Machine Learning-Arbeitsbereich der Art "Hub"
  • Azure Storage-Konto
  • Azure-Schlüsseltresor
  • Azure Container Registry
  • Azure Application Insights
  • Azure KI Services (erforderlich für AI Studio und kann für Azure Machine Learning-Anwendungsfälle verworfen werden)

Voraussetzungen

  • Ein Azure-Abonnement. Falls Sie nicht über eine Subscription verfügen, können Sie ein kostenloses Konto erstellen.

  • Eine Kopie der Vorlagendateien aus dem GitHub-Repository Um das GitHub-Repository auf Ihren lokalen Computer zu klonen, können Sie Git verwenden. Verwenden Sie den folgenden Befehl, um das Schnellstartrepository auf Ihren lokalen Computer zu klonen und zum Verzeichnis aistudio-basics zu navigieren.

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

  • Die Bicep-Befehlszeilentools. Um die Befehlszeilentools von Bicep zu installieren, verwenden Sie den Artikel Installieren der Bicep CLI.

Grundlegendes zur Vorlage

Die Bicep-Vorlage umfasst die folgenden Dateien:

Datei BESCHREIBUNG
main.bicep Die Bicep-Hauptdatei, die die Parameter und Variablen definiert. Übergeben von Parametern und Variablen an andere Module im Unterverzeichnis modules.
ai-resource.bicep Definiert die Azure KI-Hubressource
dependent-resources.bicep Definiert die abhängigen Ressourcen für den Azure KI-Hub. Azure Storage-Konto, Container Registry, Key Vault und Application Insights.

Wichtig

Die Beispielvorlagen verwenden möglicherweise nicht immer die neueste API-Version für die Azure-Ressourcen, die sie erstellt. Bevor Sie die Vorlage verwenden, empfehlen wir, sie so zu ändern, dass sie die neuesten API-Versionen verwendet. Jeder Azure-Dienst verfügt über einen eigenen Satz von API-Versionen. Informationen zur API für einen bestimmten Dienst finden Sie in den Dienstinformationen in der Azure-REST-API-Referenz.

Die KI-Hubressource basiert auf Azure Machine Learning. Informationen zu den neuesten API-Versionen für Azure Machine Learning finden Sie unter der Azure Machine Learning-REST-API-Referenz. Um diese API-Version zu aktualisieren, suchen Sie den Eintrag Microsoft.MachineLearningServices/<resource> für den Ressourcentyp, und aktualisieren Sie ihn auf die neueste Version. Das folgende Beispiel ist ein Eintrag für den Azure KI-Hub, der eine API-Version von 2023-08-01-preview verwendet:

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

Azure Resource Manager-Vorlage

Während die domänenspezifische Sprache (DSL) von Bicep zum Definieren der Ressourcen verwendet wird, wird die Bicep-Datei beim Bereitstellen der Vorlage in eine Azure Resource Manager-Vorlage kompiliert. Die im GitHub-Repository enthaltene main.json-Datei ist eine kompilierte Azure Resource Manager-Version der Vorlage. Diese Datei wird mithilfe der Bicep-Befehlszeilentools aus der main.bicep-Datei generiert. Wenn Sie beispielsweise die Bicep-Vorlage bereitstellen, wird die main.json-Datei generiert. Sie können die main.json-Datei auch manuell mithilfe des Befehls bicep build erstellen, ohne die Vorlage bereitzustellen.

bicep build main.bicep

Weitere Informationen finden Sie im Artikel Bicep-CLI.

Konfigurieren der Vorlage

Um die Bicep-Vorlage auszuführen, verwenden Sie die folgenden Befehle aus dem Verzeichnis aistudio-basics:

  1. Führen Sie den folgenden Befehl aus, um eine neue Azure-Ressourcengruppe zu erstellen. Ersetzen Sie exampleRG durch den Namen Ihrer Ressourcengruppe und eastus durch die Azure-Region, die verwendet werden soll:

    az group create --name exampleRG --location eastus

  2. Verwenden Sie den folgenden Befehl, um die Vorlage auszuführen. Ersetzen Sie myai durch den Namen, der für Ihre Ressource verwendet werden soll. Dieser Wert wird zusammen mit generierten Präfixen und Suffixen verwendet, um einen eindeutigen Namen für die von der Vorlage erstellten Ressourcen zu erstellen.

    Tipp

    Das aiResourceName muss fünf oder weniger Zeichen lang sein. Es darf nicht nur aus Ziffern bestehen oder die folgenden Zeichen enthalten: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

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