Update NServiceBus Step By Step tutorial to use Microsoft.Extensions.Logging (#6861)

* Update NServiceBus Step By Step tutorial to use Microsoft Extensions Logging

* Update step by step tutorial, step 1 client ui project

* Update the step-by-step tutorials

* Update ClientUI.csproj

* NSB step-by-step tutorial clean up

* Updates to Snippet and tutorial for Lesson 1

* updates to lesson 1 snippets

* changes to lesson 2 snippets

* Lesson 3 snippets update

* Updated snippets for lesson 4

* Added missing snippet

* Delete unused snippet

* Minor updates to step 1 & 2

* fixed issue with csproj

* Updates to version on step 3

* Update to the step 2 tutorial

* Updates to steps 4 & 5

* step 1 tweaks

* step 2

* step 3

* step 4

* step 5

* Update tutorial.md

* Update tutorial.md

* Update tutorial.md

* Update tutorial.md

---------

Co-authored-by: Tomek Masternak <[email protected]>

Author: poornimanayar

tutorials/nservicebus-step-by-step/1-getting-started/Snippets/Core_8/Core_8.csproj

@@ -0,0 +1,10 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <LangVersion>12.0</LangVersion>
+  </PropertyGroup>
+  <ItemGroup>
+    <PackageReference Include="NServiceBus" Version="9.*" />
+    <PackageReference Include="NServiceBus.Extensions.Hosting" Version="3.*" />
+  </ItemGroup>
+</Project>

tutorials/nservicebus-step-by-step/1-getting-started/Snippets/Core_8/Lesson1.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Hosting;
+using NServiceBus;
+
+namespace Core_9;
+#pragma warning disable 1998
+
+#region EmptyProgram
+class Program
+{
+    static async Task Main(string[] args)
+    {
+
+    }
+}
+#endregion
+
+class StepByStep
+{
+    #region Main
+
+    static async Task Main(string[] args)
+    {
+        var builder = Host.CreateApplicationBuilder(args);
+
+        var endpointConfiguration = new EndpointConfiguration("ClientUI");
+
+        endpointConfiguration.UseSerialization<SystemJsonSerializer>();
+
+        var routing = endpointConfiguration.UseTransport(new LearningTransport());
+
+    }
+    #endregion
+
+    static async Task Steps(string[] args)
+    {
+        #region ConsoleTitle
+        Console.Title = "ClientUI";
+        #endregion
+
+        #region Setup
+        var builder = Host.CreateApplicationBuilder(args);
+        #endregion
+
+        #region EndpointName
+        var endpointConfiguration = new EndpointConfiguration("ClientUI");
+
+        // Choose JSON to serialize and deserialize messages
+        endpointConfiguration.UseSerialization<SystemJsonSerializer>();
+        #endregion
+
+        #region LearningTransport
+        var transport = endpointConfiguration.UseTransport<LearningTransport>();
+        #endregion
+
+        #region Startup
+        builder.UseNServiceBus(endpointConfiguration);
+
+        await builder.Build().RunAsync();
+        #endregion
+    }
+}
+
+#pragma warning restore 1998

tutorials/nservicebus-step-by-step/1-getting-started/Snippets/Core_9/Core_9.csproj

@@ -1,9 +1,8 @@
-
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.29728.190
+# Visual Studio Version 17
+VisualStudioVersion = 17.11.35303.130
 MinimumVisualStudioVersion = 15.0.26730.12
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Core_8", "Core_8\Core_8.csproj", "{10CE989A-8E4F-400C-8BBD-3935B9FEE695}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Core_9", "Core_9\Core_9.csproj", "{10CE989A-8E4F-400C-8BBD-3935B9FEE695}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

tutorials/nservicebus-step-by-step/1-getting-started/Snippets/Core_9/Lesson1.cs

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
     <OutputType>Exe</OutputType>
     <LangVersion>12.0</LangVersion>
   </PropertyGroup>
   <ItemGroup>
     <PackageReference Include="NServiceBus" Version="9.*" />
+    <PackageReference Include="NServiceBus.Extensions.Hosting" Version="3.*" />
   </ItemGroup>
 </Project>

tutorials/nservicebus-step-by-step/1-getting-started/Snippets/Snippets.sln

@@ -1,28 +1,26 @@
-using NServiceBus;
-using System;
+using Microsoft.Extensions.DependencyInjection;
 using System.Threading.Tasks;
+using Microsoft.Extensions.Hosting;
+using NServiceBus;
+using System;
 
-namespace ClientUI
+namespace ClientUI;
+class Program
 {
-    class Program
+    static async Task Main(string[] args)
     {
-        static async Task Main()
-        {
-            Console.Title = "ClientUI";
+        Console.Title = "ClientUI";
 
-            var endpointConfiguration = new EndpointConfiguration("ClientUI");
+        var builder = Host.CreateApplicationBuilder(args);
 
-            var transport = endpointConfiguration.UseTransport<LearningTransport>();
+        var endpointConfiguration = new EndpointConfiguration("ClientUI");
 
-            // Choose JSON to serialize and deserialize messages
-            endpointConfiguration.UseSerialization<SystemJsonSerializer>();
+        endpointConfiguration.UseSerialization<SystemJsonSerializer>();
 
-            var endpointInstance = await Endpoint.Start(endpointConfiguration);
+        var transport = endpointConfiguration.UseTransport(new LearningTransport());
 
-            Console.WriteLine("Press Enter to exit...");
-            Console.ReadLine();
+        builder.UseNServiceBus(endpointConfiguration);
 
-            await endpointInstance.Stop();
-        }
+        await builder.Build().RunAsync();
     }
 }

tutorials/nservicebus-step-by-step/1-getting-started/Solution/ClientUI/ClientUI.csproj

@@ -1,19 +1,24 @@
-
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 16
-VisualStudioVersion = 16.0.29728.190
+# Visual Studio Version 17
+VisualStudioVersion = 17.11.35303.130
 MinimumVisualStudioVersion = 15.0.26730.12
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ClientUI", "ClientUI\ClientUI.csproj", "{D4DCF868-A625-4B0B-BB20-C150553A6548}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ClientUI", "ClientUI\ClientUI.csproj", "{D4DCF868-A625-4B0B-BB20-C150553A6548}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
 		{D4DCF868-A625-4B0B-BB20-C150553A6548}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{D4DCF868-A625-4B0B-BB20-C150553A6548}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D4DCF868-A625-4B0B-BB20-C150553A6548}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D4DCF868-A625-4B0B-BB20-C150553A6548}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
 	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {3C7A7BB7-52B2-4A1E-971C-EA47CC1833E2}
+	EndGlobalSection
 EndGlobal

tutorials/nservicebus-step-by-step/1-getting-started/Solution/ClientUI/Program.cs

@@ -69,6 +69,12 @@ snippet: ConsoleTitle
 
 When running multiple console apps in the same solution, giving each one a name makes them easier to identify. This console app's title is `ClientUI`. In later lessons, we'll expand this solution to host multiple applications.
 
+#### Setup
+
+snippet: Setup
+
+The host is typically configured, built, and run by code in the `Program` class. The `CreateApplicationBuilder` method creates and configures a builder object.
+
 #### EndpointConfiguration
 
 snippet: EndpointName
@@ -86,7 +92,7 @@ Capturing the `transport` settings in a variable as shown will make things easie
 
 ### Starting up
 
-At the end of the `Main` method, after the configuration code, add the following lines which will start the endpoint and keep it running until you press the <kbd>Enter</kbd> key to shut it down.
+At the end of the `Main` method, after the configuration code, add the following lines which will start the endpoint and keep it running until you press the <kbd>Ctrl+C</kbd> to shut it down.
 
 snippet: Startup