Skip to content

Latest commit

 

History

History
99 lines (61 loc) · 4.31 KB

signalr-quickstart-azure-functions-python.md

File metadata and controls

99 lines (61 loc) · 4.31 KB
title description author ms.service ms.devlang ms.topic ms.date ms.author
Azure SignalR Service serverless quickstart - Python
A quickstart for using Azure SignalR Service and Azure Functions to create a chat room.
anthonychu
signalr
python
quickstart
08/08/2019
antchu

Quickstart: Create a chat room with Azure Functions and SignalR Service using Python

Azure SignalR Service lets you easily add real-time functionality to your application. Azure Functions is a serverless platform that lets you run your code without managing any infrastructure. In this quickstart, learn how to use SignalR Service and Functions to build a serverless, real-time chat application.

Prerequisites

This quickstart can be run on macOS, Windows, or Linux.

Make sure you have a code editor such as Visual Studio Code installed.

Install the Azure Functions Core Tools (v2) (version 2.7.1505 or higher) to run Python Azure Function apps locally.

Azure Functions requires Python 3.6.

In order to install extensions, Azure Functions Core Tools currently require the .NET Core SDK installed. However, no knowledge of .NET is required to build Python Azure Function apps.

[!INCLUDE quickstarts-free-trial-note]

Log in to Azure

Sign in to the Azure portal at https://portal.azure.com/ with your Azure account.

[!INCLUDE Create instance]

[!INCLUDE Clone application]

Configure and run the Azure Function app

  1. In the browser where the Azure portal is opened, confirm the SignalR Service instance you deployed earlier was successfully created by searching for its name in the search box at the top of the portal. Select the instance to open it.

    Search for the SignalR Service instance

  2. Select Keys to view the connection strings for the SignalR Service instance.

  3. Select and copy the primary connection string.

    Create SignalR Service

  4. In your code editor, open the src/chat/python folder in the cloned repository.

  5. To locally develop and test Python functions, you must work in a Python 3.6 environment. Run the following commands to create and activate a virtual environment named .venv.

    Linux or macOS:

    python3.6 -m venv .venv
source .venv/bin/activate

    Windows:

    py -3.6 -m venv .venv
.venv\scripts\activate

  6. Rename local.settings.sample.json to local.settings.json.

  7. In local.settings.json, paste the connection string into the value of the AzureSignalRConnectionString setting. Save the file.

  8. Python functions are organized into folders. In each folder are two files: function.json defines the bindings that are used in the function, and __init__.py is the body of the function. There are two HTTP triggered functions in this function app:

    • negotiate - Uses the SignalRConnectionInfo input binding to generate and return valid connection information.
    • messages - Receives a chat message in the request body and uses the SignalR output binding to broadcast the message to all connected client applications.

  9. In the terminal, ensure that you are in the src/chat/python folder. Use the Azure Functions Core Tools to install extensions required to run the app.

    func extensions install

  10. Run the function app.

    func start

    Run function app

[!INCLUDE Run web application]

[!INCLUDE Cleanup]

Next steps

In this quickstart, you built and ran a real-time serverless application in VS Code. Next, learn more about how to deploy Azure Functions from VS Code.

[!div class="nextstepaction"] Deploy Azure Functions with VS Code