Início Rápido: criar um aplicativo JavaScript Durable Functions

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

• A extensão do Visual Studio Code Azure Functions versão 1.10.4 ou posterior instalada.

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

• Azure Functions 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 informações a seguir:

   Prompt	Ação	Descrição
   Selecione um idioma para o seu projeto de aplicativo de funções	Selecione JavaScript.	Cria um projeto local do Node.js Functions.
   Selecionar um modelo de programação JavaScript	Escolha 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 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	Ação	Descrição
   Selecione um idioma para o seu projeto de aplicativo de funções	Selecione JavaScript.	Cria um projeto local do Node.js Functions.
   Selecionar um modelo de programação JavaScript	Selecione Model 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 projeto	Selecione Ignorar por enquanto.
   Selecione como deseja abrir o 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 de visualização 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ções.

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ções.

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.
   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.
   Forneça um nome de função	Digite HelloOrchestrator.	Um nome para sua função durável.

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

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

Você adicionou a função de atividade Hello que é chamada pelo orquestrador. Abra Hello/index.js para ver que ele está aceitando 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 realizar alguma computação não determinística.

Por fim, adicione 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	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 ela 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 Durable Functions 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 no 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 um arquivo que tem uma orquestração de aplicativo de Durable Functions, uma função de atividade e uma função inicial 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.
   Forneça um nome de função	Digite olá.	O nome da sua função durável.

Abra src/functions/hello.ts para exibir as funções que você 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 função de atividade hello que é chamada pelo orquestrador. No mesmo arquivo, você pode ver que ela 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 realizar alguma computação não determinística.

Por fim, também foi adicionada uma função acionada por HTTP que inicia uma orquestração. No mesmo arquivo, você pode ver que ela 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 Durable Functions que pode ser executado localmente e implantado no Azure.

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

5. Use seu navegador ou uma ferramenta de teste para 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. 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 do status. Você deverá ver que a instância foi concluída e inclui as saídas ou resultados do aplicativo Durable Functions, como nesse 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 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 do aplicativo Durable Functions, como nesse 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 o URL do gatilho HTTP. A URL que chama sua função acionada por HTTP deve estar nesse formato:

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

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

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