Snabb start: Distribuera Kognitiv sökning med en ARM-mallQuickstart: Deploy Cognitive Search using an ARM template

Den här artikeln vägleder dig genom processen för att använda en Azure Resource Manager-mall (ARM-mall) för att distribuera en Azure Kognitiv sökning-resurs i Azure Portal.This article walks you through the process for using an Azure Resource Manager template (ARM template) to deploy an Azure Cognitive Search resource in the Azure portal.

En ARM-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för ditt projekt.An ARM template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. Mallen använder deklarativ syntax.The template uses declarative syntax. I deklarativ syntax beskriver du din avsedda distribution utan att skriva sekvensen med programmeringskommandon för att skapa den.In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure.If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. Mallen öppnas på Azure-portalen.The template will open in the Azure portal.

Distribuera till AzureDeploy to Azure

KravPrerequisites

Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

Granska mallenReview the template

Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.The template used in this quickstart is from Azure Quickstart Templates.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "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",
      "allowedValues": [
        "free",
        "basic",
        "standard",
        "standard2",
        "standard3",
        "storage_optimized_l1",
        "storage_optimized_l2"
      ],
      "metadata": {
        "description": "The pricing tier of the search service you want to create (for example, basic or standard)."
      }
    },
    "replicaCount": {
      "type": "int",
      "defaultValue": 1,
      "minValue": 1,
      "maxValue": 12,
      "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-03-13",
      "name": "[parameters('name')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[toLower(parameters('sku'))]"
      },
      "properties": {
        "replicaCount": "[parameters('replicaCount')]",
        "partitionCount": "[parameters('partitionCount')]",
        "hostingMode": "[parameters('hostingMode')]"
      }
    }
  ]
}

Den Azure-resurs som definierats i den här mallen:The Azure resource defined in this template:

Distribuera mallenDeploy the template

Välj följande bild för att logga in på Azure och öppna en mall.Select the following image to sign in to Azure and open a template. Mallen skapar en Azure Kognitiv sökning-resurs.The template creates an Azure Cognitive Search resource.

Distribuera till AzureDeploy to Azure

Portalen visar ett formulär som gör att du enkelt kan ange parameter värden.The portal displays a form that allows you to easily provide parameter values. Vissa parametrar fylls i automatiskt med standardvärdena från mallen.Some parameters are pre-filled with the default values from the template. Du måste ange din prenumeration, resurs grupp, plats och tjänst namn.You will need to provide your subscription, resource group, location, and service name. Om du vill använda Cognitive Services i en pipeline för AI-anrikning , till exempel för att analysera binära bildfiler för text, väljer du en plats som erbjuder både Kognitiv sökning och Cognitive Services.If you want to use Cognitive Services in an AI enrichment pipeline, for example to analyze binary image files for text, choose a location that offers both Cognitive Search and Cognitive Services. Båda tjänsterna måste finnas i samma region för AI-arbetsbelastningar.Both services are required to be in the same region for AI enrichment workloads. När du har fyllt i formuläret måste du godkänna de allmänna villkoren och sedan välja knappen köp för att slutföra distributionen.Once you have completed the form, you will need to agree to the terms and conditions and then select the purchase button to complete your deployment.

Azure Portal visning av mallAzure portal display of template

Granska distribuerade resurserReview deployed resources

När distributionen är klar kan du komma åt den nya resurs gruppen och den nya Sök tjänsten i portalen.When your deployment is complete you can access your new resource group and new search service in the portal.

Rensa resurserClean up resources

Andra Kognitiv sökning snabb starter och självstudier som bygger på den här snabb starten.Other Cognitive Search quickstarts and tutorials build upon this quickstart. Om du planerar att fortsätta att arbeta med efterföljande snabb starter och självstudier, kanske du vill lämna den här resursen på plats.If you plan to continue on to work with subsequent quickstarts and tutorials, you may wish to leave this resource in place. När de inte längre behövs kan du ta bort resurs gruppen, som tar bort Kognitiv sökning tjänsten och relaterade resurser.When no longer needed, you can delete the resource group, which deletes the Cognitive Search service and related resources.

Nästa stegNext steps

I den här snabb starten skapade du en Kognitiv sökning tjänst med en ARM-mall och validerade distributionen.In this quickstart, you created a Cognitive Search service using an ARM template, and validated the deployment. Om du vill veta mer om Kognitiv sökning och Azure Resource Manager fortsätter du till artiklarna nedan.To learn more about Cognitive Search and Azure Resource Manager, continue on to the articles below.