Draft upgrade guide

menu/menu.yaml

@@ -207,6 +207,10 @@
         Title: Version 7 to 8
       - Url: nservicebus/upgrades/acs-host-6to7
         Title: Version 6 to 7
+    - Title: Azure Functions with Service Bus
+      Articles:
+      - Url: nservicebus/upgrades/azure-functions-service-bus-1to2
+        Title: Version 1 to 2
     - Title: Gateway
       Articles:
       - Url: nservicebus/upgrades/gateway-1to2

nservicebus/upgrades/azure-functions-service-bus-1to2.md

@@ -0,0 +1,132 @@
+---
+title: Azure Functions with Azure Service Bus Upgrade Version 1 to 2
+summary: Instructions on how to upgrade Azure Functions with Azure Service Bus from version 1 to 2
+component: ASBFunctions
+reviewed: 2021-08-30
+related:
+ - nservicebus/upgrades/7to8
+isUpgradeGuide: true
+upgradeGuideCoreVersions:
+ - 7
+ - 8
+---
+
+## Registering NServiceBus
+
+All public constructors of `ServiceBusTriggeredEndpointConfiguration` have been made internal.
+
+Instead of
+
+```csharp
+functionsHostBuilder.UseNServiceBus(() => new ServiceBusTriggeredEndpointConfiguration(endpointName));
+```
+
+Use:
+
+```csharp
+functionsHostBuilder.UseNServiceBus(endpointName);
+```
+
+Endpoint name can be inferred from `NServiceBusTriggerFunctionAttribute` if present.
+
+```csharp
+[assembly: NServiceBusTriggerFunction("MyEndpoint")]
+
+// ...
+
+functionsHostBuilder.UseNServiceBus(); // Will use the name MyEndpoint
+```
+
+NOTE: The constructed instance of `NServiceBusTriggeredEndpointConfiguration` already contains a reference to the `IConfiguration` from the host environment. It is not required to pass one in.
+
+### Connection strings
+
+Specifying a connection string by name has been deprecated. 
+
+Instead of 
+
+```csharp
+functionsHostBuilder.UseNServiceBus(
+    () => new ServiceBusTriggeredEndpointConfiguration(endpointName, connectionStringName)
+);
+```
+
+Use:
+
+```csharp
+functionsHostBuilder.UseNServiceBus(endpointName, nsb => 
+{
+    var connectionString = Environment.GetEnvironmentVariable(connectionStringName);
+    nsb.ServiceBusConnectionString(connectionString);
+});
+```
+
+### Routing
+
+Instead of 
+
+```csharp
+functionsHostBuilder.UseNServiceBus(() => 
+{
+    var serviceBusTriggeredEndpointConfiguration = new ServiceBusTriggeredEndpointConfiguration(endpointName);
+    var routing = serviceBusTriggeredEndpointConfiguration.Transport.Routing();
+    routing.RouteToEndpoint(typeof(SomeMessage), "AnotherEndpoint");
+
+    return serviceBusTriiggeredEndpointConfiguration;
+});
+```
+
+Use:
+
+```csharp
+functionsHostBuilder.UseNServiceBus(endpointName, nsb => 
+{
+    nsb.Routing(routing => routing.RouteToEndpoint(typeof(SomeMessage), "AnotherEndpoint"));
+});
+```
+
+### Transport configuration
+
+Instead of
+
+```csharp
+functionsHostBuilder.UseNServiceBus(() =>
+{
+    var serviceBusTriggeredEndpointConfiguration = new ServiceBusTriggeredEndpointConfiguration(endpointName);
+    var transport = serviceBusTriggeredEndpointConfiguration.Transport;
+    transport.TopicName("nsb-subs");
+    return serviceBusTriggeredEndpointConfiguration;
+});
+```
+
+Use:
+
+```csharp
+functionsHostBuilder.UseNServiceBus(endpointName, nsb => 
+{
+    nsb.ConfigureTransport(transport => transport.TopicName("nsb-subs"));
+});
+```
+
+### Advanced configuration
+
+Instead of
+
+```csharp
+functionsHostBuilder.UseNServiceBus(() =>
+{
+    var serviceBusTriggeredEndpointConfiguration = new ServiceBusTriggeredEndpointConfiguration(endpointName);
+    var endpointConfiguration = serviceBusTriggeredEndpointConfiguration.AdvancedConfiguration;
+    endpointConfiguration.SendFailedMessagesTo("custom-error-queue");
+    return serviceBusTriggeredEndpointConfiguration;
+});
+```
+
+Use:
+
+```csharp
+functionsHostBuilder.UseNServiceBus(endpointName, nsb => 
+{
+    nsb.Advanced(endpointConfiguration => endpointConfiguration.SendFailedMessagesTo("custom-error-queue"));
+});
+```