Delen via

Quickstart: Een Service Bus-naamruimte en een wachtrij maken met behulp van een Bicep-bestand

  • Artikel

In dit artikel wordt beschreven hoe u een Bicep-bestand gebruikt waarmee een Service Bus-naamruimte en een wachtrij in die naamruimte wordt gemaakt. In het artikel wordt uitgelegd hoe u kunt opgeven welke resources worden geïmplementeerd en hoe u de parameters definieert die bij de uitvoering van de implementatie zijn opgegeven. U kunt dit Bicep-bestand gebruiken voor uw eigen implementaties of het aanpassen aan uw vereisten.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Vereisten

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

Het Bicep-bestand controleren

Het Bicep-bestand dat in deze quickstart wordt gebruikt, is afkomstig van Azure-quickstartsjablonen.

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

De resources die zijn gedefinieerd in het Bicep-bestand zijn onder andere:

Notitie

De volgende ARM-sjablonen zijn beschikbaar om te downloaden en te implementeren.

Meer Bicep/ARM-sjablonen vindt u in Azure Quickstart-sjablonen

Het Bicep-bestand implementeren

Met dit Bicep-bestand implementeert u een Service Bus-naamruimte met een wachtrij.

Service Bus-wachtrijen bieden het FIFO-principe (first in, first out) voor de berichtbezorging naar een of meer concurrerende gebruikers.

  1. Sla het Bicep-bestand op als main.bicep op uw lokale computer.

  2. Implementeer het Bicep-bestand met behulp van Azure CLI of Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep

    U wordt gevraagd om de volgende parameterwaarden in te voeren:

    • serviceBusNamespaceName: naam van de Service Bus-naamruimte.
    • serviceBusQueueName: naam van de wachtrij.

    Wanneer de implementatie is voltooid, ziet u een bericht waarin wordt aangegeven dat de implementatie is voltooid.

De implementatie valideren

Gebruik Azure Portal, Azure CLI of Azure PowerShell om de geïmplementeerde resources in de resourcegroep weer te geven.

az resource list --resource-group exampleRG

Resources opschonen

Wanneer u deze niet meer nodig hebt, gebruikt u Azure Portal, Azure CLI of Azure PowerShell om de VIRTUELE machine en alle resources in de resourcegroep te verwijderen.

az group delete --name exampleRG

Volgende stappen

Zie het volgende onderwerp waarin wordt uitgelegd hoe u een autorisatieregel maakt voor de naamruimte/wachtrij:

Een Service Bus-autorisatieregel voor naamruimte en wachtrij maken met behulp van een ARM-sjabloon

Meer informatie over het beheren van deze resources vindt u in de volgende artikelen: