Поделиться через

Краткое руководство. Развертывание поиска ИИ Azure с помощью Bicep

  • Статья

В этой статье описывается процесс использования Bicep-файла для развертывания ресурса поиска ИИ Azure в портал Azure.

Bicep — это предметно-ориентированный язык (DSL), который использует декларативный синтаксис для развертывания ресурсов Azure. Он обеспечивает краткий синтаксис, надежную безопасность типов и поддержку повторного использования кода. Bicep предлагает лучшие возможности для разработки решений Azure типа "инфраструктура как код".

В развертывании используются только те свойства, которые включены в шаблон. Если требуется дополнительная настройка, например настройка сетевой безопасности, можно обновить службу как задачу после развертывания. Чтобы настроить существующую службу с помощью нескольких шагов, используйте Azure CLI или Azure PowerShell. Если вы оцениваете предварительные версии функций, используйте REST API управления.

Совет

Альтернативный шаблон Bicep, который развертывает поиск ИИ Azure с предварительно настроенным индексатором в Cosmos DB для NoSQL, см. в статье Bicep deployment of Azure AI Search. Нет поддержки шаблонов bicep для операций плоскости данных поиска Azure AI, таких как создание индекса, но можно добавить модуль, вызывающий 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
  }
}

Ресурс Azure, определенный в этом файле Bicep:

Развертывание BICEP-файла

  1. Сохраните файл Bicep с именем main.bicep на локальном компьютере.

  2. Разверните файл Bicep с помощью Azure CLI или Azure PowerShell.

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

    Примечание.

    Замените <имя> службы именем служба . Имя службы должно содержать только строчные буквы, цифры или дефисы. Не удается использовать дефис в качестве первых двух символов или последнего символа. Имя имеет минимальную длину 2 символов и максимальную длину 60 символов.

    После завершения развертывания должно отобразиться сообщение о том, что развертывание успешно выполнено.

Просмотр развернутых ресурсов

Используйте портал Azure, Azure CLI или Azure PowerShell для получения списка ресурсов, развернутых в группе ресурсов.

az resource list --resource-group exampleRG

Очистка ресурсов

Поиск по искусственному интеллекту Azure — это оплачиваемый ресурс. Если она больше не нужна, удалите ее из подписки, чтобы избежать расходов. Вы можете использовать портал Azure, Azure CLI или Azure PowerShell для удаления группы ресурсов и ее ресурсов.

az group delete --name exampleRG

Следующие шаги

В этом кратком руководстве вы создали azure AI служба с помощью Bicep-файла, а затем проверили развертывание. Дополнительные сведения о поиске ИИ Azure и Azure Resource Manager см. в статьях.