Freigeben über

Schnellstart: Bereitstellen von Azure KI Search mithilfe von Bicep

  • Artikel

In diesem Artikel erfahren Sie Schritt für Schritt, wie Sie mithilfe einer Bicep-Datei eine Azure KI Search-Ressource im Azure-Portal bereitstellen.

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Nur die in der Vorlage enthaltenen Eigenschaften werden bei der Bereitstellung verwendet. Wenn weitere Anpassungen erforderlich sind, z. B. das Einrichten der Netzwerksicherheit, können Sie den Dienst als Aufgabe nach der Bereitstellung aktualisieren. Verwenden Sie die Azure CLI oder Azure PowerShell, um einen vorhandenen Dienst in möglichst wenigen Schritten anzupassen. Wenn Sie die Previewfunktionen testen möchten, verwenden Sie die Verwaltungs-REST-API.

Tipp

Eine alternative Bicep-Vorlage, die Azure KI Search mit einem vorkonfigurierten Indexer für Cosmos DB for NoSQL bereitstellt, finden Sie unter Bicep-Bereitstellung von Azure KI Search. Es gibt keine Unterstützung für Datenebenenvorgänge von Azure KI-Suche wie das Erstellen eines Indexes, aber Sie können ein Modul hinzufügen, das REST-APIs aufruft. Das Beispiel enthält ein Modul, das einen Index, einen Datenquellenconnector und einen Indexer erstellt, der in 5-Minuten-Intervallen von Cosmos DB aktualisiert wird.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

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

In dieser Bicep-Datei definierte Azure-Ressource:

Bereitstellen der Bicep-Datei

  1. Speichern Sie die Bicep-Datei als main.bicep auf Ihrem lokalen Computer.

  2. Stellen Sie die Bicep-Datei entweder mit Azure CLI oder mit Azure PowerShell bereit.

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

    Hinweis

    Ersetzen Sie <service-name> durch den Namen des Search-Diensts. Der Dienstname darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Sie können keinen Bindestrich als die ersten beiden Zeichen oder als letztes Zeichen verwenden. Der Name muss mindestens 2 Zeichen und darf höchstens 60 Zeichen lang sein.

    Nach Abschluss der Bereitstellung sollte eine Meldung mit dem Hinweis angezeigt werden, dass die Bereitstellung erfolgreich war.

Überprüfen der bereitgestellten Ressourcen

Verwenden Sie das Azure-Portal, die Azure CLI oder Azure PowerShell, um die bereitgestellten Ressourcen in der Ressourcengruppe aufzulisten.

az resource list --resource-group exampleRG

Bereinigen von Ressourcen

Azure AI Search ist eine abrechenbare Ressource. Wenn sie nicht mehr benötigt wird, löschen Sie sie aus Ihrem Abonnement, um Gebühren zu vermeiden. Sie können das Azure-Portal, die Azure CLI oder Azure PowerShell verwenden, um die Ressourcengruppe und die zugehörigen Ressourcen zu löschen.

az group delete --name exampleRG

Nächste Schritte

In dieser Schnellstartanleitung haben Sie mithilfe einer Bicep-Datei einen Azure KI Search-Dienst erstellt und die Bereitstellung anschließend überprüft. Weitere Informationen zu Azure KI-Suche und Azure Resource Manager finden Sie in den Artikeln.