Hızlı Başlangıç: Bicep kullanarak Azure AI Search'i dağıtma
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ğı:
- Microsoft.Search/searchServices: Azure AI Arama hizmeti oluşturma
Bicep dosyasını dağıtma
Bicep dosyasını main.bicep olarak yerel bilgisayarınıza kaydedin.
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.
- Azure AI Search'e genel bir bakış okuyun.
- Arama hizmetiniz için bir dizin oluşturun.
- Portal sihirbazını kullanarak bir tanıtım uygulaması oluşturun.
- Verilerinizden bilgi ayıklamak için bir beceri kümesi oluşturun.