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

Makale
01/30/2025

Bu makalede, Azure portalında Azure AI Search kaynağı dağıtmak için Azure Resource Manager (ARM) şablonu kullanma işlemi adım adım açıklanmaktadır.

Azure Resource Manager şablonu, projenizin altyapısını ve yapılandırmasını tanımlayan bir JavaScript Nesne Gösterimi (JSON) dosyasıdır. Bu şablonda, bildirim temelli sözdizimi kullanılır. Dağıtımı oluşturmak için programlama komutlarının sırasını yazmadan hedeflenen dağıtımınızı açıklarsınız.

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.

Ortamınızın önkoşulları karşıladığını ve ARM şablonlarını kullanmayı bildiğinizi varsayarsak Azure'a Dağıt düğmesini seçin. Şablon Azure portalda açılır.

Önkoşullar

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

Şablonu gözden geçirme

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

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "11257266040777038564"
    }
  },
  "parameters": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "metadata": {
        "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."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "standard",
      "metadata": {
        "description": "The pricing tier of the search service you want to create (for example, basic or standard)."
      },
      "allowedValues": [
        "free",
        "basic",
        "standard",
        "standard2",
        "standard3",
        "storage_optimized_l1",
        "storage_optimized_l2"
      ]
    },
    "replicaCount": {
      "type": "int",
      "defaultValue": 1,
      "maxValue": 12,
      "minValue": 1,
      "metadata": {
        "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)."
      }
    },
    "partitionCount": {
      "type": "int",
      "defaultValue": 1,
      "allowedValues": [
        1,
        2,
        3,
        4,
        6,
        12
      ],
      "metadata": {
        "description": "Partitions allow for scaling of document count as well as faster indexing by sharding your index over multiple search units."
      }
    },
    "hostingMode": {
      "type": "string",
      "defaultValue": "default",
      "allowedValues": [
        "default",
        "highDensity"
      ],
      "metadata": {
        "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."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Search/searchServices",
      "apiVersion": "2020-08-01",
      "name": "[parameters('name')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]"
      },
      "properties": {
        "replicaCount": "[parameters('replicaCount')]",
        "partitionCount": "[parameters('partitionCount')]",
        "hostingMode": "[parameters('hostingMode')]"
      }
    }
  ]
}

Bu şablonda tanımlanan Azure kaynağı:

Microsoft.Search/searchServices: Azure AI Arama hizmeti oluşturma

Şablonu dağıtma

Aşağıdaki görüntüyü seçerek Azure'da oturum açıp bir şablon açın. Şablon bir Azure AI Search kaynağı oluşturur.

Azure portalı, parametre değerlerini kolayca sağlamanıza olanak tanıyan bir form görüntüler. Bazı parametreler şablondaki varsayılan değerlerle önceden doldurulur. Aboneliğinizi, kaynak grubunuzu, konumunuzu ve hizmet adınızı sağlamanız gerekir. Azure AI hizmetlerini bir yapay zeka zenginleştirme işlem hattında kullanmak istiyorsanız (örneğin, metin için ikili görüntü dosyalarını analiz etmek için) hem Azure AI Search hem de Azure AI hizmetleri sunan bir konum seçin. Yapay zeka zenginleştirme iş yükleri için her iki hizmetin de aynı bölgede olması gerekir. Formu tamamladıktan sonra, hüküm ve koşulları kabul etmeniz ve ardından dağıtımınızı tamamlamak için satın alma düğmesini seçmeniz gerekir.

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

Dağıtımınız tamamlandığında Azure portalında yeni kaynak grubunuz ve yeni arama hizmetinize erişebilirsiniz.

Kaynakları temizleme

Diğer Azure AI Search hızlı başlangıçları ve öğreticileri bu hızlı başlangıcı temel alır. Sonraki hızlı başlangıçlar ve öğreticilerle çalışmaya devam etmek istiyorsanız, bu kaynağı yerinde bırakmak isteyebilirsiniz. Artık gerekmediğinde kaynak grubunu silip Azure AI Arama hizmeti ve ilgili kaynakları silebilirsiniz.

Sonraki adımlar

Bu hızlı başlangıçta ARM şablonu kullanarak bir Azure AI Arama hizmeti oluşturdunuz ve dağıtımı doğruladunuz. Azure AI Search ve Azure Resource Manager hakkında daha fazla bilgi edinmek için aşağıdaki makalelere geçin.

Azure AI Search'e genel bir bakış okuyun.
Arama hizmetiniz için bir dizin oluşturun.
Azure portalı sihirbazını kullanarak bir tanıtım uygulaması oluşturun.
Verilerinizden bilgi ayıklamak için bir beceri kümesi oluşturun.

Aracılığıyla paylaş