Skapa en Azure Mašinsko učenje hubbarbetsyta med hjälp av en Bicep-mall

  • Artikel

Använd en Microsoft Bicep-mall för att skapa en hubbarbetsyta för användning i ML Studio och AI Studio. En mall gör det enkelt att skapa resurser som en enda samordnad åtgärd. En Bicep-mall är ett textdokument som definierar de resurser som behövs för en distribution. Den kan också ange distributionsparametrar. Parametrar används för att ange indatavärden när du använder mallen.

Mallen som används i den här artikeln finns på https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.machinelearningservices/aistudio-basics. Både källfilen main.bicep och den kompilerade Azure Resource Manager-mallfilen (main.json) är tillgängliga. Den här mallen skapar följande resurser:

  • En Azure-resursgrupp (om den inte redan finns)
  • En Azure-Mašinsko učenje arbetsyta av typen "hub"
  • Azure Storage-konto
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Azure AI-tjänster (krävs för AI Studio och kan tas bort för Azure Mašinsko učenje användningsfall)

Förutsättningar

  • En Azure-prenumeration. Om du inte har en skapar du ett kostnadsfritt konto.

  • En kopia av mallfilerna från GitHub-lagringsplatsen. Om du vill klona GitHub-lagringsplatsen till din lokala dator kan du använda Git. Använd följande kommando för att klona snabbstartslagringsplatsen till den lokala datorn och navigera till aistudio-basics katalogen.

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

  • Kommandoradsverktygen för Bicep. Om du vill installera kommandoradsverktygen för Bicep använder du artikeln Installera Bicep CLI .

Förstå mallen

Bicep-mallen består av följande filer:

Fil beskrivning
main.bicep Den huvudsakliga Bicep-filen som definierar parametrarna och variablerna. Skicka parametrar och variabler till andra moduler i underkatalogen modules .
ai-resource.bicep Definierar Azure AI Hub-resursen.
dependent-resources.bicep Definierar de beroende resurserna för Azure AI-hubben. Azure Storage-konto, Container Registry, Key Vault och Application Insights.

Viktigt!

Exempelmallarna kanske inte alltid använder den senaste API-versionen för de Azure-resurser som skapas. Innan du använder mallen rekommenderar vi att du ändrar den så att den använder de senaste API-versionerna. Varje Azure-tjänst har en egen uppsättning API-versioner. Information om API:et för en specifik tjänst finns i tjänstinformationen i Azure REST API-referensen.

AI Hub-resursen baseras på Azure Mašinsko učenje. Information om de senaste API-versionerna för Azure Mašinsko učenje finns i referensen för Azure Mašinsko učenje REST API. Om du vill uppdatera den här API-versionen letar du reda på Microsoft.MachineLearningServices/<resource> posten för resurstypen och uppdaterar den till den senaste versionen. Följande exempel är en post för Azure AI-hubben som använder en API-version av 2023-08-01-preview:

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

Azure Resource Manager-mall

Medan det domänspecifika Bicep-språket (DSL) används för att definiera resurserna, kompileras Bicep-filen till en Azure Resource Manager-mall när du distribuerar mallen. Filen main.json som ingår i GitHub-lagringsplatsen är en kompilerad Azure Resource Manager-version av mallen. Den här filen genereras från main.bicep filen med hjälp av kommandoradsverktygen för Bicep. När du till exempel distribuerar Bicep-mallen genereras main.json filen. Du kan också skapa main.json filen manuellt med kommandot bicep build utan att distribuera mallen.

bicep build main.bicep

Mer information finns i artikeln Bicep CLI .

Konfigurera mallen

Om du vill köra Bicep-mallen använder du följande kommandon från aistudio-basics katalogen:

  1. Använd följande kommando för att skapa en ny Azure-resursgrupp. Ersätt exampleRG med namnet på resursgruppen och eastus med den Azure-region som ska användas:

    az group create --name exampleRG --location eastus

  2. Använd följande kommando för att köra mallen. Ersätt myai med namnet som ska användas för dina resurser. Det här värdet används tillsammans med genererade prefix och suffix för att skapa ett unikt namn för de resurser som skapas av mallen.

    Dricks

    Måste aiResourceName vara 5 eller färre tecken. Det kan inte vara helt numeriskt eller innehålla följande tecken: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ?.

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