빠른 시작: ARM 템플릿을 사용하여 Cognitive Search 배포Quickstart: Deploy Cognitive Search using an ARM template

이 문서에서는 ARM 템플릿(Azure Resource Manager 템플릿)을 사용하여 Azure Cognitive Search 리소스를 Azure Portal에 배포하는 과정을 안내합니다.This article walks you through the process for using an Azure Resource Manager template (ARM template) to deploy an Azure Cognitive Search resource in the Azure portal.

ARM 템플릿은 프로젝트에 대한 인프라 및 구성을 정의하는 JSON(JavaScript Object Notation) 파일입니다.An ARM template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. 이 템플릿은 선언적 구문을 사용합니다.The template uses declarative syntax. 선언적 구문에서는 배포를 만들기 위한 프로그래밍 명령의 시퀀스를 작성하지 않고 의도하는 배포를 설명합니다.In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

환경이 필수 구성 요소를 충족하고 ARM 템플릿 사용에 익숙한 경우 Azure에 배포 단추를 선택합니다.If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. 그러면 Azure Portal에서 템플릿이 열립니다.The template will open in the Azure portal.

Azure에 배포Deploy to Azure

필수 구성 요소Prerequisites

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

템플릿 검토Review the template

이 빠른 시작에서 사용되는 템플릿은 Azure 빠른 시작 템플릿에서 나온 것입니다.The template used in this quickstart is from Azure Quickstart Templates.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "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",
      "allowedValues": [
        "free",
        "basic",
        "standard",
        "standard2",
        "standard3",
        "storage_optimized_l1",
        "storage_optimized_l2"
      ],
      "metadata": {
        "description": "The pricing tier of the search service you want to create (for example, basic or standard)."
      }
    },
    "replicaCount": {
      "type": "int",
      "defaultValue": 1,
      "minValue": 1,
      "maxValue": 12,
      "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-03-13",
      "name": "[parameters('name')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[toLower(parameters('sku'))]"
      },
      "properties": {
        "replicaCount": "[parameters('replicaCount')]",
        "partitionCount": "[parameters('partitionCount')]",
        "hostingMode": "[parameters('hostingMode')]"
      }
    }
  ]
}

이 템플릿에 정의된 Azure 리소스는 다음과 같습니다.The Azure resource defined in this template:

템플릿 배포Deploy the template

다음 이미지를 선택하고 Azure에 로그인하여 템플릿을 엽니다.Select the following image to sign in to Azure and open a template. 이 템플릿은 Azure Cognitive Search 리소스를 만듭니다.The template creates an Azure Cognitive Search resource.

Azure에 배포Deploy to Azure

포털에는 매개 변수 값을 쉽게 입력할 수 있는 양식이 표시됩니다.The portal displays a form that allows you to easily provide parameter values. 일부 매개 변수는 템플릿의 기본값으로 미리 채워져 있습니다.Some parameters are pre-filled with the default values from the template. 구독, 리소스 그룹, 위치 및 서비스 이름을 입력해야 합니다.You will need to provide your subscription, resource group, location, and service name. AI 보강 파이프라인에서 Cognitive Services를 사용하려면(예: 텍스트의 이진 이미지 파일 분석) Cognitive Search 및 Cognitive Services를 모두 제공하는 위치를 선택합니다.If you want to use Cognitive Services in an AI enrichment pipeline, for example to analyze binary image files for text, choose a location that offers both Cognitive Search and Cognitive Services. 두 서비스가 AI 보강 워크로드에 대한 동일한 지역에 있어야 합니다.Both services are required to be in the same region for AI enrichment workloads. 양식을 모두 작성한 후에는 사용 약관에 동의하고 구매 단추를 선택하여 배포를 완료해야 합니다.Once you have completed the form, you will need to agree to the terms and conditions and then select the purchase button to complete your deployment.

Azure Portal에 표시되는 템플릿Azure portal display of template

배포된 리소스 검토Review deployed resources

배포가 완료되면 포털에서 새 리소스 그룹 및 새 검색 서비스에 액세스할 수 있습니다.When your deployment is complete you can access your new resource group and new search service in the portal.

리소스 정리Clean up resources

다른 Cognitive Search 빠른 시작과 자습서는 이 빠른 시작을 기반으로 작성됩니다.Other Cognitive Search quickstarts and tutorials build upon this quickstart. 후속 빠른 시작과 자습서를 계속 진행할 계획이라면 이 리소스를 그대로 두는 것이 좋습니다.If you plan to continue on to work with subsequent quickstarts and tutorials, you may wish to leave this resource in place. 이 리소스가 더 이상 필요 없으면 리소스 그룹을 삭제해도 됩니다. 그러면 Cognitive Search 서비스 및 관련 리소스가 삭제됩니다.When no longer needed, you can delete the resource group, which deletes the Cognitive Search service and related resources.

다음 단계Next steps

이 빠른 시작에서는 ARM 템플릿을 사용하여 Cognitive Search 서비스를 만들고 배포의 유효성을 검사했습니다.In this quickstart, you created a Cognitive Search service using an ARM template, and validated the deployment. Cognitive Search 및 Azure Resource Manager에 대해 자세히 알아보려면 아래 문서를 계속 진행하세요.To learn more about Cognitive Search and Azure Resource Manager, continue on to the articles below.