다음을 통해 공유

빠른 시작: Bicep을 사용하여 Azure AI Search 배포

  • 아티클

이 문서에서는 Bicep 파일을 사용하여 Azure Portal에 Azure AI Search 리소스를 배포하는 과정을 안내합니다.

Bicep은 선언적 구문을 사용하여 Azure 리소스를 배포하는 DSL(도메인 특정 언어)입니다. 간결한 구문, 신뢰할 수 있는 형식 안전성 및 코드 다시 사용에 대한 지원을 제공합니다. Bicep은 Azure에서 코드형 인프라 솔루션에 대한 최고의 제작 환경을 제공합니다.

템플릿에 포함된 속성만 배포에 사용됩니다. 네트워크 보안 설정과 같은 추가 사용자 지정이 필요한 경우 서비스를 배포 후 작업으로 업데이트할 수 있습니다. 최소한의 단계로 기존 서비스를 사용자 지정하려면 Azure CLI 또는 Azure PowerShell을 사용합니다. 미리 보기 기능을 평가하는 경우 관리 REST API를 사용합니다.

팁

미리 구성된 인덱서가 있는 Azure AI Search를 Cosmos DB for NoSQL에 배포하는 대체 Bicep 템플릿은 Azure AI Search의 Bicep 배포를 참조하세요. 인덱스 만들기와 같은 Azure AI 검색 데이터 평면 작업에 대한 bicep 템플릿 지원은 없지만 REST API를 호출하는 모듈을 추가할 수 있습니다. 샘플에는 인덱스 및 데이터 원본 커넥터를 만드는 모듈과 Cosmos DB에서 5분 간격으로 새로 고치는 인덱서가 포함되어 있습니다.

필수 조건

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

Bicep 파일 검토

이 빠른 시작에서 사용되는 Bicep 파일은 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
  }
}

이 Bicep 파일에 정의된 Azure 리소스:

Bicep 파일 배포

  1. Bicep 파일을 main.bicep으로 로컬 컴퓨터에 저장합니다.

  2. Azure CLI 또는 Azure PowerShell을 사용하여 Bicep 파일을 배포합니다.

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

    참고 항목

    <service-name>을 Search Service 이름으로 바꿉니다. 서비스 이름에는 소문자, 숫자, 대시만 포함되어야 합니다. 대시는 처음 두 문자 또는 마지막 문자로 사용할 수 없습니다. 이름은 최소 2자, 최대 길이 60자까지 입력할 수 있습니다.

    배포가 완료되면 배포에 성공했음을 나타내는 메시지가 표시됩니다.

배포된 리소스 검토

Azure Portal, Azure CLI 또는 Azure PowerShell을 사용하여 리소스 그룹에 배포된 리소스를 나열합니다.

az resource list --resource-group exampleRG

리소스 정리

Azure AI 검색은 청구 가능한 리소스입니다. 더 이상 필요하지 않은 경우 요금이 부과되지 않도록 구독에서 삭제합니다. Azure Portal, Azure CLI 또는 Azure PowerShell을 사용하여 리소스 그룹 및 해당 리소스를 삭제할 수 있습니다.

az group delete --name exampleRG

다음 단계

이 빠른 시작에서는 Bicep 파일을 사용하여 Azure AI Search 서비스를 만들고 배포의 유효성을 검사했습니다. Azure AI 검색 및 Azure Resource Manager에 대해 자세히 알아보려면 문서를 계속 살펴보세요.