This is an Amazon SQS transport for NServiceBus.

Feel free to browse and contribute!

For more information, including a guide on getting started quickly, see the project documentation at docs.particular.net.

The solution contains the NServiceBus Acceptance Test suite and the NServiceBus Transport Test suite. To run the tests, the Access Key ID and Secret Access Key of an AWS IAM account need to be set in environment variables on the machine running the tests. Full details on how to set this up can be found here.

The transport can be configured using the following environment variables:

• NServiceBus_AmazonSQS_S3Bucket corresponds to the S3BucketForLargeMessages parameter. Default is no S3 bucket.

The bucket should not have encryption enabled. An additional bucket {NServiceBus_AmazonSQS_S3Bucket}.kms with AWS KMS encryption enabled is required.

Additional environment variables required for AWS:

• AWS_ACCESS_KEY_ID access key ID to sign programmatic requests that you make to AWS. Provisioned via IAM.
• AWS_SECRET_ACCESS_KEY secret access key to sign programmatic requests that you make to AWS. Provisioned via IAM.
• AWS_REGION Valid AWS region.

The names of queues used by the acceptance tests take the following form:

AT<datetime>-<pre-truncated-queue-name>

Where

• AT stands for "Acceptance Test"
• datetime is a date and time as yyyyMMddHHmmss that uniquely identifies a single test run. For example, when 100 tests are executed in a single test run each queue will have the same datetime timestamp.
• pre-truncated-queue-name is the name of the queue, "pre-truncated" (characters are removed from the beginning) so that the entire queue name is 80 characters or less.

This scheme accomplishes the following goals:

• Test runs are idempotent - each test run uses its own set of queues
• Queues for a given test run are easily searchable by prefix in the SQS portal
• The discriminator and qualifier at the end of the queue name are not interfered with
• Queue names fit the 80 character limit imposed by SQS