Quickstart: Crie uma aplicação TypeScript Durable Functions

• A extensão Funções do Azure do Visual Studio Code foi instalada.

• A extensão Funções do Azure do Visual Studio Code, versão 1.10.4 ou posterior, está instalada.

• A versão mais recente do Funções do Azure Core Tools instalada.

• Funções do Azure Core Tools versão 4.0.5382 ou posterior instalada.

• Node.js versão 16.x+ instalada.

• Node.js versão 18.x+ instalada.

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

   Prompt	Action	Descrição
   Selecione um idioma para seu projeto de aplicativo de função	Selecione TypeScript.	Cria um projeto local Node.js Functions usando TypeScript.
   Selecione um modelo de programação JavaScript	Selecione Modelo V3.	Define o modelo de programação v3.
   Selecione uma versão	Selecione Funções do Azure 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.
   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 que selecionaste.

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

   Prompt	Action	Descrição
   Selecione um idioma para seu projeto de aplicativo de função	Selecione TypeScript.	Cria um projeto local Node.js Functions usando TypeScript.
   Selecione um modelo de programação JavaScript	Selecione Modelo V4.	Define o modelo de programação v4.
   Selecione uma versão	Selecione Funções do Azure 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.
   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 que selecionaste.

Função orquestradora

Usa um modelo para criar o código Durable Functions no seu projeto.

1. Na paleta de comandos, enter e depois selecione Funções do Azure: Criar Função.

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

   Prompt	Action	Descrição
   Selecione um modelo para a sua função	Selecione Durable Functions orchestrator.	Cria uma orquestração Durable Functions.
   Escolha um tipo de armazenamento durável	Selecione Armazenamento do Azure (Padrão).	Configura o back-end de armazenamento a utilizar na sua aplicação Durable Functions.
   Fornecer um nome de função	Insira HelloOrchestrator.	O nome da sua função.

Você adicionou um orquestrador para coordenar as funções de atividade. Abra o HelloOrchestrator/index.ts para ver a função do orquestrador. Cada chamada a context.df.callActivity invoca 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, enter e depois selecione Funções do Azure: Criar Função.

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

   Prompt	Action	Descrição
   Selecione um modelo para a sua função	Selecione atividade de Durable Functions.	Cria uma função de atividade.
   Fornecer um nome de função	Digite Olá.	Um nome para a sua função de atividade.

Você adicionou a função de atividade Hello que é invocada pelo orquestrador. Abre Hello/index.ts para veres que recebe um nome como entrada e responde com uma saudação. Uma função de atividade é onde você executa "o trabalho real" em seu fluxo de trabalho, como fazer uma chamada de banco de dados ou executar algum cálculo não determinístico.

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, enter e depois selecione Funções do Azure: Create Function.

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

   Prompt	Action	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	Selecione DurableFunctionsHttpStart.	O nome da sua função de atividade.
   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/index.ts para ver que ele usa client.startNew para iniciar uma nova orquestração. Em seguida, ele usa client.createCheckStatusResponse para retornar uma resposta HTTP contendo URLs que podem ser usadas para monitorar e gerenciar a nova orquestração.

Agora tens uma aplicação Durable Functions que podes executar localmente e implementar no Azure.

Um dos benefícios do modelo de programação v4 é a flexibilidade de onde você escreve suas funções. No modelo v4, você pode usar um único modelo para criar todas as três funções em um arquivo em seu projeto.

1. Na paleta de comandos, enter e depois selecione Funções do Azure: Criar Função.

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

   Prompt	Action	Descrição
   Selecione um modelo para a sua função	Selecione Durable Functions orchestrator.	Cria um ficheiro que tem uma orquestração da aplicação Durable Functions, uma função de atividade e uma função de início de cliente duradoura.
   Escolha um tipo de armazenamento durável	Selecione Armazenamento do Azure (Padrão).	Define o back-end de armazenamento a ser usado para sua função durável.
   Fornecer um nome de função	Digite Olá.	Um nome para a sua função durável.

Abra src/functions/hello.ts para visualizar as funções que criou.

Você criou um orquestrador chamado helloOrchestrator para coordenar funções de atividade. Cada chamada para context.df.callActivity invoca uma função de atividade chamada hello.

Você também adicionou a hello função de atividade que é invocada pelo orquestrador. No mesmo ficheiro, pode ver que recebe um nome como entrada e devolve uma saudação. Uma função de atividade é onde você executa "o trabalho real" em seu fluxo de trabalho, como fazer uma chamada de banco de dados ou executar algum cálculo não determinístico.

Finalmente, você adicionou uma função acionada por HTTP que inicia uma orquestração. No mesmo arquivo, você pode ver que ele usa client.startNew para iniciar uma nova orquestração. Em seguida, ele usa client.createCheckStatusResponse para retornar uma resposta HTTP contendo URLs que podem ser usadas para monitorar e gerenciar a nova orquestração.

Agora tens uma aplicação Durable Functions que podes executar localmente e implementar no Azure.

1. Para testar sua função, defina um ponto de interrupção no código da Hello função de atividade (em Olá/index.ts). 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.

   Observação

   Para mais informações sobre depuração, consulte diagnósticos do Durable Functions.

1. Para testar sua função, defina um ponto de interrupção no código da hello função de atividade (em src/functions/hello.ts). 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.

   Observação

   Para mais informações sobre depuração, consulte diagnósticos do Durable Functions.

5. Use o seu navegador ou uma ferramenta de teste HTTP para enviar um pedido HTTP POST ao endpoint 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 começou com sucesso. Ainda não exibe o resultado final da orquestração. A resposta inclui alguns URLs úteis. Por enquanto, verifique o estado da orquestração.

5. Use o seu navegador ou uma ferramenta de teste HTTP para enviar um pedido HTTP POST ao endpoint 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 começou com sucesso. Ainda não exibe o resultado final da orquestração. A resposta inclui alguns URLs úteis. Por enquanto, verifique o estado 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 o estado da instância de orquestração. 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"
   }
   

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 o estado da instância de orquestração. Verifique que a instância está concluída e que inclui os resultados da aplicação Durable Functions. É semelhante a este exemplo:

   {
       "name": "helloOrchestrator",
       "instanceId": "6ba3f77933b1461ea1a3828c013c9d56",
       "runtimeStatus": "Completed",
       "input": "",
       "customStatus": null,
       "output": [
           "Hello, Tokyo",
           "Hello, Seattle",
           "Hello, Cairo"
       ],
       "createdTime": "2023-02-13T23:02:21Z",
       "lastUpdatedTime": "2023-02-13T23:02:25Z"
   }
   

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