Quickstart: Azure AI Search implementeren met behulp van een Azure Resource Manager-sjabloon

  • Artikel

In dit artikel wordt u begeleid bij het doorlopen van het proces voor het gebruik van een ARM-sjabloon (Azure Resource Manager) voor het implementeren van een Azure AI Search-resource in Azure Portal.

Een Azure Resource Manager-sjabloon is een JSON-bestand (JavaScript Object Notation) dat de infrastructuur en configuratie voor uw project definieert. Voor de sjabloon is declaratieve syntaxis vereist. U beschrijft de beoogde implementatie zonder de reeks programmeeropdrachten te schrijven om de implementatie te maken.

Alleen de eigenschappen die in de sjabloon zijn opgenomen, worden gebruikt in de implementatie. Als er meer aanpassingen nodig zijn, zoals het instellen van netwerkbeveiliging, kunt u de service bijwerken als een taak na de implementatie. Als u een bestaande service wilt aanpassen met de minste stappen, gebruikt u Azure CLI of Azure PowerShell. Als u preview-functies evalueert, gebruikt u de REST API van Management.

Als uw omgeving voldoet aan de vereisten en u bekend bent met het gebruik van ARM-sjablonen, selecteert u de knop Implementeren in Azure . De sjabloon wordt in Azure Portal geopend.

Button to deploy the Resource Manager template to Azure.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

De sjabloon controleren

De sjabloon die in deze quickstart wordt gebruikt, komt uit Azure-snelstartsjablonen.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "11257266040777038564"
    }
  },
  "parameters": {
    "name": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "metadata": {
        "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."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "standard",
      "metadata": {
        "description": "The pricing tier of the search service you want to create (for example, basic or standard)."
      },
      "allowedValues": [
        "free",
        "basic",
        "standard",
        "standard2",
        "standard3",
        "storage_optimized_l1",
        "storage_optimized_l2"
      ]
    },
    "replicaCount": {
      "type": "int",
      "defaultValue": 1,
      "maxValue": 12,
      "minValue": 1,
      "metadata": {
        "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)."
      }
    },
    "partitionCount": {
      "type": "int",
      "defaultValue": 1,
      "allowedValues": [
        1,
        2,
        3,
        4,
        6,
        12
      ],
      "metadata": {
        "description": "Partitions allow for scaling of document count as well as faster indexing by sharding your index over multiple search units."
      }
    },
    "hostingMode": {
      "type": "string",
      "defaultValue": "default",
      "allowedValues": [
        "default",
        "highDensity"
      ],
      "metadata": {
        "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."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Search/searchServices",
      "apiVersion": "2020-08-01",
      "name": "[parameters('name')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('sku')]"
      },
      "properties": {
        "replicaCount": "[parameters('replicaCount')]",
        "partitionCount": "[parameters('partitionCount')]",
        "hostingMode": "[parameters('hostingMode')]"
      }
    }
  ]
}

De Azure-resource die in deze sjabloon is gedefinieerd:

De sjabloon implementeren

Selecteer de volgende afbeelding om u aan te melden bij Azure en een sjabloon te openen. Met de sjabloon maakt u een Azure AI Search-resource.

Button to deploy the Resource Manager template to Azure.

In de portal wordt een formulier weergegeven waarmee u eenvoudig parameterwaarden kunt opgeven. Sommige parameters worden vooraf ingevuld met de standaardwaarden uit de sjabloon. U moet uw abonnement, de resourcegroep, locatie en servicenaam opgeven. Als u Azure AI-services in een AI-verrijkingspijplijn wilt gebruiken, bijvoorbeeld om binaire afbeeldingsbestanden voor tekst te analyseren, kiest u een locatie die zowel Azure AI Search als Azure AI-services biedt. Beide services moeten zich in dezelfde regio bevinden voor AI-verrijkingsworkloads. Wanneer u het formulier hebt ingevuld, moet u akkoord gaan met de voorwaarden en vervolgens de knop Kopen selecteren om uw implementatie te voltooien.

Azure portal display of template

Geïmplementeerde resources bekijken

Wanneer de implementatie is voltooid, hebt u toegang tot uw nieuwe resourcegroep en nieuwe zoekservice in de portal.

Resources opschonen

Andere Azure AI Search-quickstarts en zelfstudies zijn gebaseerd op deze quickstart. Als u van plan bent om volgende quickstarts en zelfstudies te gaan gebruiken, wilt u deze resource misschien bewaren. Wanneer u deze niet meer nodig hebt, kunt u de resourcegroep verwijderen, waarmee de Azure AI-Search-service en gerelateerde resources worden verwijderd.

Volgende stappen

In deze quickstart hebt u een Azure AI-Search-service gemaakt met behulp van een ARM-sjabloon en de implementatie gevalideerd. Ga verder met de onderstaande artikelen voor meer informatie over Azure AI Search en Azure Resource Manager.