Skip to content

Commit a8c5deb

Browse files
authored
Removed obsolete partials and images
1 parent 45924aa commit a8c5deb

9 files changed

+41
-80
lines changed
-20.9 KB
Binary file not shown.
-55.6 KB
Binary file not shown.

transports/azure-storage-queues/multi-storageaccount-support.md

Lines changed: 41 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,49 @@ For additional guidance on considerations when developing a system using Azure S
3333

3434
The preferred way to route when using multiple accounts is to register endpoints with their associated storage accounts.
3535

36-
partial: registered-endpoint
36+
### Aliases instead of connection strings
3737

38-
NServiceBus also allows specifying destination addresses using the `<endpoint>@<physicallocation>` notation when messages are dispatched. In this notation, the `physicallocation` element represents the location where the endpoint's infrastructure is hosted, such as a storage account.
38+
To avoid connection strings leaking, aliases are always used, using an empty string as the default.
39+
Therefore, when multiple accounts are used, an alias has to be registered for each storage account.
40+
41+
To enable sending from `account_A` to `account_B`, the following configuration needs to be applied in the `account_A` endpoint:
42+
43+
snippet: AzureStorageQueueUseMultipleAccountAliasesInsteadOfConnectionStrings1
44+
45+
Aliases can be provided for both the endpoint's connection strings as well as other accounts' connection strings. This enables using the `@` notation for destination addresses like `queue_name@accountAlias`.
46+
47+
snippet: storage_account_routing_send_options_alias
48+
49+
> [!NOTE]
50+
> The examples above use different values for the default account aliases. Using the same name, such as `default`, to represent different storage accounts in different endpoints is highly discouraged as it introduces ambiguity in resolving addresses like `queue@default` and may cause issues when e.g. replying. In that case an address is interpreted as a reply address, the name `default` will point to a different connection string.
51+
52+
> [!NOTE]
53+
> This feature is currently NOT compatible with ServiceControl. A [ServiceControl transport adapter](/servicecontrol/transport-adapter.md) is required in order to leverage both.
54+
55+
### Using registered endpoints
56+
57+
In order to route message to endpoints without having to specify the destination at all times, it is also possible to register the endpoint for a given command type, assembly or namespace
58+
59+
snippet: storage_account_routing_registered_endpoint
60+
61+
Once the endpoint is registered no send options need to be specified.
62+
63+
snippet: storage_account_routing_send_registered_endpoint
64+
65+
#### Publishers
66+
67+
Similar to sending to an endpoint, the transport can also be configured to subscribe to events published by endpoints in another storage account, using:
68+
69+
snippet: storage_account_routing_registered_publisher
70+
71+
### Using send options
72+
73+
NServiceBus also allows specifying destination addresses using the `<endpoint>@<physicallocation>` notation when messages are dispatched. In this notation, the `physicallocation` element represents the location where the endpoint's infrastructure is hosted, such as a storage account alias.
3974

4075
Using this notation, it is possible to route messages to any endpoint hosted in any storage account.
4176

42-
partial: routing-send-options-full-connectionstring
77+
The use of send options enables routing messages to any endpoint hosted in another storage account by specifying the storage account using the `@` notation.
78+
The `@` notation is used to point to a connection string represented by a specified alias.
79+
80+
snippet: storage_account_routing_send_options_alias
4381

44-
partial: aliases

transports/azure-storage-queues/multi-storageaccount-support_aliases_asq_[7,8].partial.md

Lines changed: 0 additions & 17 deletions
This file was deleted.

transports/azure-storage-queues/multi-storageaccount-support_aliases_asqn_[9,).partial.md

Lines changed: 0 additions & 18 deletions
This file was deleted.

transports/azure-storage-queues/multi-storageaccount-support_registered-endpoint_asq_[8,).partial.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

transports/azure-storage-queues/multi-storageaccount-support_registered-endpoint_asqn_[9,).partial.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

transports/azure-storage-queues/multi-storageaccount-support_routing-send-options-full-connectionstring_asq_[7,8].partial.md

Lines changed: 0 additions & 5 deletions
This file was deleted.

transports/azure-storage-queues/multi-storageaccount-support_routing-send-options-full-connectionstring_asqn_[9,).partial.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

0 commit comments

Comments
 (0)