Partager via

Démarrage rapide : déployer Recherche Azure AI à l’aide de Bicep

  • Article

Cet article vous guide tout au long du processus d’utilisation d’un fichier Bicep pour déployer une ressource Recherche Azure AI dans le portail Microsoft Azure.

Bicep est un langage spécifique à un domaine (DSL) qui utilise la syntaxe déclarative pour déployer des ressources Azure. Il fournit une syntaxe concise, une cohérence des types fiable et une prise en charge de la réutilisation du code. Bicep offre la meilleure expérience de création pour vos solutions d’infrastructure en tant que code dans Azure.

Seules les propriétés incluses dans le modèle sont utilisées dans le déploiement. Si d’autres personnalisations sont requises, telles que la configuration de la sécurité réseau, vous pouvez mettre à jour le service en tant que tâche post-déploiement. Pour personnaliser un service existant en quelques étapes, utilisez Azure CLI ou Azure PowerShell. Si vous évaluez des fonctionnalités en préversion, utilisez l’API REST de gestion.

Conseil

Pour obtenir un autre modèle Bicep qui déploie Recherche Azure AI avec un indexeur préconfiguré sur Cosmos DB for NoSQL, consultez Déploiement Bicep de Recherche Azure AI. Il n’existe aucune prise en charge des modèles bicep pour les opérations de plan de données Recherche Azure AI, comme la création d’un index, mais vous pouvez ajouter un module qui appelle des API REST. L’exemple inclut un module qui crée un index, un connecteur de source de données et un indexeur qui s’actualise à partir de Cosmos DB à intervalles de 5 minutes.

Prérequis

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Examiner le fichier Bicep

Le fichier Bicep utilisé dans ce guide de démarrage rapide est tiré des modèles de démarrage rapide Azure.

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

La ressource Azure définie dans ce fichier Bicep :

Déployer le fichier Bicep

  1. Enregistrez le fichier Bicep en tant que main.bicep sur votre ordinateur local.

  2. Déployez le fichier Bicep à l’aide d’Azure CLI ou d’Azure PowerShell.

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

    Notes

    Remplacez <service-name > par le nom du service de recherche. Le nom du service doit contenir uniquement des lettres minuscules, des chiffres ou des tirets. Vous ne pouvez pas utiliser un tiret pour les deux premiers caractères ni le dernier caractère. Le nom doit comprendre entre 2 et 60 caractères.

    Une fois le déploiement terminé, un message doit s’afficher pour indiquer que le déploiement a réussi.

Vérifier les ressources déployées

Utilisez le portail Azure, Azure CLI ou Azure PowerShell pour répertorier les ressources déployées dans le groupe de ressources.

az resource list --resource-group exampleRG

Nettoyer les ressources

Azure AI Search est une ressource facturable. Si elle n’est plus nécessaire, supprimez-la de votre abonnement pour éviter des frais. Vous pouvez utiliser le portail Azure, Azure CLI ou Azure PowerShell pour supprimer le groupe de ressources et ses ressources.

az group delete --name exampleRG

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez créé un service Recherche Azure AI en utilisant un fichier Bicep, puis vous avez validé le déploiement. Pour en savoir plus sur Recherche Azure AI et Azure Resource Manager, passez aux articles.