Mulai cepat: Menyebarkan Pencarian Azure AI menggunakan Bicep

  • Artikel

Artikel ini memandu Anda melalui proses penggunaan file Bicep untuk menyebarkan sumber daya Azure AI Search di portal Azure.

Bicep adalah bahasa pemrogram khusus domain (DSL) yang menggunakan sintaks deklaratif untuk menyebarkan sumber daya Azure. Bicep menyediakan sintaks ringkas, keamanan jenis yang andal, dan dukungan untuk penggunaan kembali kode. Bicep menawarkan pengalaman penulisan terbaik untuk solusi infrastructure-as-code di Azure.

Hanya properti yang disertakan dalam templat yang digunakan dalam penyebaran. Jika diperlukan lebih banyak penyesuaian, seperti menyiapkan keamanan jaringan, Anda dapat memperbarui layanan sebagai tugas pasca-penyebaran. Untuk mengkustomisasi layanan yang sudah ada dengan langkah-langkah terkecil, gunakan Azure CLI atau Azure PowerShell. Jika Anda mengevaluasi fitur pratinjau, gunakan REST API Manajemen.

Tip

Untuk templat Bicep alternatif yang menyebarkan Azure AI Search dengan pengindeks yang telah dikonfigurasi sebelumnya ke Cosmos DB for NoSQL, lihat Penyebaran Bicep azure AI Search. Tidak ada dukungan templat bicep untuk operasi sarana data Azure AI Search seperti membuat indeks, tetapi Anda dapat menambahkan modul yang memanggil REST API. Sampel mencakup modul yang membuat indeks, konektor sumber data, dan pengindeks yang di-refresh dari Cosmos DB pada interval 5 menit.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Tinjau file Bicep

File Bicep yang digunakan dalam mulai cepat berasal dari Templat Mulai Cepat 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
  }
}

Sumber daya Azure yang ditentukan dalam file Bicep ini:

Menerapkan file Bicep

  1. Simpan file Bicep sebagai main.bicep ke penyimpanan lokal komputer Anda.

  2. Sebarkan file Bicep menggunakan Azure CLI atau Azure PowerShell.

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

    Catatan

    Ganti <nama> layanan dengan nama layanan Pencarian. Nama layanan hanya boleh berisi huruf kecil, digit, atau tanda hubung. Anda tidak dapat menggunakan tanda hubung sebagai dua karakter pertama atau karakter terakhir. Nama ini memiliki panjang minimum 2 karakter dan panjang maksimum 60 karakter.

    Setelah penyebaran selesai, Anda akan melihat pesan yang menunjukkan penyebaran berhasil.

Meninjau sumber daya yang disebarkan

Gunakan portal Microsoft Azure, Azure CLI, atau Azure PowerShell untuk mencantumkan sumber daya yang disebarkan di grup sumber daya.

az resource list --resource-group exampleRG

Membersihkan sumber daya

Azure AI Search adalah sumber daya yang dapat ditagih. Jika tidak lagi diperlukan, hapus dari langganan Anda untuk menghindari biaya. Anda dapat menggunakan portal Azure, Azure CLI, atau Azure PowerShell untuk menghapus grup sumber daya dan sumber dayanya.

az group delete --name exampleRG

Langkah berikutnya

Dalam mulai cepat ini, Anda membuat azure AI layanan Pencarian menggunakan file Bicep, lalu memvalidasi penyebaran. Untuk mempelajari selengkapnya tentang Azure AI Search dan Azure Resource Manager, lanjutkan ke artikel.