Schnellstart: Bereitstellen von Azure KI Search mithilfe von Bicep

Hinweis

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Verwenden Sie in dieser Schnellstartanleitung eine Bicep Datei, um einen Azure KI-Suche Dienst im Azure-Portal bereitzustellen.

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.

Die Bereitstellung verwendet nur die eigenschaften, die in der Vorlage enthalten sind. Wenn Sie weitere Anpassungen benötigen, 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-Suche mit einem vorkonfigurierten Indexer für Cosmos DB für NoSQL bereitstellt, finden Sie unter Bicep Bereitstellung von Azure KI-Suche. Es gibt keine Bicep Vorlagenunterstützung für Azure KI-Suche Datenebenenvorgänge 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

Diese Schnellstartanleitung verwendet eine Bicep-Datei aus 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
  }
}

Die datei Bicep definiert die folgende Azure Ressource:

Bereitstellen der Bicep-Datei

  1. Speichern Sie die Bicep-Datei unter dem Namen main.bicep auf Ihrem lokalen Computer.

  2. Stellen Sie die Bicep Datei mithilfe von Azure CLI oder 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 wird eine Meldung mit dem Hinweis angezeigt, 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 KI-Suche ist eine abrechenbare Ressource. Wenn Sie sie nicht mehr benötigen, löschen Sie es 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

Verwandte Inhalte

In dieser Schnellstartanleitung haben Sie einen Azure KI-Suche-Dienst mit einer Bicep-Datei erstellt und dann die Bereitstellung überprüft. Weitere Informationen zu Azure KI-Suche und Azure Resource Manager finden Sie in den folgenden Artikeln:

  • Last updated on