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

• A extensão do Visual Studio Code Azure Functions instalada.

• A extensão de código do Visual Studio Azure Functions versão 1.10.4 ou posterior instalada.

• A versão mais recente do Azure Functions Core Tools instalada.

• Ferramentas Principais do Azure Functions versão 4.0.5382 ou posterior instaladas.

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

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

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 JavaScript.	Cria um projeto local do Node.js Functions.
   Selecione um modelo de programação JavaScript	Selecione Modelo V3.	Define o modelo de programação v3.
   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.
   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	Ação	Descrição
   Selecione um idioma para seu projeto de aplicativo de função	Selecione JavaScript.	Cria um projeto local do Node.js Functions.
   Selecione um modelo de programação JavaScript	Selecione Modelo V4.	Escolha o modelo de programação v4.
   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.
   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.

Para usar o modelo de programação v4, instale a versão preview v3.x da biblioteca de funções duráveis.

2. Instale o pacote npm de funções duráveis executando npm install durable-functions no diretório raiz do aplicativo de função.

2. Instale a versão de visualização do pacote npm de funções duráveis executando npm install durable-functions@preview no diretório raiz do aplicativo de função.

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.
   Escolha um tipo de armazenamento durável	Selecione Armazenamento do Azure (padrão).	Seleciona o back-end de armazenamento usado para seu aplicativo Durable Functions.
   Fornecer um nome de função	Digite HelloOrchestrator.	Um nome para a sua função durável.

Você adicionou um orquestrador para coordenar as funções de atividade. Abra o HelloOrchestrator/index.js para ver a função do orquestrador. Cada chamada para context.df.callActivity invocar uma função de atividade chamada Hello.

Em seguida, adicione 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á.	Um nome para a sua função durável.

Você adicionou a Hello função de atividade que é invocada pelo orquestrador. Abra Olá/index.js para ver que ele está tomando um nome como entrada e retornando 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, adicione 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 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.js para ver que ele usa client.startNew para iniciar uma nova orquestração. Em seguida, ele usa client.createCheckStatusResponse para retornar uma resposta HTTP que contém URLs que você pode usar 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.

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, 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 um arquivo que tem uma orquestração de aplicativo Durable Functions, uma função de atividade e uma função de inicialização de cliente durável.
   Escolha um tipo de armazenamento durável	Selecione Armazenamento do Azure (padrão).	Define o back-end de armazenamento a ser usado para seu aplicativo Durable Functions.
   Fornecer um nome de função	Digite hello.	O nome da sua função durável.

Abra src/functions/hello.js 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 invocar uma função de atividade chamada hello.

Você também adicionou a hello função de atividade que é invocada pelo orquestrador. No mesmo arquivo, você pode ver que ele está tomando um nome como entrada e retornando 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, também foi adicionada 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 que contém URLs que você pode usar 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.

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

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 começou 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. Como alternativa, 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 do aplicativo Durable Functions, como neste 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 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 do aplicativo Durable Functions, como neste 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. No painel de saída, copie a URL do gatilho HTTP. A URL que chama sua função acionada por HTTP deve estar neste formato:

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

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

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