Snabbstart: Distribuera Azure AI-sökning med Bicep

Kommentar

Azure AI-sökning är tillgängligt via Azure-portalen, REST-API:er och Azure-SDK:er. Den ligger också till grund för Foundry IQ, det hanterade kunskapsskiktet som omvandlar företagsinnehåll till återanvändbara, behörighetsmedvetna kunskapsbaser för agenter i Microsoft Foundry-portalen.

I den här snabbstarten använder du en Bicep-fil för att distribuera en Azure AI-sökning-tjänst i Azure portalen.

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. Det ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder den bästa redigeringsupplevelsen för dina infrastruktur-som-kod-lösningar i Azure.

Distributionen använder endast de egenskaper som ingår i mallen. Om du behöver mer anpassning, till exempel att konfigurera nätverkssäkerhet, kan du uppdatera tjänsten som en uppgift efter distributionen. Om du vill anpassa en befintlig tjänst med de minsta stegen använder du Azure CLI eller Azure PowerShell. Om du utvärderar förhandsversionsfunktioner använder du REST API för hantering.

Tips

En alternativ Bicep mall som distribuerar Azure AI-sökning med en förkonfigurerad indexerare till Cosmos DB för NoSQL finns i Bicep distribution av Azure AI-sökning. Det finns inget Bicep mallstöd för Azure AI-sökning dataplansåtgärder som att skapa ett index, men du kan lägga till en modul som anropar REST-API:er. Exemplet innehåller en modul som skapar ett index, en datakällsanslutning och en indexerare som uppdateras från Cosmos DB med 5 minuters intervall.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Granska Bicep-filen

Den här snabbstarten använder en Bicep-fil från Azure-snabbstartsmallar.

@description('Service name must only contain lowercase letters, digits or dashes, cannot use dash as the first two or last one characters, cannot contain consecutive dashes, and is limited between 2 and 60 characters in length.')
@minLength(2)
@maxLength(60)
param name string

@allowed([
  'free'
  'basic'
  'standard'
  'standard2'
  'standard3'
  'storage_optimized_l1'
  'storage_optimized_l2'
])
@description('The pricing tier of the search service you want to create (for example, basic or standard).')
param sku string = 'standard'

@description('Replicas distribute search workloads across the service. You need at least two replicas to support high availability of query workloads (not applicable to the free tier).')
@minValue(1)
@maxValue(12)
param replicaCount int = 1

@description('Partitions allow for scaling of document count as well as faster indexing by sharding your index over multiple search units.')
@allowed([
  1
  2
  3
  4
  6
  12
])
param partitionCount int = 1

@description('Applicable only for SKUs set to standard3. You can set this property to enable a single, high density partition that allows up to 1000 indexes, which is much higher than the maximum indexes allowed for any other SKU.')
@allowed([
  'default'
  'highDensity'
])
param hostingMode string = 'default'

@description('Location for all resources.')
param location string = resourceGroup().location

resource search 'Microsoft.Search/searchServices@2020-08-01' = {
  name: name
  location: location
  sku: {
    name: sku
  }
  properties: {
    replicaCount: replicaCount
    partitionCount: partitionCount
    hostingMode: hostingMode
  }
}

Filen Bicep definierar följande Azure resurs:

Distribuera Bicep-filen

  1. Spara Bicep-filen som main.bicep på den lokala datorn.

  2. Distribuera Bicep-filen med hjälp av antingen Azure CLI eller Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters serviceName=<service-name>

    Kommentar

    Ersätt <tjänstnamn> med namnet på tjänsten Search. Tjänstnamnet får endast innehålla gemener, siffror eller bindestreck. Du kan inte använda ett bindestreck som de två första tecknen eller det sista tecknet. Namnet har en minsta längd på 2 tecken och en maximal längd på 60 tecken.

    När distributionen är klar visas ett meddelande som anger att distributionen lyckades.

Granska distribuerade resurser

Använd Azure Portal, Azure CLI eller Azure PowerShell för att lista de distribuerade resurserna i resursgruppen.

az resource list --resource-group exampleRG

Rensa resurser

Azure AI-sökning är en fakturerbar resurs. Om du inte längre behöver det tar du bort det från din prenumeration för att undvika avgifter. Du kan använda Azure Portal, Azure CLI eller Azure PowerShell för att ta bort resursgruppen och dess resurser.

az group delete --name exampleRG

Relaterat innehåll

I den här snabbstarten skapade du en Azure AI-sökning-tjänst med hjälp av en Bicep-fil och verifierade sedan distributionen. Mer information om Azure AI-sökning och Azure Resource Manager finns i följande artiklar:

  • Uppdaterades senast