Rychlý start: Vytvoření aplikace zobrazující počet hvězd GitHubu se službou Azure Functions a službou SignalR prostřednictvím jazyka C#

V tomto článku se dozvíte, jak pomocí služby SignalR a Azure Functions sestavit bezserverovou aplikaci s jazykem C# k vysílání zpráv klientům.

Požadavky

Pro účely tohoto rychlého startu jsou potřeba následující požadavky:

• Visual Studio Code nebo jiný editor kódu Pokud ještě nemáte visual Studio Code nainstalovaný, stáhněte si Visual Studio Code sem.
• Předplatné Azure. Pokud nemáte předplatné Azure, vytvořte si ho zdarma , než začnete.
• Azure Functions Core Tools
• Sada .NET Core SDK

Vytvoření instance služby Azure SignalR Service

V této části vytvoříte základní instanci Azure SignalR, která se použije pro vaši aplikaci. Následující kroky používají azure Portal k vytvoření nové instance, ale můžete také použít Azure CLI. Další informace najdete v tématu az signalr create command in the Azure SignalR Service CLI Reference.

1. Přihlaste se k portálu Azure.
2. V levém horním rohu stránky vyberte + Vytvořit prostředek.
3. Na stránce Vytvořit prostředek v textovém poli Search s a marketplace zadejte signalr a ze seznamu vyberte Službu SignalR.
4. Na stránce Služby SignalR vyberte Vytvořit.
5. Na kartě Základy zadáte základní informace pro novou instanci služby SignalR. Zadejte následující hodnoty:

V kurzech SignalR nemusíte měnit nastavení na kartách Sítě a značky .

6. Vyberte tlačítko Zkontrolovat a vytvořit v dolní části karty Základy.
7. Na kartě Zkontrolovat a vytvořit zkontrolujte hodnoty a pak vyberte Vytvořit. Dokončení nasazení chvíli trvá.
8. Po dokončení nasazení vyberte tlačítko Přejít k prostředku .
9. Na stránce prostředku SignalR vyberte v nabídce na levé straně v části Nastavení.
10. Zkopírujte řetězec Připojení ion pro primární klíč. Tuto připojovací řetězec budete potřebovat ke konfiguraci aplikace později v tomto kurzu.

Místní nastavení a spuštění funkce Azure Functions

K tomuto kroku potřebujete nástroje Azure Functions Core Tools.

1. Vytvořte prázdný adresář a přejděte do adresáře pomocí příkazového řádku.

2. Inicializace nového projektu

   • Probíhá proces
   • Izolovaný proces

   # Initialize a function project
   func init --worker-runtime dotnet
   
   # Add SignalR Service package reference to the project
   dotnet add package Microsoft.Azure.WebJobs.Extensions.SignalRService
   

3. Pomocí editoru kódu vytvořte nový soubor s názvem Function.cs. Do Function.cs přidejte následující kód:

   • Probíhá proces
   • Izolovaný proces

   using System;
   using System.IO;
   using System.Linq;
   using System.Net.Http;
   using System.Threading.Tasks;
   using Microsoft.AspNetCore.Http;
   using Microsoft.AspNetCore.Mvc;
   using Microsoft.Azure.WebJobs;
   using Microsoft.Azure.WebJobs.Extensions.Http;
   using Microsoft.Azure.WebJobs.Extensions.SignalRService;
   using Newtonsoft.Json;
   
   namespace CSharp
   {
       public static class Function
       {
           private static HttpClient httpClient = new HttpClient();
           private static string Etag = string.Empty;
           private static string StarCount = "0";
   
           [FunctionName("index")]
           public static IActionResult GetHomePage([HttpTrigger(AuthorizationLevel.Anonymous)]HttpRequest req, ExecutionContext context)
           {
               var path = Path.Combine(context.FunctionAppDirectory, "content", "index.html");
               return new ContentResult
               {
                   Content = File.ReadAllText(path),
                   ContentType = "text/html",
               };
           }
   
           [FunctionName("negotiate")]
           public static SignalRConnectionInfo Negotiate(
               [HttpTrigger(AuthorizationLevel.Anonymous)] HttpRequest req,
               [SignalRConnectionInfo(HubName = "serverless")] SignalRConnectionInfo connectionInfo)
           {
               return connectionInfo;
           }
   
           [FunctionName("broadcast")]
           public static async Task Broadcast([TimerTrigger("*/5 * * * * *")] TimerInfo myTimer,
           [SignalR(HubName = "serverless")] IAsyncCollector<SignalRMessage> signalRMessages)
           {
               var request = new HttpRequestMessage(HttpMethod.Get, "https://api.github.com/repos/azure/azure-signalr");
               request.Headers.UserAgent.ParseAdd("Serverless");
               request.Headers.Add("If-None-Match", Etag);
               var response = await httpClient.SendAsync(request);
               if (response.Headers.Contains("Etag"))
               {
                   Etag = response.Headers.GetValues("Etag").First();
               }
               if (response.StatusCode == System.Net.HttpStatusCode.OK)
               {
                   var result = JsonConvert.DeserializeObject<GitResult>(await response.Content.ReadAsStringAsync());
                   StarCount = result.StarCount;
               }
   
               await signalRMessages.AddAsync(
                   new SignalRMessage
                   {
                       Target = "newMessage",
                       Arguments = new[] { $"Current star count of https://github.com/Azure/azure-signalr is: {StarCount}" }
                   });
           }
   
           private class GitResult
           {
               [JsonRequired]
               [JsonProperty("stargazers_count")]
               public string StarCount { get; set; }
           }
       }
   }
   

   Kód v Function.cs má tři funkce:

   • GetHomePage slouží k získání webu jako klienta.
   • Negotiate klient ho používá k získání přístupového tokenu.
   • Broadcast se pravidelně volá, aby se z GitHubu získal počet hvězdiček a pak se zprávy vysílaly všem klientům.

4. Klientské rozhraní pro tuto ukázku je webová stránka. Webovou stránku vykreslíme GetHomePage pomocí funkce čtením obsahu HTML ze souboru content/index.html. Teď vytvoříme tuto index.html podadresářem content s následujícím obsahem:

   <html>
   
   <body>
     <h1>Azure SignalR Serverless Sample</h1>
     <div id="messages"></div>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/microsoft-signalr/3.1.7/signalr.min.js"></script>
     <script>
       let messages = document.querySelector('#messages');
       const apiBaseUrl = window.location.origin;
       const connection = new signalR.HubConnectionBuilder()
           .withUrl(apiBaseUrl + '/api')
           .configureLogging(signalR.LogLevel.Information)
           .build();
         connection.on('newMessage', (message) => {
           document.getElementById("messages").innerHTML = message;
         });
   
         connection.start()
           .catch(console.error);
     </script>
   </body>
   
   </html>
   

5. Aktualizujte *.csproj stránku obsahu ve výstupní složce sestavení.

   <ItemGroup>
     <None Update="content/index.html">
       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
     </None>
   </ItemGroup>
   

6. Azure Functions vyžaduje, aby fungoval účet úložiště. Emulátor služby Azure Storage můžete nainstalovat a spustit. Nebo můžete nastavení aktualizovat tak, aby používalo skutečný účet úložiště pomocí následujícího příkazu:

   func settings add AzureWebJobsStorage "<storage-connection-string>"
   

7. Už je to skoro hotové. Posledním krokem je nastavení připojovací řetězec služby SignalR na nastavení funkce Azure Functions.

   1. Ověřte, že se instance služby SignalR úspěšně vytvořila, a to vyhledáním jejího názvu do vyhledávacího pole v horní části portálu. Instanci vyberte a otevřete.

      

   2. Výběrem možnosti Klíče zobrazte připojovací řetězce instance služby SignalR.

      

   3. Zkopírujte primární připojovací řetězec a spusťte následující příkaz:

      func settings add AzureSignalRConnectionString "<signalr-connection-string>"
      

8. Spusťte funkci Azure místně:

   func start
   

   Jakmile je funkce Azure spuštěná místně, otevřete http://localhost:7071/api/indexji a zobrazí se aktuální počet hvězdiček. Pokud v GitHubu hvězdičku nebo ji zrušíte, získáte počet hvězdiček, který se aktualizuje každých několik sekund.

Vyčištění prostředků

Pokud nebudete tuto aplikace nadále používat, odstraňte na základě následujícího postupu všechny prostředky vytvořené podle tohoto rychlého startu, aby se vám neúčtovaly žádné poplatky:

1. Úplně nalevo na webu Azure Portal vyberte Skupiny prostředků a pak vyberte skupinu prostředků, kterou jste vytvořili. Případně můžete použít vyhledávací pole a skupinu prostředků vyhledat podle jejího názvu.

2. V okně, které se otevře, vyberte příslušnou skupinu prostředků a pak klikněte na Odstranit skupinu prostředků.

3. V novém okně zadejte název skupiny prostředků, kterou chcete odstranit, a pak klikněte na Odstranit.

Máte problémy? Vyzkoušejte průvodce odstraňováním potíží nebo nám dejte vědět.

Další kroky

V tomto rychlém startu jste vytvořili a spustili aplikaci bez serveru v reálném čase místně. V dalším kroku se dozvíte více o obousměrné komunikaci mezi klienty a Azure Functions se službou Azure SignalR Service.