Dela via

Använda en Azure Resource Manager-mall för att skapa en Azure AI Foundry-hubb

  • Artikel

Viktigt!

Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Använd en Microsoft Bicep-mall för att skapa en hubb för Azure AI Foundry. 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 AI Foundry-hubb
  • Azure Storage-konto
  • Azure Key Vault
  • Azure Container Registry
  • Azure Application Insights
  • Azure AI-tjänster (skapade av mallen)

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-hub.bicep Definierar hubben.
dependent-resources.bicep Definierar beroende resurser för hubben, till exempel 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.

Hubben baseras på Azure Machine Learning. Information om de senaste API-versionerna för Azure Machine Learning finns i referensen för REST API för Azure Machine Learning. 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 en hubb 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 aiHubName 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 aiHubName=myai

    När åtgärden är klar kan du använda hubben för att skapa projekt, hantera resurser och samarbeta med andra.

Nästa steg