Dela via

Snabbstart: Distribuera Azure AI Search med Bicep

  • Artikel

Den här artikeln beskriver hur du använder en Bicep-fil för att distribuera en Azure AI Search-resurs 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.

Endast de egenskaper som ingår i mallen används i distributionen. Om det krävs 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.

Dricks

En alternativ Bicep-mall som distribuerar Azure AI Search med en förkonfigurerad indexerare till Cosmos DB för NoSQL finns i Bicep-distribution av Azure AI Search. Det finns inget stöd för bicep-mallar för azure AI Search-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

Bicep-filen som används i den här snabbstarten kommer 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
  }
}

Azure-resursen som definieras i den här Bicep-filen:

Distribuera Bicep-filen

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

  2. Distribuera Bicep-filen med 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å usluga pretrage. 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 bör du se ett meddelande som anger att distributionen lyckades.

Granska distribuerade resurser

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

az resource list --resource-group exampleRG

Rensa resurser

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

az group delete --name exampleRG

Nästa steg

I den här snabbstarten skapade du en Azure AI-usluga pretrage med hjälp av en Bicep-fil och verifierade sedan distributionen. Om du vill veta mer om Azure AI Search och Azure Resource Manager fortsätter du till artiklarna.