Quickstart: Azure AI Search implementeren met Bicep

  • Artikel

In dit artikel wordt u begeleid bij het doorlopen van het proces voor het gebruik van een Bicep-bestand voor het implementeren van een Azure AI Search-resource in Azure Portal.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Alleen de eigenschappen die in de sjabloon zijn opgenomen, worden gebruikt in de implementatie. Als er meer aanpassingen nodig zijn, zoals het instellen van netwerkbeveiliging, kunt u de service bijwerken als een taak na de implementatie. Als u een bestaande service wilt aanpassen met de minste stappen, gebruikt u Azure CLI of Azure PowerShell. Als u preview-functies evalueert, gebruikt u de REST API van Management.

Tip

Zie Bicep-implementatie van Azure AI Search voor een alternatieve Bicep-sjabloon met een vooraf geconfigureerde indexeerfunctie in Cosmos DB voor NoSQL. Er is geen bicep-sjabloonondersteuning voor bewerkingen in het gegevensvlak van Azure AI Search, zoals het maken van een index, maar u kunt een module toevoegen die REST API's aanroept. Het voorbeeld bevat een module waarmee een index, gegevensbronconnector en een indexeerfunctie worden gemaakt die met intervallen van vijf minuten wordt vernieuwd vanuit Cosmos DB.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Het Bicep-bestand controleren

Het Bicep-bestand dat in deze quickstart wordt gebruikt, is afkomstig van Azure-quickstartsjablonen.

@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
  }
}

De Azure-resource die is gedefinieerd in dit Bicep-bestand:

Het Bicep-bestand implementeren

  1. Sla het Bicep-bestand op als main.bicep op uw lokale computer.

  2. Implementeer het Bicep-bestand met behulp van Azure CLI of Azure PowerShell.

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

    Notitie

    Vervang <de servicenaam> door de naam van de Search-service. De servicenaam mag alleen kleine letters, cijfers of streepjes bevatten. U kunt geen streepje gebruiken als de eerste twee tekens of het laatste teken. De naam heeft een minimale lengte van 2 tekens en een maximumlengte van 60 tekens.

    Wanneer de implementatie is voltooid, ziet u een bericht waarin wordt aangegeven dat de implementatie is voltooid.

Geïmplementeerde resources bekijken

Gebruik Azure Portal, Azure CLI of Azure PowerShell om de geïmplementeerde resources in de resourcegroep weer te geven.

az resource list --resource-group exampleRG

Resources opschonen

Azure AI Search is een factureerbare resource. Als u deze niet meer nodig hebt, verwijdert u deze uit uw abonnement om kosten te voorkomen. U kunt Azure Portal, Azure CLI of Azure PowerShell gebruiken om de resourcegroep en de bijbehorende resources te verwijderen.

az group delete --name exampleRG

Volgende stappen

In deze quickstart hebt u een Azure AI-Search-service gemaakt met behulp van een Bicep-bestand en vervolgens de implementatie gevalideerd. Ga verder met de artikelen voor meer informatie over Azure AI Search en Azure Resource Manager.