クイックスタート: Azure Resource Manager テンプレートを使用して Azure AI Search をデプロイする

[アーティクル]
04/24/2024

このアーティクルでは、Azure Resource Manager (ARM) テンプレートを使用して Azure portal で Azure AI Search リソースをデプロイするプロセスについて説明します。

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。このテンプレートでは、宣言型の構文が使用されています。デプロイを作成するプログラミングコマンドのシーケンスを記述しなくても、そのデプロイに関する意図を記述できます。

テンプレートに含まれているプロパティのみが、デプロイで使用されます。ネットワークセキュリティの設定など、カスタマイズがさらに必要な場合は、デプロイ後のタスクとして、サービスを更新することができます。既存のサービスを最も少ない手順でカスタマイズするには、Azure CLI または Azure PowerShell を使用します。プレビュー機能を評価する場合は、Management REST API を使用します。

環境が前提条件を満たしており、ARM テンプレートの使用に慣れている場合は、[Azure へのデプロイ] ボタンを選択します。 Azure portal でテンプレートが開きます。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

テンプレートを確認する

このクイックスタートで使用されるテンプレートは Azure クイックスタートテンプレートからのものです。

{
  "$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')]"
      }
    }
  ]
}

このテンプレートで定義されている Azure リソースは次のとおりです。

Microsoft.Search/searchServices: Azure AI Search Serviceを作成する

テンプレートのデプロイ

Azure にサインインし、テンプレートを開くには次のイメージを選択します。このテンプレートでは、Azure AI Search リソースが作成されます。

ポータルには、パラメーター値を簡単に指定できるフォームが表示されます。一部のパラメーターには、テンプレートの既定値があらかじめ入力されています。サブスクリプション、リソースグループ、場所、サービス名を指定する必要があります。 AI エンリッチメントパイプラインで Azure AI サービスを使用する場合 (テキスト用のバイナリ画像ファイルを分析する場合など)、Azure AI Search と Azure AI サービスの両方を提供する場所を選択します。 AI エンリッチメントワークロードでは、その両方のサービスが同じリージョンに存在する必要があります。フォームへの入力が済んだら、使用条件に同意し、購入ボタンを選択して、デプロイを完了する必要があります。

デプロイされているリソースを確認する

デプロイが完了したら、ポータルから新しいリソースグループと新しい検索サービスにアクセスすることができます。

リソースをクリーンアップする

Azure AI Search に関する他のクイックスタートとチュートリアルは、このクイックスタートにビルドされています。後続のクイックスタートおよびチュートリアルを引き続き実行する場合は、このリソースをそのまま残しておくことをお勧めします。不要になったら、リソースグループを削除すると、Azure AI Search Serviceと関連リソースが削除されます。

次のステップ

このクイックスタートでは、ARM テンプレートを使用して Azure AI Search Serviceを作成し、デプロイを検証しました。 Azure AI Search と Azure Resource Manager の詳細については、以下のアーティクルに進んでください。

Azure AI Search の概要を確認します。
検索サービス用のインデックスを作成します。
ポータルのウィザードを使用してデモアプリを作成します。
データから情報を抽出するためのスキルセットを作成します。

クイック スタート: Azure Resource Manager テンプレートを使用して Azure AI Search をデプロイする