Verwenden einer Azure Resource Manager-Vorlage zum Erstellen eines Azure KI Studio-Hubs

  • Artikel

Wichtig

Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Verwenden Sie eine Microsoft Bicep-Vorlage, um einen neuen Azure KI Studio-Hub 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 KI Studio-Hub.
  • Azure Storage-Konto
  • Azure-Schlüsseltresor
  • Azure Container Registry
  • Azure Application Insights
  • Azure KI Services (erstellt durch die Vorlage)

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-hub.bicep Definiert den Hub.
dependent-resources.bicep Definiert die abhängigen Ressourcen für den Hub, z. B. Azure Storage-Konto, Containerregistrierung, 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.

Der Hub 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 einen 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 aiHubName 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 aiHubName=myai

    Nach Abschluss des Vorgangs können Sie Ihren Hub verwenden, um Projekte zu erstellen, Ressourcen zu verwalten und mit anderen zusammenzuarbeiten.

Nächste Schritte