Schnellstart: Erstellen eines Service Bus-Namespace und einer Warteschlange mit einer Bicep-Datei

  • Artikel

In diesem Artikel wird gezeigt, wie Sie eine Bicep-Datei verwenden, die einen Service Bus-Namespace und eine Warteschlange innerhalb dieses Namespace erstellt. Dieser Artikel zeigt Ihnen, wie Sie angeben, welche Ressourcen bereitgestellt werden und wie Sie Parameter definieren, die angegeben werden, wenn die Bereitstellung ausgeführt wird. Sie können diese Bicep-Datei für Ihre eigenen Bereitstellungen verwenden oder Ihren Anforderungen anpassen.

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Voraussetzungen

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Überprüfen der Bicep-Datei

Die in dieser Schnellstartanleitung verwendete Bicep-Datei stammt aus den Azure-Schnellstartvorlagen.

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

In der Bicep-Datei sind folgende Ressourcen definiert:

Hinweis

Die folgenden ARM-Vorlagen stehen zum Herunterladen und Bereitstellen zur Verfügung.

Weitere Bicep-/ARM-Vorlagen finden Sie unter Azure-Schnellstartvorlagen.

Bereitstellen der Bicep-Datei

Mit dieser Bicep-Datei stellen Sie einen Service Bus-Namespace mit einer Warteschlange bereit.

Service Bus-Warteschlangen bieten eine FIFO-Nachrichtenzustellung (First In, First Out) an einen Consumer oder an mehrere konkurrierende Consumer.

  1. Speichern Sie die Bicep-Datei als main.bicep auf Ihrem lokalen Computer.

  2. Stellen Sie die Bicep-Datei entweder mit Azure CLI oder mit Azure PowerShell bereit.

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

    Sie werden aufgefordert, die folgenden Parameterwerte einzugeben:

    • serviceBusNamespaceName: Der Name des Service Bus-Namespace.
    • serviceBusQueueName: Der Name der Warteschlange.

    Nach Abschluss der Bereitstellung sollte eine Meldung mit dem Hinweis angezeigt werden, dass die Bereitstellung erfolgreich war.

Überprüfen der Bereitstellung

Verwenden Sie das Azure-Portal, die Azure CLI oder Azure PowerShell, um die bereitgestellten Ressourcen in der Ressourcengruppe aufzulisten.

az resource list --resource-group exampleRG

Bereinigen von Ressourcen

Wenn Sie den virtuellen Computer und die Ressourcen nicht mehr benötigen, verwenden Sie das Azure-Portal, die Azure CLI oder Azure PowerShell, um den virtuellen Computer und alle Ressourcen in der Ressourcengruppe zu löschen.

az group delete --name exampleRG

Nächste Schritte

Lesen Sie das folgende Thema zum Erstellen einer Autorisierungsregel für den Namespace bzw. die Warteschlange:

Erstellen einer Service Bus-Autorisierungsregel für Namespace und Warteschlange mithilfe einer ARM-Vorlage

In den folgenden Artikeln erfahren Sie, wie Sie diese Ressourcen verwalten: