Skip to content

service-bus.mdx

Latest commit

 

History

History
280 lines (224 loc) · 7.15 KB

service-bus.mdx

File metadata and controls

280 lines (224 loc) · 7.15 KB
title Service Bus
description Get started with Azure Service Bus on LocalStack
template doc

import AzureFeatureCoverage from "../../../../components/feature-coverage/AzureFeatureCoverage";

Introduction

Azure Service Bus is a fully managed enterprise message broker that supports queues and publish/subscribe topics. It helps decouple distributed systems and build reliable asynchronous messaging workflows. Service Bus is commonly used for command processing, event distribution, and integration between independent services. For more information, see What is Azure Service Bus?

LocalStack for Azure provides a local environment for building and testing applications that make use of Azure Service Bus. The supported APIs are available on our API Coverage section, which provides information on the extent of Service Bus's integration with LocalStack.

Getting started

This guide is designed for users new to Service Bus and assumes basic knowledge of the Azure CLI and our azlocal wrapper script.

Start your LocalStack container using your preferred method. For more information, see Introduction to LocalStack for Azure.

:::note As an alternative to using the azlocal CLI, users can run:

azlocal start-interception

This command points the az CLI away from the public Azure management REST API and toward the LocalStack for Azure emulator API. To revert this configuration, run:

azlocal stop-interception

This reconfigures the az CLI to send commands to the official Azure management REST API. At this time, there is no full parity between azlocal and az commands after running az start-interception. Therefore, this technique is not fully interchangeable. :::

Create a resource group

Create a resource group to contain your Service Bus resources:

azlocal group create \
  --name rg-servicebus-demo \
  --location westeurope
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-servicebus-demo",
  "location": "westeurope",
  "managedBy": null,
  "name": "rg-servicebus-demo",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": "Microsoft.Resources/resourceGroups"
}

Create a Service Bus namespace

Create a Service Bus namespace in the resource group:

azlocal servicebus namespace create \
  --resource-group rg-servicebus-demo \
  --name sbnsdoc83 \
  --location westeurope \
  --sku Standard
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-servicebus-demo/providers/Microsoft.ServiceBus/namespaces/sbnsdoc83",
  "name": "sbnsdoc83",
  "location": "westeurope",
  "provisioningState": "Succeeded",
  "serviceBusEndpoint": "https://sbnsdoc83.localhost.localstack.cloud:4511",
  "sku": {
    "name": "Standard",
    "tier": "Standard"
  },
  ...
}

Get and list namespaces:

azlocal servicebus namespace show \
  --resource-group rg-servicebus-demo \
  --name sbnsdoc83

azlocal servicebus namespace list \
  --resource-group rg-servicebus-demo

Create and inspect a queue

Create a queue in the namespace:

azlocal servicebus queue create \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name orders-queue
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg-servicebus-demo/providers/Microsoft.ServiceBus/namespaces/sbnsdoc83/queues/orders-queue",
  "name": "orders-queue",
  "location": "westeurope",
  "status": "Active",
  "messageCount": 0,
  "maxSizeInMegabytes": 1024,
  ...
}

Get and list queues:

azlocal servicebus queue show \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name orders-queue

azlocal servicebus queue list \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83

Create topic and subscription

Create a topic and a subscription:

azlocal servicebus topic create \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name orders-topic

azlocal servicebus topic subscription create \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --topic-name orders-topic \
  --name orders-sub
{
  "name": "orders-topic",
  "status": "Active",
  "subscriptionCount": 0,
  ...
}
{
  "name": "orders-sub",
  "status": "Active",
  "messageCount": 0,
  ...
}

Get and list subscriptions:

azlocal servicebus topic subscription show \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --topic-name orders-topic \
  --name orders-sub

azlocal servicebus topic subscription list \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --topic-name orders-topic

Create and list subscription rules

Create a SQL filter rule for the subscription:

azlocal servicebus topic subscription rule create \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --topic-name orders-topic \
  --subscription-name orders-sub \
  --name high-priority \
  --filter-sql-expression "priority = 'high'"
{
  "name": "high-priority",
  "filterType": "SqlFilter",
  "sqlFilter": {
    "sqlExpression": "priority = 'high'",
    ...
  },
  ...
}

List rules for the subscription:

azlocal servicebus topic subscription rule list \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --topic-name orders-topic \
  --subscription-name orders-sub

Create and manage namespace authorization rules

Create an authorization rule:

azlocal servicebus namespace authorization-rule create \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name app-policy \
  --rights Listen Send
{
  "name": "app-policy",
  "rights": [
    "Listen",
    "Send"
  ],
  ...
}

List authorization rules:

azlocal servicebus namespace authorization-rule list \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83

List and regenerate keys:

azlocal servicebus namespace authorization-rule keys list \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name app-policy

azlocal servicebus namespace authorization-rule keys renew \
  --resource-group rg-servicebus-demo \
  --namespace-name sbnsdoc83 \
  --name app-policy \
  --key PrimaryKey
{
  "keyName": "app-policy",
  "primaryConnectionString": "Endpoint=https://sbnsdoc83.localhost.localstack.cloud:4511/;SharedAccessKeyName=app-policy;SharedAccessKey=...;UseDevelopmentEmulator=true",
  "secondaryConnectionString": "Endpoint=https://sbnsdoc83.localhost.localstack.cloud:4511/;SharedAccessKeyName=app-policy;SharedAccessKey=...;UseDevelopmentEmulator=true",
  ...
}
{
  "keyName": "app-policy",
  "primaryConnectionString": "Endpoint=https://sbnsdoc83.localhost.localstack.cloud:4511/;SharedAccessKeyName=app-policy;SharedAccessKey=...;UseDevelopmentEmulator=true",
  ...
}

API Coverage