Início Rápido: criar um aplicativo sem servidor com o Azure Functions e o Serviço do Azure SignalR em Python

Criar um projeto do Azure Function

Criar um projeto local do Azure Function.

1. A partir de uma linha de comando, crie um diretório para seu projeto.
2. Altere para o diretório do projeto.
3. Use o comando func init do Azure Functions para inicializar seu projeto de função.

# Initialize a function project
func init --worker-runtime python

Criar as funções

Depois de inicializar um projeto, você precisa criar funções. Esse projeto requer três funções:

• index: hospeda uma página web para um cliente.
• negotiate: permite que um cliente obtenha um token de acesso.
• broadcast: usa um gatilho de tempo para transmitir mensagens periodicamente a todos os clientes.

Quando você executa o comando func new no diretório raiz do projeto, o Azure Functions Core Tools acrescenta o código de função no arquivofunction_app.py. Você editará o conteúdo do anúncio de parâmetros conforme necessário, substituindo o código padrão pelo código do aplicativo.

Cria a função do índice

Você pode usar essa função de exemplo como um modelo para suas próprias funções.

Abra o arquivo function_app.py . Esse arquivo conterá suas funções. Primeiro, modifique o arquivo para incluir as instruções de importação necessárias e defina variáveis globais que usaremos nas funções a seguir.

import azure.functions as func
import os
import requests
import json 

app = func.FunctionApp()

etag = ''
start_count = 0

2. Adicione a função index adicionando o código a seguir

@app.route(route="index", auth_level=func.AuthLevel.ANONYMOUS)
def index(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')

Essa função hospeda uma página da Web para um cliente.

Criar a função negociar

Adicione a função negotiate adicionando o código a seguir.

As cadeias de conexão brutas aparecem neste artigo apenas para fins de demonstração. Em ambientes de produção, sempre proteja suas chaves de acesso. Use o Azure Key Vault para gerenciar e rotacionar suas chaves com segurança, proteger sua cadeia de conexão usando o Microsoft Entra ID e autorizar o acesso com o Microsoft Entra ID.

@app.route(route="negotiate", auth_level=func.AuthLevel.ANONYMOUS, methods=["POST"])
@app.generic_input_binding(arg_name="connectionInfo", type="signalRConnectionInfo", hubName="serverless", connectionStringSetting="AzureSignalRConnectionString")
def negotiate(req: func.HttpRequest, connectionInfo) -> func.HttpResponse:
    return func.HttpResponse(connectionInfo)

Essa função permite que um cliente obtenha um token de acesso.

Criar uma função de transmissão.

Adicione a função broadcast adicionando o código a seguir

@app.timer_trigger(schedule="*/1 * * * *", arg_name="myTimer",
              run_on_startup=False,
              use_monitor=False)
@app.generic_output_binding(arg_name="signalRMessages", type="signalR", hubName="serverless", connectionStringSetting="AzureSignalRConnectionString")
def broadcast(myTimer: func.TimerRequest, signalRMessages: func.Out[str]) -> None:
    global etag
    global start_count
    headers = {'User-Agent': 'serverless', 'If-None-Match': etag}
    res = requests.get('https://api.github.com/repos/azure/azure-functions-python-worker', headers=headers)
    if res.headers.get('ETag'):
        etag = res.headers.get('ETag')

    if res.status_code == 200:
        jres = res.json()
        start_count = jres['stargazers_count']

    signalRMessages.set(json.dumps({
        'target': 'newMessage',
        'arguments': [ 'Current star count of https://api.github.com/repos/azure/azure-functions-python-worker is: ' + str(start_count) ]
    }))

Essa função usa um gatilho de tempo para transmitir mensagens periodicamente para todos os clientes.

Criar um projeto do Azure Function

Criar um projeto local do Azure Function.

1. A partir de uma linha de comando, crie um diretório para seu projeto.
2. Altere para o diretório do projeto.
3. Use o comando func init do Azure Functions para inicializar seu projeto de função.

# Initialize a function project
func init --worker-runtime python --model v1

Criar as funções

Depois de inicializar um projeto, você precisa criar funções. Esse projeto requer três funções:

• index: hospeda uma página web para um cliente.
• negotiate: permite que um cliente obtenha um token de acesso.
• broadcast: usa um gatilho de tempo para transmitir mensagens periodicamente a todos os clientes.

Quando você executa o comando func new no diretório raiz do projeto, o Azure Functions Core Tools cria arquivos de origem de função padrão e os armazena em uma pasta com o nome da função. Você editará os arquivos conforme necessário, substituindo o código padrão pelo código do aplicativo.

Cria a função do índice

Você pode usar essa função de exemplo como um modelo para suas próprias funções.

1. Execute o seguinte comando para criar a função index.

func new -n index -t HttpTrigger

1. Edite index/function.json e substitua o conteúdo pelo código json a seguir:

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

1. Edite index/_init_.py e substitua o conteúdo pelo código a seguir:

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

Criar a função negociar

1. Execute o comando a seguir para criar a função negotiate.

func new -n negotiate -t HttpTrigger

1. Edite negotiate/function.json e substitua o conteúdo pelo código json a seguir:

{
  "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"
    }
  ]
}

1. Edite negotiate/_init_.py e substitua o conteúdo pelo código a seguir:

import azure.functions as func


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

Criar uma função de transmissão.

1. Execute o comando a seguir para criar a função de broadcast.

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

1. Edite broadcast/function.json e substitua o conteúdo pelo seguinte código:

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

1. Edite broadcast/_init_.py e substitua o conteúdo pelo código a seguir:

import requests
import json

import azure.functions as func

etag = ''
start_count = 0

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

    if res.status_code == 200:
        jres = res.json()
        start_count = jres['stargazers_count']

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