Condividi tramite

Avvio rapido: distribuire Azure AI Search con Bicep

  • Articolo

Questo articolo illustra il processo per l'uso di un file Bicep per distribuire una risorsa di Azure AI Search nel portale di Azure.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, indipendenza dai tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

Nella distribuzione vengono usate solo le proprietà incluse nel modello. Se sono necessarie altre personalizzazioni, ad esempio la configurazione della sicurezza di rete, è possibile aggiornare il servizio come attività post-distribuzione. Per personalizzare un servizio esistente con il numero minimo di passaggi, usare l’Interfaccia della riga di comando di Azure o Azure PowerShell. Se si stanno valutando le funzionalità di anteprima, usare l'API REST di gestione.

Suggerimento

Per un modello Bicep alternativo che distribuisca Azure AI Search con un indicizzatore preconfigurato in Cosmos DB per NoSQL, vedere Distribuzione Bicep di Azure AI Search. I modelli Bicep non supportano operazioni del piano dati di Azure AI Search, ad esempio la creazione di un indice, ma è possibile aggiungere un modulo che chiama le API REST. L'esempio include un modulo che crea un indice, un connettore di origine dati e un indicizzatore che viene aggiornato da Cosmos DB a intervalli di 5 minuti.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Esaminare il file Bicep

Il file Bicep usato in questo avvio rapido proviene dai modelli di avvio rapido di 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
  }
}

La risorsa di Azure definita in questo file Bicep:

Distribuire il file Bicep

  1. Salvare il file Bicep come main.bicep nel computer locale.

  2. Distribuisci il file Bicep usando l'interfaccia della riga di comando di Azure o Azure PowerShell.

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

    Nota

    Sostituire <service-name> con il nome del servizio di ricerca. Il nome del servizio deve contenere solo lettere minuscole, cifre o trattini. Non è possibile usare un trattino come primi due caratteri o come ultimo carattere. Il nome ha una lunghezza minima di 2 caratteri e una lunghezza massima di 60 caratteri.

    Al termine della distribuzione, visualizzerai un messaggio che indica che la distribuzione è stata completata.

Esaminare le risorse distribuite

Usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per elencare le risorse distribuite nel gruppo di risorse.

az resource list --resource-group exampleRG

Pulire le risorse

Azure AI Search è una risorsa fatturabile. Se non è più necessario, eliminarlo dalla sottoscrizione per evitare addebiti. È possibile usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per eliminare il gruppo di risorse e le relative risorse.

az group delete --name exampleRG

Passaggi successivi

In questo avvio rapido è stato creato un servizio Azure AI Search usando un file Bicep e quindi è stata convalidata la distribuzione. Per altre informazioni su Azure AI Search e Azure Resource Manager, continuare con gli articoli successivi.