Copy current chatrooms to a netcore21 folder (#123)

* Copy current chatrooms to a netcore22 folder

* Use netcore21 as it is lts

* resolve comments

Author: vicancy

README.md

@@ -27,22 +27,10 @@ More advanced samples are listed as below:
 * [Realtime Sign-in Example using Azure SignalR Service](samples/RealtimeSignIn)
 * [Flight Map: Realtime Monitoring Dashboard using Azure SignalR Service](samples/FlightMap)
 
+***Archived*** Chat Room Example under AspNetCore 2.1 version:
+* [Chat Room Example under AspNetCore 2.1.0](samples/ChatRoom.NetCore21/ChatRoom/README.md)
+
 ## ASP.NET SignalR samples
 
 * [Get Started with ASP.NET SignalR: a Chat Room Example](aspnet-samples/ChatRoomLocal)
 * [Build Your First Azure SignalR Service Application for ASP.NET SignalR](aspnet-samples/ChatRoom)
-
-## Updates of Azure SignalR Service Runtime and SDK
-
-We have made some changes to Azure SignalR Service Runtime, as well as Service SDK. You have to upgrade to the latest Service SDK to connect to the latest Service Runtime.
-
-### SDK for ASP.NET Core SignalR
-In the latest Service SDK for **ASP.NET Core SignalR**, we have made the following changes:
-
-- Dependency injection is built on top of ASP.NET Core SignalR.
-- Expose a built-in authentication endpoint to issue access token. User authentication endpoint is not required any more.
-- Re-design interfaces for REST API.
-- Remove .NET Framework support. We plan to support .NET Framework in later releases.
-
-### SDK for ASP.NET SignalR
-The first preview version of Service SDK for **ASP.NET SignalR** is released.

samples/ChatRoom.NetCore21/ChatRoom/.gitignore

@@ -0,0 +1,4 @@
+bin/
+obj/
+.vs/
+**.csproj.user

samples/ChatRoom.NetCore21/ChatRoom/ChatRoom.csproj

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>netcoreapp2.1</TargetFramework>
+    <UserSecretsId>chatroom</UserSecretsId>
+    <RootNamespace>Microsoft.Azure.SignalR.Samples.ChatRoom</RootNamespace>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Folder Include="wwwroot\" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.App" Version="2.1.0" />
+    <PackageReference Include="Microsoft.Azure.SignalR" Version="1.*" />
+  </ItemGroup>
+</Project>

samples/ChatRoom.NetCore21/ChatRoom/Dockerfile

@@ -0,0 +1,20 @@
+# Copyright (c) Microsoft. All rights reserved.
+# Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+FROM microsoft/dotnet:2.1-sdk-stretch AS build-env
+WORKDIR /app
+
+# copy csproj and restore as distinct layers
+RUN mkdir ChatRoom && cd ChatRoom/
+COPY *.csproj ./
+RUN dotnet restore
+
+# copy everything else and build
+COPY ./ ./
+RUN dotnet publish -c Release -o out
+
+# build runtime image
+FROM microsoft/dotnet:2.1-aspnetcore-runtime
+WORKDIR /app
+COPY --from=build-env /app/out .
+ENTRYPOINT ["dotnet", "ChatRoom.dll"]

samples/ChatRoom.NetCore21/ChatRoom/Hub/ChatSampleHub.cs

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.AspNetCore.SignalR;
+
+namespace Microsoft.Azure.SignalR.Samples.ChatRoom
+{
+    public class ChatSampleHub : Hub
+    {
+        public void BroadcastMessage(string name, string message)
+        {
+            Clients.All.SendAsync("broadcastMessage", name, message);
+        }
+
+        public void Echo(string name, string message)
+        {
+            Clients.Client(Context.ConnectionId).SendAsync("echo", name, message + " (echo from server)");
+        }
+    }
+}

samples/ChatRoom.NetCore21/ChatRoom/Program.cs

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.AspNetCore;
+using Microsoft.AspNetCore.Hosting;
+
+namespace Microsoft.Azure.SignalR.Samples.ChatRoom
+{
+    public class Program
+    {
+        public static void Main(string[] args)
+        {
+            CreateWebHostBuilder(args).Build().Run();
+        }
+
+        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
+            WebHost.CreateDefaultBuilder(args)
+                .UseStartup<Startup>();
+    }
+}

samples/ChatRoom.NetCore21/ChatRoom/Properties/launchSettings.json

@@ -0,0 +1,27 @@
+{
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:5000/",
+      "sslPort": 0
+    }
+  },
+  "profiles": {
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "ChatRoom": {
+      "commandName": "Project",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      },
+      "applicationUrl": "http://localhost:5000/"
+    }
+  }
+}

samples/ChatRoom.NetCore21/ChatRoom/README.md

@@ -0,0 +1,82 @@
+# Build Your First Azure SignalR Service Application
+
+In [ChatRoomLocal sample](../ChatRoomLocal/README.md) you have learned how to use SignalR to build a chat room application. In that sample, the SignalR runtime (which manages the client connections and message routing) is running on your local machine. As the number of the clients increases, you'll eventually hit a limit on your machine and you'll need to scale up your machine to handle more clients. This is usually not an easy task. In this tutorial, you'll learn how to use Azure SignalR Service to offload the connection management part to the service so that you don't need to worry about the scaling problem.
+
+## Provision a SignalR Service
+
+First let's provision a SignalR service on Azure.
+> If you don't have an Azure subscription, **[start now](https://azure.microsoft.com/en-us/free/)** to create a free account.
+
+1. Open Azure portal, click "Create a resource" and search "SignalR Service".
+
+   ![signalr-4](../../../docs/images/signalr-4.png)
+
+2. Navigate to "SignalR Service" and click "Create".
+   
+   ![signalr-5](../../../docs/images/signalr-5.png)
+
+3. Fill in basic information including resource name, resource group and location.
+
+   ![signalr-2](../../../docs/images/signalr-2.png)
+
+   Resource name will also be used as the DNS name of your service endpoint. So you'll get a `<resource_name>.service.signalr.net` that your application can connect to.
+
+   Select a pricing tier. There're two pricing tiers:
+   
+   * Free: which can handle 20 connections at the same time and can send and receive 20,000 messages in a day.
+   * Standard: which has 1000 concurrent connections and one million messages per day limit for *one unit*. You can scale up to 100 units for a single service instance and you'll be charged by the number of units you use.
+
+4. Click "Create", your SignalR service will be created in a few minutes.
+
+   ![signalr-3](../../../docs/images/signalr-3.png)
+
+After your service is ready, go to the **Keys** page of your service instance and you'll get two connection strings that your application can use to connect to the service.
+
+## Update Chat Room to Use Azure SignalR Service
+
+Then, let's update the chat room sample to use the new service you just created.
+
+Let's look at the key changes:
+
+1.  In [Startup.cs](Startup.cs), instead of calling `AddSignalR()` and `UseSignalR()`, you need to call `AddAzureSignalR()` and `UseAzureSignalR()` and pass in connection string to make the application connect to the service instead of hosting SignalR by itself.
+
+    ```cs
+    public void ConfigureServices(IServiceCollection services)
+    {
+        ...
+        services.AddSignalR()
+                .AddAzureSignalR();
+    }
+
+    public void Configure(IApplicationBuilder app)
+    {
+        ...
+        app.UseAzureSignalR(routes => 
+        { 
+            routes.MapHub<Chat>("/chat"); 
+        });
+    }
+    ```
+
+    You also need to reference the service SDK before using these APIs. This is how that would look in your ChatRoom.csproj file:
+
+    ```xml
+    <PackageReference Include="Microsoft.Azure.SignalR" Version="1.*" />
+    ```
+
+Other than these changes, everything else remains the same, you can still use the hub interface you're already familiar with to write business logic.
+
+> Under the hood, an endpoint `/chat/negotiate` is exposed for negotiation by Azure SignalR Service SDK. It will return a special negotiation response when clients try to connect and redirect clients to service endpoint from the connection string. Read more details about the redirection at SignalR's [Negotiation Protocol](https://github.com/aspnet/SignalR/blob/master/specs/TransportProtocols.md#post-endpoint-basenegotiate-request).
+
+
+Now set the connection string in the [Secret Manager](https://docs.microsoft.com/en-us/aspnet/core/security/app-secrets?view=aspnetcore-2.1&tabs=visual-studio#secret-manager) tool for .NET Core, and run this app.
+
+```
+dotnet restore
+dotnet user-secrets set Azure:SignalR:ConnectionString "<your connection string>"
+dotnet run
+```
+
+When you open http://localhost:5000, you can see the application runs as usual, just instead of hosting a SignalR runtime by itself, it connects to the SignalR service running on Azure.
+
+In this sample, you have learned how to use Azure SignalR Service to replace your self-hosted SignalR runtime. But you still need a web server to host your hub logic. In the next tutorial you'll learn how to use other Azure services to host your hub logic so you can get everything running in the cloud.

samples/ChatRoom.NetCore21/ChatRoom/Startup.cs

@@ -0,0 +1,36 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+using Microsoft.AspNetCore.Builder;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Microsoft.Azure.SignalR.Samples.ChatRoom
+{
+    public class Startup
+    {
+        public Startup(IConfiguration configuration)
+        {
+            Configuration = configuration;
+        }
+
+        public IConfiguration Configuration { get; }
+
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddMvc();
+            services.AddSignalR()
+                    .AddAzureSignalR();
+        }
+
+        public void Configure(IApplicationBuilder app)
+        {
+            app.UseMvc();
+            app.UseFileServer();
+            app.UseAzureSignalR(routes =>
+            {
+                routes.MapHub<ChatSampleHub>("/chat");
+            });
+        }
+    }
+}

samples/ChatRoom.NetCore21/ChatRoom/appsettings.json

@@ -0,0 +1,15 @@
+{
+  "Logging": {
+    "IncludeScopes": false,
+    "Debug": {
+      "LogLevel": {
+        "Default": "Debug"
+      }
+    },
+    "Console": {
+      "LogLevel": {
+        "Default": "Debug"
+      }
+    }
+  }
+}