Quickstart: Een app maken met GitHub aantal sterren met Azure Functions en SignalR Service python

Artikel
11/25/2021
5 minuten om te lezen

Met de service Azure SignalR kunt u eenvoudig realtimefunctionaliteit toevoegen aan een toepassing. Azure Functions is een serverloos platform waarmee u code kunt uitvoeren zonder een infrastructuur te beheren. In deze quickstart leert u hoe u SignalR Service en Azure Functions serverloze toepassing kunt bouwen met Python om berichten naar clients uit te zenden.

Notitie

U kunt alle codes die in het artikel worden vermeld, op GitHub

Vereisten

Deze quickstart kan worden uitgevoerd op macOS, Windows of Linux.

Zorg ervoor dat u een code-editor hebt geïnstalleerd, bijvoorbeeld Visual Studio Code.

Installeer Azure Functions Core Tools (versie 2.7.1505 of hoger) om lokaal Azure Function-apps in Python uit te voeren.

Azure Functions python 3.6+ is vereist. (Zie Ondersteunde Python-versies)

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Meld u aan bij Azure.

Meld u met uw Azure-account aan bij Azure Portal op https://portal.azure.com/.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Een exemplaar van de Azure SignalR Service maken

Uw toepassing maakt verbinding met een SignalR-Service-exemplaar in Azure.

Selecteer de knop Nieuw in de linkerbovenhoek van Azure Portal. Typ in het scherm Nieuw SignalR Service in het zoekvak in en druk op Enter.
Selecteer SignalR Service in de zoekresultaten en selecteer Maken.

Voer de volgende instellingen in.

Instelling	Voorgestelde waarde	Beschrijving
Resourcenaam	Wereldwijd unieke naam	Naam ter identificatie van uw nieuwe SignalR Service-exemplaar. Geldige tekens zijn `a-z`, `0-9` en `-`.
Abonnement	Uw abonnement	Het abonnement waarin dit nieuwe SignalR Service-exemplaar is gemaakt.
Resourcegroep	myResourceGroup	Naam voor de nieuwe resourcegroep waarin het SignalR Service-exemplaar moet worden gemaakt.
Locatie	VS - west	Kies een regio bij u in de buurt.
Prijscategorie	Gratis	Probeer Azure SignalR Service gratis uit.
Aantal eenheden	Niet van toepassing	Het aantal eenheden geeft aan hoeveel verbindingen uw SignalR Service-exemplaar kan accepteren. Dit kan alleen worden geconfigureerd in de Standard-laag.
Servicemodus	Serverloos	Voor gebruik met Azure Functions of REST-API.

Schermopname met het tabblad Basisbeginselen van SignalR met waarden.

Selecteer Maken om te beginnen met het implementeren van het SignalR-Service-exemplaar.
Zodra het exemplaar is geïmplementeerd, opent u dit in de portal en zoekt u de bijbehorende Instellingen-pagina. Wijzig de instelling van Servicemodus alleen in Serverloos als u de Azure SignalR-service gebruikt via Azure Functions-binding of de REST-API. Laat de modus anders op Klassiek of Standaard staan.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

De Azure-functie lokaal instellen en uitvoeren

Zorg ervoor dat Azure Function Core Tools is geïnstalleerd. Maak een lege map en navigeer naar de map met de opdrachtregel.
```
# Initialize a function project
func init --worker-runtime python
```

Nadat u een project hebt initialiseren, moet u functies maken. In dit voorbeeld moeten we drie functies maken.

Voer de volgende opdracht uit om een functie index te maken waarmee een webpagina voor de client wordt host.

func new -n index -t HttpTrigger

Open index/function.json en kopieer de volgende json-codes:

{
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    }
  ]
}

Open index/__init__.py en kopieer de volgende codes.

import os

import azure.functions as func


def main(req: func.HttpRequest) -> func.HttpResponse:
    f = open(os.path.dirname(os.path.realpath(__file__)) + '/../content/index.html')
    return func.HttpResponse(f.read(), mimetype='text/html')

Maak een negotiate functie voor clients om toegangs token op te halen.

func new -n negotiate -t SignalRNegotiateHTTPTrigger

Open negotiate/function.json en kopieer de volgende json-codes:

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "authLevel": "anonymous",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": [
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "$return"
    },
    {
      "type": "signalRConnectionInfo",
      "name": "connectionInfo",
      "hubName": "serverless",
      "connectionStringSetting": "AzureSignalRConnectionString",
      "direction": "in"
    }
  ]
}

Open de negotiate/__init__.py en kopieer de volgende codes:

import azure.functions as func


def main(req: func.HttpRequest, connectionInfo) -> func.HttpResponse:
    return func.HttpResponse(connectionInfo)

Maak een broadcast functie om berichten uit te zenden naar alle clients. In het voorbeeld gebruiken we tijdtrigger om periodiek berichten uit te zenden.

func new -n broadcast -t TimerTrigger
# install requests
pip install requests

Open broadcast/function.json en kopieer de volgende codes.

{
  "scriptFile": "__init__.py",
  "bindings": [
    {
      "name": "myTimer",
      "type": "timerTrigger",
      "direction": "in",
      "schedule": "*/5 * * * * *"
    },
    {
      "type": "signalR",
      "name": "signalRMessages",
      "hubName": "serverless",
      "connectionStringSetting": "AzureSignalRConnectionString",
      "direction": "out"
    }
  ]
}

Open broadcast/__init__.py en kopieer de volgende codes.

import requests
import json

import azure.functions as func


def main(myTimer: func.TimerRequest, signalRMessages: func.Out[str]) -> None:
    headers = {'User-Agent': 'serverless'}
    res = requests.get('https://api.github.com/repos/azure/azure-signalr', headers=headers)
    jres = res.json()

    signalRMessages.set(json.dumps({
        'target': 'newMessage',
        'arguments': [ 'Current star count of https://github.com/Azure/azure-signalr is: ' + str(jres['stargazers_count']) ]
    }))

De clientinterface van dit voorbeeld is een webpagina. Als we HTML-inhoud uit content/index.html in index de functie lezen, maakt u een nieuw bestand index.html in de map onder de content hoofdmap van uw project. Kopieer de volgende inhoud.

<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>

Het is nu bijna klaar. De laatste stap is het instellen van een connection string van de SignalR Service op Azure Function-instellingen.
1. Controleer in de browser waarin de Azure-portal is geopend, of het service-exemplaar van SignalR dat u eerder hebt geïmplementeerd, is gemaakt. Hiervoor typt u de naam van het exemplaar in het zoekvak boven in de portal. Selecteer het exemplaar om het te openen.
2. Selecteer Sleutels om de verbindingsreeksen voor het service-exemplaar van SignalR weer te geven.
3. Kopieer de primaire connection string. Voer de onderstaande opdracht uit.
```
func settings add AzureSignalRConnectionString "<signalr-connection-string>"
```
Voer de Azure-functie lokaal uit:
```
func start
```
Nadat De Azure-functie lokaal is uitgevoerd. Gebruik uw browser om naar te http://localhost:7071/api/index gaan en u kunt het huidige aantal sterren zien. En als u in de GitHub een ster laat zien, wordt het aantal sterren elke paar seconden vernieuwd.

Notitie

SignalR-binding Azure Storage, maar u kunt de lokale opslagemulator gebruiken wanneer de functie lokaal wordt uitgevoerd. Als er een foutbericht wordt There was an error performing a read operation on the Blob Storage Secret Repository. Please ensure the 'AzureWebJobsStorage' connection string is valid. weergegeven, zoals U moet deze downloaden en inschakelen Storage Emulator

Resources opschonen

Als u deze app niet verder gaat gebruiken, kunt u alle resources verwijderen die door deze Quick Start zijn aangemaakt door de onderstaande stappen te volgen, zodat u geen kosten in rekening worden gebracht:

Selecteer in Azure Portal Resourcegroepen aan de linkerkant en selecteer vervolgens de resourcegroep die u hebt gemaakt. U kunt ook het zoekvak gebruiken om de resourcegroep op de naam te zoeken.
Selecteer in het venster dat wordt geopend, de resourcegroep en klik op Resourcegroep verwijderen.
Voer in het nieuwe venster de naam in van de resourcegroep die u wilt verwijderen en klik vervolgens op Verwijderen.

Ondervindt u problemen? Probeer de gids voor probleemoplossing of laat het ons weten.

Volgende stappen

In deze quickstart hebt u een serverloze realtimetoepassing lokaal gebouwd en uitgevoerd. Meer informatie over het gebruik SignalR Service bindingen voor Azure Functions. Hierna leert u meer over bi-directionele communicatie tussen clients en Azure Function met SignalR Service.

SignalR-servicebindingen voor Azure Functions

Bi-directionele communicatie in serverloos

Azure Functions met VS Code implementeren

Quickstart: Een app maken met GitHub aantal sterren met Azure Functions en SignalR Service python

Beoordeel uw ervaring

Vereisten

Meld u aan bij Azure.

Een exemplaar van de Azure SignalR Service maken

De Azure-functie lokaal instellen en uitvoeren

Resources opschonen

Volgende stappen