Guia de início rápido: criar um aplicativo Python Durable Functions

3. Nos prompts, forneça as seguintes informações:

   Pedido	Ação	Descrição
   Selecione um idioma para seu projeto de aplicativo de função	Selecione Python.	Cria um projeto Python Functions local.
   Selecione uma versão	Selecione Azure Functions v4.	Você verá essa opção somente quando o Core Tools ainda não estiver instalado. Nesse caso, o Core Tools é instalado na primeira vez que você executa o aplicativo.
   Versão de Python	Selecione Python 3.7, Python 3.8, Python 3.9 ou Python 3.10.	O Visual Studio Code cria um ambiente virtual usando a versão selecionada.
   Selecione um modelo para a primeira função do seu projeto	Selecione Ignorar por enquanto.
   Selecione como gostaria de abrir o seu projeto	Selecione Abrir na janela atual.	Abre o Visual Studio Code na pasta selecionada.

3. Nos prompts, forneça as seguintes informações:

   Pedido	valor	Description
   Selecione um idioma	Selecione Python (Programming Model V2).	Cria um projeto Python Functions local usando o modelo de programação V2.
   Selecione uma versão	Selecione Azure Functions v4.	Você verá essa opção somente quando o Core Tools ainda não estiver instalado. Nesse caso, o Core Tools é instalado na primeira vez que você executa o aplicativo.
   Versão de Python	Selecione Python 3.7, Python 3.8, Python 3.9 ou Python 3.10.	O Visual Studio Code cria um ambiente virtual usando a versão selecionada.
   Selecione como gostaria de abrir o seu projeto	Selecione Abrir na janela atual.	Abre o Visual Studio Code na pasta selecionada.

Função orquestradora

Você usa um modelo para criar o código do aplicativo Durable Functions em seu projeto.

1. Na paleta de comandos, insira e selecione Azure Functions: Create Function.

2. Nos prompts, forneça as seguintes informações:

   Pedido	Ação	Descrição
   Selecione um modelo para a sua função	Selecione Orquestrador de funções duráveis.	Cria uma orquestração de aplicativos Durable Functions.
   Fornecer um nome de função	Selecione HelloOrchestrator.	Um nome para a sua função durável.

Você adicionou um orquestrador para coordenar as funções de atividade. Abra o HelloOrchestrator/__init__.py para ver a função orchestrator. Cada chamada para context.call_activity invocar uma função de atividade chamada Hello.

Em seguida, você adiciona a função de atividade referenciada Hello .

Função de atividade

1. Na paleta de comandos, insira e selecione Azure Functions: Create Function.

2. Nos prompts, forneça as seguintes informações:

   Pedido	Ação	Descrição
   Selecione um modelo para a sua função	Selecione a atividade Funções duráveis.	Cria uma função de atividade.
   Fornecer um nome de função	Digite Olá.	O nome da sua função de atividade.

Você adicionou a Hello função de atividade que é invocada pelo orquestrador. Abra Olá/__init__.py para ver que ele usa um nome como entrada e retorna uma saudação. Uma função de atividade é onde você executa ações como fazer uma chamada de banco de dados ou executar um cálculo.

Finalmente, você adiciona uma função acionada por HTTP que inicia a orquestração.

Função de cliente (HTTP starter)

1. Na paleta de comandos, insira e selecione Azure Functions: Create Function.

2. Nos prompts, forneça as seguintes informações:

   Pedido	Ação	Descrição
   Selecione um modelo para a sua função	Selecione Durable Functions HTTP starter.	Cria uma função inicial HTTP.
   Fornecer um nome de função	Digite DurableFunctionsHttpStart.	O nome da função do cliente
   Nível de autorização	Selecione Anônimo.	Para fins de demonstração, esse valor permite que a função seja chamada sem usar autenticação.

Você adicionou uma função acionada por HTTP que inicia uma orquestração. Abra DurableFunctionsHttpStart/__init__.py para ver que ele usa client.start_new para iniciar uma nova orquestração. Em seguida, ele usa client.create_check_status_response para retornar uma resposta HTTP contendo URLs que podem ser usadas para monitorar e gerenciar a nova orquestração.

Agora você tem um aplicativo de Funções Duráveis que pode ser executado localmente e implantado no Azure.

Requisitos

A versão 2 do modelo de programação Python requer as seguintes versões mínimas:

• Azure Functions Runtime v4.16+
• Azure Functions Core Tools v4.0.5095+ (se executado localmente)
• azure-functions-durable v1.2.4+

Ativar o modelo de programação v2

A seguinte configuração de aplicativo é necessária para executar o modelo de programação v2:

• Designação: AzureWebJobsFeatureFlags
• Valor: EnableWorkerIndexing

Se você estiver executando localmente usando as Ferramentas Principais do Azure Functions, adicione essa configuração ao seu arquivo de local.settings.json . Se você estiver executando no Azure, conclua estas etapas usando uma ferramenta relevante:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> --resource-group <RESOURCE_GROUP_NAME> --settings AzureWebJobsFeatureFlags=EnableWorkerIndexing

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"AzureWebJobsFeatureFlags" = "EnableWorkerIndexing"}

Para criar um aplicativo básico de Funções Duráveis usando esses três tipos de função, substitua o conteúdo do function_app.py pelo seguinte código Python:

import azure.functions as func
import azure.durable_functions as df

myApp = df.DFApp(http_auth_level=func.AuthLevel.ANONYMOUS)

# An HTTP-triggered function with a Durable Functions client binding
@myApp.route(route="orchestrators/{functionName}")
@myApp.durable_client_input(client_name="client")
async def http_start(req: func.HttpRequest, client):
    function_name = req.route_params.get('functionName')
    instance_id = await client.start_new(function_name)
    response = client.create_check_status_response(req, instance_id)
    return response

# Orchestrator
@myApp.orchestration_trigger(context_name="context")
def hello_orchestrator(context):
    result1 = yield context.call_activity("hello", "Seattle")
    result2 = yield context.call_activity("hello", "Tokyo")
    result3 = yield context.call_activity("hello", "London")

    return [result1, result2, result3]

# Activity
@myApp.activity_trigger(input_name="city")
def hello(city: str):
    return f"Hello {city}"

Analise a tabela a seguir para obter uma explicação de cada função e sua finalidade no exemplo:

1. Para testar sua função, defina um ponto de interrupção no código da Hello função de atividade (em Olá/__init__.py). Selecione F5 ou selecione Depurar: Iniciar depuração na paleta de comandos para iniciar o projeto de aplicativo de função. A saída das Ferramentas Principais aparece no painel do terminal.

   Nota

   Para obter mais informações sobre depuração, consulte Diagnóstico de funções duráveis.

1. Para testar sua função, defina um ponto de interrupção no código da hello função de atividade. Selecione F5 ou selecione Depurar: Iniciar depuração na paleta de comandos para iniciar o projeto de aplicativo de função. A saída das Ferramentas Principais aparece no painel do terminal.

   Nota

   Para obter mais informações sobre depuração, consulte Diagnóstico de funções duráveis.

5. Use seu navegador ou uma ferramenta de teste HTTP para enviar uma solicitação HTTP POST para o ponto de extremidade URL.

   Substitua o último segmento pelo nome da função orquestradora (HelloOrchestrator). O URL deve ser semelhante a http://localhost:7071/api/orchestrators/HelloOrchestrator.

   A resposta é o resultado inicial da função HTTP. Ele permite que você saiba que a orquestração durável foi iniciada com sucesso. Ainda não exibe o resultado final da orquestração. A resposta inclui alguns URLs úteis. Por enquanto, consulte o status da orquestração.

6. Copie o valor do URL para statusQueryGetUri, cole-o na barra de endereço do navegador e execute a solicitação. Você também pode continuar a usar sua ferramenta de teste HTTP para emitir a solicitação GET.

   A solicitação consulta a instância de orquestração para obter o status. Você deve ver que a instância terminou e que inclui as saídas ou resultados da função durável. É semelhante a este exemplo:

   {
       "name": "HelloOrchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

5. Use seu navegador ou uma ferramenta de teste HTTP para enviar uma solicitação HTTP POST para o ponto de extremidade URL.

   Substitua o último segmento pelo nome da função orquestradora (HelloOrchestrator). O URL deve ser semelhante a http://localhost:7071/api/orchestrators/HelloOrchestrator.

   A resposta é o resultado inicial da função HTTP. Ele permite que você saiba que a orquestração durável foi iniciada com sucesso. Ainda não exibe o resultado final da orquestração. A resposta inclui alguns URLs úteis. Por enquanto, consulte o status da orquestração.

6. Copie o valor do URL para statusQueryGetUri, cole-o na barra de endereço do navegador e execute a solicitação. Você também pode continuar a usar sua ferramenta de teste HTTP para emitir a solicitação GET.

   A solicitação consulta a instância de orquestração para obter o status. Você deve ver que a instância terminou e que inclui as saídas ou resultados da função durável. É semelhante a este exemplo:

   {
       "name": "hello_orchestrator",
       "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
       "runtimeStatus": "Completed",
       "input": null,
       "customStatus": null,
       "output": [
           "Hello Tokyo!",
           "Hello Seattle!",
           "Hello London!"
       ],
       "createdTime": "2020-03-18T21:54:49Z",
       "lastUpdatedTime": "2020-03-18T21:54:54Z"
   }
   

1. Copie a URL do gatilho HTTP do painel de saída. A URL que chama sua função acionada por HTTP deve estar neste formato:

   https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

1. Copie a URL do gatilho HTTP do painel de saída. A URL que chama sua função acionada por HTTP deve estar neste formato:

   https://<functionappname>.azurewebsites.net/api/orchestrators/hello_orchestrator