Inicio rápido: Implementación de Cognitive Search con una plantilla de ARMQuickstart: Deploy Cognitive Search using an ARM template

Este artículo le guiará por el proceso de uso de una plantilla de Azure Resource Manager (plantilla de ARM) para implementar un recurso de Azure Cognitive Search en 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.

Una plantilla de Resource Manager es un archivo de notación de objetos JavaScript (JSON) que define la infraestructura y la configuración del proyecto.An ARM template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. La plantilla usa sintaxis declarativa.The template uses declarative syntax. En la sintaxis declarativa, se describe la implementación deseada sin escribir la secuencia de comandos de programación para crearla.In declarative syntax, you describe your intended deployment without writing the sequence of programming commands to create the deployment.

Si su entorno cumple los requisitos previos y está familiarizado con el uso de plantillas de Resource Manager, seleccione el botón Implementar en Azure.If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. La plantilla se abrirá en Azure Portal.The template will open in the Azure portal.

Implementación en AzureDeploy to Azure

PrerrequisitosPrerequisites

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Revisión de la plantillaReview the template

La plantilla usada en este inicio rápido forma parte de las plantillas de inicio rápido de Azure.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')]"
      }
    }
  ]
}

El recurso de Azure definido en esta plantilla:The Azure resource defined in this template:

Implementación de la plantillaDeploy the template

Seleccione la imagen siguiente para iniciar sesión en Azure y abrir una plantilla.Select the following image to sign in to Azure and open a template. La plantilla crea un recurso de Azure Cognitive Search.The template creates an Azure Cognitive Search resource.

Implementación en AzureDeploy to Azure

El portal muestra un formulario que le permite proporcionar fácilmente los valores de parámetros.The portal displays a form that allows you to easily provide parameter values. Algunos parámetros se rellenan previamente con los valores predeterminados de la plantilla.Some parameters are pre-filled with the default values from the template. Tendrá que proporcionar la suscripción, el grupo de recursos, la ubicación y el nombre del servicio.You will need to provide your subscription, resource group, location, and service name. Si desea usar Cognitive Services en una canalización de enriquecimiento con IA, por ejemplo, para analizar archivos de imagen binarios para el texto, elija una ubicación que ofrezca Cognitive Search y 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. Ambos servicios deben estar en la misma región para cargas de trabajo de enriquecimiento con inteligencia artificial.Both services are required to be in the same region for AI enrichment workloads. Una vez que haya completado el formulario, deberá aceptar los términos y condiciones y, a continuación, seleccionar el botón de compra para completar la implementación.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.

Visualización de la plantilla de Azure PortalAzure portal display of template

Revisión de los recursos implementadosReview deployed resources

Una vez completada la implementación, puede tener acceso al nuevo grupo de recursos y al nuevo servicio de búsqueda en el portal.When your deployment is complete you can access your new resource group and new search service in the portal.

Limpieza de recursosClean up resources

Otros artículos de inicio rápido y tutoriales de Cognitive Search se basan este.Other Cognitive Search quickstarts and tutorials build upon this quickstart. Si tiene pensado seguir trabajando en otros artículos de inicio rápido y tutoriales, considere la posibilidad de dejar este recurso activo.If you plan to continue on to work with subsequent quickstarts and tutorials, you may wish to leave this resource in place. Cuando ya no lo necesite, elimine el grupo de recursos; de este modo, se eliminarán también el servicio Cognitive Search y los recursos relacionados.When no longer needed, you can delete the resource group, which deletes the Cognitive Search service and related resources.

Pasos siguientesNext steps

En este inicio rápido, ha creado un servicio Cognitive Search mediante una plantilla de ARM y ha validado la implementación.In this quickstart, you created a Cognitive Search service using an ARM template, and validated the deployment. Para más información sobre Cognitive Search y Azure Resource Manager, continúe con los artículos siguientes.To learn more about Cognitive Search and Azure Resource Manager, continue on to the articles below.