Rychlý start: Nasazení služby Azure AI Search pomocí Bicep

  • Článek

Tento článek vás provede procesem použití souboru Bicep k nasazení prostředku Azure AI Search na webu Azure Portal.

Bicep je jazyk specifický pro doménu (DSL), který k nasazování prostředků Azure používá deklarativní syntaxi. Poskytuje stručnou syntaxi, spolehlivou bezpečnost typů a podporu pro opakované použití kódu. Bicep nabízí nejlepší prostředí pro vytváření obsahu pro řešení infrastruktury jako kódu v Azure.

V nasazení se používají pouze tyto vlastnosti zahrnuté v šabloně. Pokud se vyžaduje další přizpůsobení, například nastavení zabezpečení sítě, můžete službu aktualizovat jako úlohu po nasazení. Pokud chcete přizpůsobit existující službu s nejmenšími kroky, použijte Azure CLI nebo Azure PowerShell. Pokud vyhodnocujete funkce ve verzi Preview, použijte rozhraní REST API pro správu.

Tip

Alternativní šablonu Bicep, která nasazuje Azure AI Search s předem nakonfigurovaným indexerem do Cosmos DB for NoSQL, najdete v tématu Bicep nasazení služby Azure AI Search. Neexistuje žádná podpora šablon bicep pro operace roviny dat Azure AI Search, jako je vytvoření indexu, ale můžete přidat modul, který volá rozhraní REST API. Ukázka obsahuje modul, který vytvoří index, konektor zdroje dat a indexer, který se aktualizuje ze služby Cosmos DB v 5minutových intervalech.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.

Kontrola souboru Bicep

Soubor Bicep použitý v tomto rychlém startu pochází ze šablon Azure Pro rychlý start.

@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
  }
}

Prostředek Azure definovaný v tomto souboru Bicep:

Nasazení souboru Bicep

  1. Uložte soubor Bicep jako main.bicep do místního počítače.

  2. Nasaďte soubor Bicep pomocí Azure CLI nebo Azure PowerShellu.

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

    Poznámka:

    Nahraďte <název> služby názvem Search. Název služby musí obsahovat jenom malá písmena, číslice nebo pomlčky. Jako první dva znaky ani poslední znak nemůžete použít pomlčku. Název má minimální délku 2 znaků a maximální délku 60 znaků.

    Po dokončení nasazení by se měla zobrazit zpráva, že nasazení bylo úspěšné.

Kontrola nasazených prostředků

Pomocí webu Azure Portal, Azure CLI nebo Azure PowerShellu můžete zobrazit seznam nasazených prostředků ve skupině prostředků.

az resource list --resource-group exampleRG

Vyčištění prostředků

Azure AI Search je fakturovatelný prostředek. Pokud už ho nepotřebujete, odstraňte ho z předplatného, abyste se vyhnuli poplatkům. K odstranění skupiny prostředků a jejích prostředků můžete použít Azure Portal, Azure CLI nebo Azure PowerShell.

az group delete --name exampleRG

Další kroky

V tomto rychlém startu jste vytvořili Search Azure AI pomocí souboru Bicep a pak jste nasazení ověřili. Další informace o službě Azure AI Search a Azure Resource Manageru najdete v článcích.