Hızlı Başlangıç: Bicep kullanarak Azure AI Search'i dağıtma

  • Makale

Bu makalede, Azure portalında Bir Azure AI Search kaynağı dağıtmak için Bicep dosyası kullanma işlemi adım adım açıklanmaktadır.

Bicep, Azure kaynaklarını dağıtmak için bildirim temelli söz dizimi kullanan, etki alanına özgü bir dildir (DSL). Kısa sözdizimi, güvenilir tür güvenliği ve kod yeniden kullanımı için destek sağlar. Bicep, Azure'daki kod olarak altyapı çözümleriniz için en iyi yazma deneyimini sunar.

Dağıtımda yalnızca şablona dahil edilen özellikler kullanılır. Ağ güvenliğini ayarlama gibi daha fazla özelleştirme gerekiyorsa, hizmeti dağıtım sonrası görev olarak güncelleştirebilirsiniz. Mevcut bir hizmeti en az adımla özelleştirmek için Azure CLI veya Azure PowerShell kullanın. Önizleme özelliklerini değerlendiriyorsanız Yönetim REST API'sini kullanın.

İpucu

Önceden yapılandırılmış dizin oluşturucuyla Azure AI Search'ün NoSQL için Cosmos DB'ye dağıtıldığı alternatif bir Bicep şablonu için bkz . Azure AI Search'ün Bicep dağıtımı. Dizin oluşturma gibi Azure AI Search veri düzlemi işlemleri için bicep şablonu desteği yoktur, ancak REST API'lerini çağıran bir modül ekleyebilirsiniz. Örnek, 5 dakikalık aralıklarla Cosmos DB'den yenilenen bir dizin, veri kaynağı bağlayıcısı ve dizin oluşturucu oluşturan bir modül içerir.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Bicep dosyasını gözden geçirme

Bu hızlı başlangıçta kullanılan Bicep dosyası Azure Hızlı Başlangıç Şablonları'ndan alınmıştı.

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

Bu Bicep dosyasında tanımlanan Azure kaynağı:

Bicep dosyasını dağıtma

  1. Bicep dosyasını main.bicep olarak yerel bilgisayarınıza kaydedin.

  2. Azure CLI veya Azure PowerShell kullanarak Bicep dosyasını dağıtın.

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

    Not

    hizmet-adını Arama hizmeti adıyla değiştirin<.> Hizmet adı yalnızca küçük harf, rakam veya kısa çizgi içermelidir. Tireyi ilk iki karakter veya son karakter olarak kullanamazsınız. Ad en az 2 karakter uzunluğunda ve en fazla 60 karakter uzunluğundadır.

    Dağıtım tamamlandığında, dağıtımın başarılı olduğunu belirten bir ileti görmeniz gerekir.

Dağıtılan kaynakları gözden geçirme

Kaynak grubundaki dağıtılan kaynakları listelemek için Azure portalını, Azure CLI'yı veya Azure PowerShell'i kullanın.

az resource list --resource-group exampleRG

Kaynakları temizleme

Azure AI Search faturalanabilir bir kaynaktır. Artık gerekli değilse, ücretlerden kaçınmak için aboneliğinizden silin. Kaynak grubunu ve kaynaklarını silmek için Azure portalını, Azure CLI'yı veya Azure PowerShell'i kullanabilirsiniz.

az group delete --name exampleRG

Sonraki adımlar

Bu hızlı başlangıçta, bicep dosyası kullanarak bir Azure yapay zeka Arama hizmeti oluşturdunuz ve ardından dağıtımı doğruladunuz. Azure AI Search ve Azure Resource Manager hakkında daha fazla bilgi edinmek için makalelere devam edin.