Início Rápido: Criar um aplicativo Python Durable Functions

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

   Prompt	Ação	Descrição
   Selecione um idioma para o seu projeto de aplicativo de funções	Selecione Python.	Cria um projeto local do Python Functions.
   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 do 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 projeto	Selecione Ignorar por enquanto.
   Selecione como deseja abrir o projeto	Selecione Abrir na janela atual.	Abre o Visual Studio Code na pasta selecionada.

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

   Prompt	Valor	Descrição
   Selecionar um idioma	Selecione Python (modelo de programação V2).	Cria um projeto local do Python Functions 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 do 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 deseja abrir o projeto	Selecione Abrir na janela atual.	Abre o Visual Studio Code na pasta selecionada.

Função de orquestrador

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: Criar Função.

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

   Prompt	Ação	Descrição
   Selecione um modelo para a função	Selecione Orquestrador de Durable Functions.	Cria uma orquestração de aplicativos de Durable Functions.
   Forneça um nome de função	Selecione HelloOrchestrator.	Um nome para sua função durável.

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

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

Função de atividade

1. Na paleta de comandos, insira e selecione Azure Functions: Criar Função.

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

   Prompt	Ação	Descrição
   Selecione um modelo para a função	Selecione atividade Durable Functions.	Cria uma função de atividade.
   Forneça um nome de função	Digite Olá.	O nome da sua função de atividade.

Você adicionou a função de atividade Hello que é chamada pelo orquestrador. Abra Hello/__init__.py para ver que ele aceita 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 realizar um cálculo.

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

Função de cliente (iniciador de HTTP)

1. Na paleta de comandos, insira e selecione Azure Functions: Criar Função.

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

   Prompt	Ação	Descrição
   Selecione um modelo para a função	Selecione Iniciador HTTP de Durable Functions.	Cria uma função inicial HTTP.
   Forneça um nome de função	Insira DurableFunctionsHttpStart.	O nome da sua função 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, ela 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 das Durable Functions 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 em execução localmente)
• azure-functions-durable v1.2.4+

Habilite o modelo de programação v2

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

• Nome: AzureWebJobsFeatureFlags
• Valor: EnableWorkerIndexing

Se você estiver executando localmente usando Azure Functions Core Tools, adicione essa configuração ao seu arquivo local.settings.json. Se você estiver executando no Azure, conclua essas 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 Durable Functions ​​usando esses três tipos de função, substitua o conteúdo de 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}"

Revise 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 de função de Hello atividade (em Hello/__init__.py). Selecione F5 ou selecione Debug: Start Debugging na paleta de comandos para iniciar o projeto do aplicativo de funções. A saída do Core Tools aparece no painel do terminal.

   Observação

   Para obter mais informações sobre depuração, veja Diagnóstico de Durable Functions.

1. Para testar a função, defina um ponto de interrupção no código da função de atividade hello. Selecione F5 ou selecione Debug: Start Debugging na paleta de comandos para iniciar o projeto do aplicativo de funções. A saída do Core Tools aparece no painel do terminal.

   Observação

   Para obter mais informações sobre depuração, veja Diagnóstico de Durable Functions.

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

   Substitua o último segmento pelo nome da função de orquestrador (HelloOrchestrator). A 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 êxito. Ainda não exibe o resultado final da orquestração. A resposta inclui algumas 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 seu 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 do status. Você deverá ver que a instância foi concluída e inclui as saídas ou resultados da função durável. Ele é 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 da URL.

   Substitua o último segmento pelo nome da função de orquestrador (HelloOrchestrator). A 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 êxito. Ainda não exibe o resultado final da orquestração. A resposta inclui algumas 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 seu 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 do status. Você deverá ver que a instância foi concluída e inclui as saídas ou resultados da função durável. Ele é 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 nesse 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 nesse formato:

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