Démarrage rapide : Créer un espace de noms Service Bus et une file d’attente avec un fichier Bicep

  • Article

Cet article montre comment utiliser un fichier Bicep qui crée un espace de noms Service Bus et une file d’attente au sein de cet espace de noms. L’article explique comment spécifier les ressources à déployer et définir les paramètres qui sont spécifiés durant l’exécution du déploiement. Vous pouvez utiliser le fichier Bicep pour vos propres déploiements, ou le personnaliser afin qu’il réponde à vos besoins

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.

Prérequis

Si vous ne disposez 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('Name of the Service Bus namespace')
param serviceBusNamespaceName string

@description('Name of the Queue')
param serviceBusQueueName string

@description('Location for all resources.')
param location string = resourceGroup().location

resource serviceBusNamespace 'Microsoft.ServiceBus/namespaces@2022-01-01-preview' = {
  name: serviceBusNamespaceName
  location: location
  sku: {
    name: 'Standard'
  }
  properties: {}
}

resource serviceBusQueue 'Microsoft.ServiceBus/namespaces/queues@2022-01-01-preview' = {
  parent: serviceBusNamespace
  name: serviceBusQueueName
  properties: {
    lockDuration: 'PT5M'
    maxSizeInMegabytes: 1024
    requiresDuplicateDetection: false
    requiresSession: false
    defaultMessageTimeToLive: 'P10675199DT2H48M5.4775807S'
    deadLetteringOnMessageExpiration: false
    duplicateDetectionHistoryTimeWindow: 'PT10M'
    maxDeliveryCount: 10
    autoDeleteOnIdle: 'P10675199DT2H48M5.4775807S'
    enablePartitioning: false
    enableExpress: false
  }
}

Les ressources définies dans le fichier Bicep comprennent :

Notes

Les modèles ARM suivants sont disponibles pour le téléchargement et le déploiement.

Vous trouverez plus de modèles Bicep/ARM dans Modèles de démarrage rapide Azure

Déployer le fichier Bicep

Avec ce fichier Bicep, vous déployez un espace de noms Service Bus avec file d’attente.

Les files d’attente Service Bus permettent de remettre des messages selon le principe du premier entré, premier sorti (FIFO) à un ou plusieurs destinataires concurrents.

  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

    Vous êtes invité à entrer les valeurs de paramètre suivantes :

    • serviceBusNamespaceName : nom de l’espace de noms Service Bus.
    • serviceBusQueueName : nom de la file d’attente.

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

Valider le déploiement

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

Quand vous n’avez plus besoin du groupe de ressources et de la ressource de serveur, utilisez le portail Azure, Azure CLI ou Azure PowerShell pour les supprimer avec la machine virtuelle.

az group delete --name exampleRG

Étapes suivantes

Consultez la rubrique suivante, qui montre comment créer une règle d’autorisation pour l’espace de noms/la file d’attente :

Créer une règle d’autorisation Service Bus pour l’espace de noms et la file d’attente à l’aide d’un modèle ARM

Découvrez comment gérer ces ressources en consultant les articles suivants :