Início rápido: implantar IA do Azure Search usando Bicep

  • Artigo

Este artigo descreve o processo de uso de um arquivo Bicep para implantar um recurso da IA do Azure Search no portal do Azure.

O Bicep é um DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Somente as propriedades incluídas no modelo são usadas na implantação. Se for necessário mais personalização, como configurar a segurança de rede, você poderá atualizar o serviço como tarefa pós-implantação. Para personalizar um serviço existente com o menor número de etapas, use a CLI do Azure ou o Azure PowerShell. Se você estiver avaliando a versão prévia do recurso, use a API REST de Gerenciamento.

Dica

Para obter um modelo Bicep alternativo que implanta a IA do Azure Search com um indexador pré-configurado no Cosmos DB for NoSQL, confira Implantação do Bicep da IA do Azure Search. Não há suporte para o modelo Bicep para operações do plano de dados do Azure AI Search, como a criação de um índice, mas você pode adicionar um módulo que chama APIs REST. O exemplo inclui um módulo que cria um índice, um conector de fonte de dados e um indexador que é atualizado do Cosmos DB em intervalos de 5 minutos.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Examinar o arquivo Bicep

O arquivo Bicep usado neste guia de início rápido vem dos Modelos de início rápido do 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
  }
}

O recurso do Azure definido neste arquivo Bicep:

Implante o arquivo Bicep

  1. Salve o arquivo Bicep como main.bicep em seu computador local.

  2. Para implantar o arquivo Bicep, use a CLI do Azure ou o Azure PowerShell.

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

    Observação

    Substitua <service-name> pelo nome do serviço Pesquisa. O nome do serviço deve conter apenas letras minúsculas, dígitos ou traços. Você não pode usar um traço como os dois primeiros caracteres ou o último caractere. O nome tem um comprimento mínimo de 2 caracteres e um comprimento máximo de 60 caracteres.

    Quando a implantação for concluída, você deverá ver uma mensagem indicando que ela foi bem-sucedida.

Examinar os recursos implantados

Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos.

az resource list --resource-group exampleRG

Limpar os recursos

O Azure AI Search é um recurso faturável. Se não for mais necessário, exclua-o de sua assinatura para evitar encargos. Quando não for mais necessário, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e seus recursos.

az group delete --name exampleRG

Próximas etapas

Neste guia de início rápido, você criou um serviço da IA do Azure Search usando um arquivo Bicep e validou a implantação. Para saber mais sobre a Pesquisa de IA do Azure e do Azure Resource Manager, prossiga para os artigos abaixo.