Rövid útmutató: Az Azure AI Search üzembe helyezése a Bicep használatával

  • Cikk

Ez a cikk bemutatja, hogy egy Bicep-fájl használatával üzembe helyezhet egy Azure AI Search-erőforrást az Azure Portalon.

A Bicep tartományspecifikus nyelv (DSL), amely deklaratív szintaxist használ az Azure-erőforrások üzembe helyezéséhez. Tömör szintaxist és megbízható típusbiztonságot kínál, valamint biztosítja a kódok újrafelhasználhatóságát. A Bicep a legjobb szerzői élményt nyújtja az Azure-beli infrastruktúra-kódmegoldásokhoz.

A rendszer csak a sablonban szereplő tulajdonságokat használja az üzembe helyezéshez. Ha további testreszabásra van szükség, például a hálózati biztonság beállítására, frissítheti a szolgáltatást az üzembe helyezés utáni feladatként. Ha a lehető legkevesebb lépéssel szeretne testre szabni egy meglévő szolgáltatást, használja az Azure CLI-t vagy az Azure PowerShellt. Ha előzetes verziójú funkciókat értékel, használja a Felügyeleti REST API-t.

Tipp.

Az Azure AI Search előre konfigurált indexelővel történő üzembe helyezését a Cosmos DB for NoSQL-ben üzembe helyező alternatív Bicep-sablonért lásd az Azure AI Search Bicep-üzembe helyezését. Az Azure AI Search adatsík-műveleteihez( például indexek létrehozásához) nincs bicep-sablontámogatás, de hozzáadhat egy REST API-kat hívó modult. A minta tartalmaz egy modult, amely létrehoz egy indexet, egy adatforrás-összekötőt és egy indexelőt, amely 5 perces időközönként frissül a Cosmos DB-ből.

Előfeltételek

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

A Bicep-fájl áttekintése

Az ebben a rövid útmutatóban használt Bicep-fájl az Azure Gyorsindítási sablonokból származik.

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

Az ebben a Bicep-fájlban definiált Azure-erőforrás:

A Bicep-fájl üzembe helyezése

  1. Mentse a Bicep-fájlt main.bicep néven a helyi számítógépre.

  2. Telepítse a Bicep-fájlt az Azure CLI vagy az Azure PowerShell használatával.

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

    Feljegyzés

    Cserélje le <a szolgáltatásnevet> a Search szolgáltatás nevére. A szolgáltatásnév csak kisbetűket, számjegyeket vagy kötőjeleket tartalmazhat. Nem használhat kötőjelet az első két vagy az utolsó karakterként. A név legalább 2 karakter hosszúságú és legfeljebb 60 karakter hosszúságú.

    Amikor az üzembe helyezés befejeződött, egy üzenetnek kell megjelennie, amely jelzi, hogy az üzembe helyezés sikeres volt.

Üzembe helyezett erőforrások áttekintése

Az Azure Portal, az Azure CLI vagy az Azure PowerShell használatával listázhatja az erőforráscsoportban üzembe helyezett erőforrásokat.

az resource list --resource-group exampleRG

Az erőforrások eltávolítása

Az Azure AI Search egy számlázható erőforrás. Ha már nincs rá szükség, törölje az előfizetésből a díjak elkerülése érdekében. Az Azure Portal, az Azure CLI vagy az Azure PowerShell használatával törölheti az erőforráscsoportot és annak erőforrásait.

az group delete --name exampleRG

Következő lépések

Ebben a rövid útmutatóban létrehozott egy Azure AI-Search szolgáltatás egy Bicep-fájl használatával, majd érvényesítette az üzembe helyezést. Ha többet szeretne megtudni az Azure AI Searchről és az Azure Resource Managerről, folytassa a cikkekkel.