devopsifyme/sbemu repository overview

Emulator is really an AMQP 1.0 proxy that translates Azure Service Bus specifics into backend implementation specifics. Backend is an actual queue implementation that runs locally, not in cloud, and handles the messages. The main use case is to help with local development experience and with integration testing where application code cannot change driver easily.

See https://devopsifyme.com⁠ and https://github.com/piotr-rojek/devopsifyme-sbemulator⁠ for more information.

⁠Run

Your Azure Service Bus Connection String

# Bring containers up
curl https://raw.githubusercontent.com/piotr-rojek/devopsifyme-sbemulator/main/docker-compose.yml --output docker-compose.yml
docker compose up --detach --no-build 

# Trust our test certificate
$containerPrefix = Split-Path (Get-Location) -Leaf
docker cp $containerPrefix-emulator-1:/app/cacert.cer cacert.cer
Import-Certificate -FilePath cacert.cer -CertStoreLocation cert:\CurrentUser\Root

⁠Configuration

⁠Emulator.QueuesAndTopics

You can use this to preinitialize queues and topics, if your tests require this. Otherwise some messages sent might be lost, if the receiver connects after they are sent. For example, integration tests in this repo rely on this setting (see docker-compose.integration.yml).

Sample value

queue-name;topic-name/Subscriptions/sub1;topic-name/Subscriptions/sub2

⁠Bring your own certificate

If you don't want to trust provided test CA, you can provide your own server certificate. Mount your PFX file in any directory, and update environmental variables Emulator__ServerCertificatePath and Emulator__ServerCertificatePassword.