Szybki start: wdrażanie usługi Azure AI Search przy użyciu aplikacji Bicep

  • Artykuł

W tym artykule przedstawiono proces wdrażania zasobu usługi Azure AI Search w witrynie Azure Portal przy użyciu pliku Bicep.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Bicep oferuje najlepsze środowisko tworzenia rozwiązań infrastruktury jako kodu na platformie Azure.

We wdrożeniu są używane tylko te właściwości zawarte w szablonie. Jeśli wymagane jest większe dostosowanie, takie jak konfigurowanie zabezpieczeń sieci, możesz zaktualizować usługę jako zadanie po wdrożeniu. Aby dostosować istniejącą usługę za pomocą najmniejszych kroków, użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell. Jeśli oceniasz funkcje w wersji zapoznawczej, użyj interfejsu API REST zarządzania.

Napiwek

Aby uzyskać alternatywny szablon Bicep, który wdraża usługę Azure AI Search przy użyciu wstępnie skonfigurowanego indeksatora w usłudze Cosmos DB for NoSQL, zobacz Wdrażanie Bicep usługi Azure AI Search. Nie ma obsługi szablonu bicep dla operacji płaszczyzny danych usługi Azure AI Search, takich jak tworzenie indeksu, ale możesz dodać moduł wywołujący interfejsy API REST. Przykład zawiera moduł, który tworzy indeks, łącznik źródła danych i indeksator, który odświeża usługę Cosmos DB w 5-minutowych odstępach czasu.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Przejrzyj plik Bicep

Plik Bicep używany w tym przewodniku Szybki start pochodzi z szablonów szybkiego startu platformy Azure.

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

Zasób platformy Azure zdefiniowany w tym pliku Bicep:

Wdrażanie pliku Bicep

  1. Zapisz plik Bicep jako main.bicep na komputerze lokalnym.

  2. Wdróż plik Bicep przy użyciu interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

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

    Uwaga

    Zastąp <ciąg service-name> nazwą usługa wyszukiwania. Nazwa usługi musi zawierać tylko małe litery, cyfry lub kreski. Nie można użyć kreski jako pierwszych dwóch znaków ani ostatniego znaku. Nazwa ma minimalną długość 2 znaków i maksymalną długość 60 znaków.

    Po zakończeniu wdrażania powinien zostać wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Przeglądanie wdrożonych zasobów

Użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby wyświetlić listę wdrożonych zasobów w grupie zasobów.

az resource list --resource-group exampleRG

Czyszczenie zasobów

Usługa Azure AI Search to zasób rozliczany. Jeśli nie jest już potrzebna, usuń ją z subskrypcji, aby uniknąć naliczania opłat. Aby usunąć grupę zasobów i jej zasoby, możesz użyć witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

az group delete --name exampleRG

Następne kroki

W tym przewodniku Szybki start utworzono usługa wyszukiwania usługi Azure AI przy użyciu pliku Bicep, a następnie sprawdzono wdrożenie. Aby dowiedzieć się więcej na temat usługi Azure AI Search i usługi Azure Resource Manager, przejdź do artykułów.