Início Rápido: criar um aplicativo C# de Durable Functions

Neste artigo de início rápido, você usa o Visual Studio Code para criar e testar localmente um aplicativo Durable Functions "olá, mundo". O aplicativo de funções orquestrará e encadeará chamadas para outras funções. Em seguida, você publicará o código de função no Azure. As ferramentas que você usa estão disponíveis por meio da eextensão do Visual Studio Code.

Pré-requisitos

Para concluir este início rápido, você precisa de:

• O Visual Studio Code instalado.

• As seguintes extensões do Visual Studio Code instaladas:

  • Azure Functions
  • C#

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

• Uma assinatura do Azure. Para utilizar Durable Functions, tem de ter uma conta de Armazenamento do Azure.

• SDK do .NET Core versão 3.1 ou posterior instalada.

• Uma ferramenta de teste para HTTP que mantém seus dados seguros. Para obter mais informações, confira Ferramentas de teste para HTTP.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Criar um projeto do Azure Functions

O Visual Studio Code,criar um projeto localmente no Azure Functions.

1. No menu Exibir selecione menu Paleta de Comandos (ou selecione Ctrl+Shift+P).

2. No prompt (>), insira e selecione Azure Functions: Criar Novo Projeto.

   

3. Selecione Procurar. Na caixa de diálogo Selecionar pasta, vá para uma pasta a ser usada em seu projeto e escolha Selecionar.

4. Todos os prompts, selecione ou insira os valores a seguir:

   Prompt	Ação	Descrição
   Selecione um idioma para o seu projeto de aplicativo de funções	selecione C#.	Cria um projeto local do Functions em C#.
   Selecione uma versão	Selecione Azure Functions v4.	Você verá essa opção somente quando o Core Tools ainda não estiver instalado. O Core Tools é instalado na primeira vez que você executa o aplicativo.
   Selecionar um runtime do .NET	Selecione .NET 8.0 Isolado.	Cria um projeto de Funções que dá suporte ao .NET 8 em execução um processo de trabalho isolado e ao Azure Functions Runtime 4.0. Para obter mais informações, consulte Como direcionar para versões do Azure Functions runtime.
   Selecione um modelo para a primeira função do projeto	Selecione Orquestração de Durable Functions.	Cria uma orquestração de Durable Functions.
   Escolha um tipo de armazenamento durável	Selecione Armazenamento do Microsoft Azure.	O provedor de armazenamento padrão para Durable Functions. Para obter mais informações, consulte Provedores de Armazenamento do Durable Functions.
   Forneça um nome de função	Inserir HelloOrchestration.	Um nome para a função de orquestração.
   Forneça um namespace	Inserir Company.Function.	Um namespace da classe gerada.
   Selecione como deseja abrir o projeto	Selecione Abrir na janela atual.	Abre o Visual Studio Code na pasta selecionada.

O Visual Studio Code instala o Azure Functions Core Tools se for necessário para criar o projeto. Ele também cria o projeto de aplicativo de funções em uma pasta. Este projeto contém os arquivos de configuração host.json e local.settings.json.

Outro arquivo, HelloOrchestration.cs, contém os blocos de construção básicos de um aplicativo Durable Functions:

Para obter mais informações sobre essas funções, consulte Tipos e recursos da Durable Functions.

Configurar o armazenamento

Use o Azurite,um emulador para o Armazenamento do Microsoft Azure, para testar a função localmente. Em local.settings.json, defina o valor de AzureWebJobsStorage para UseDevelopmentStorage=true como neste exemplo:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
  }
}

Para instalar e começar a executar a extensão do Azurite no Visual Studio Code, na paleta de comandos, insira Azurite: Iniciar e selecionar Enter.

Você pode usar outras opções de armazenamento no seu aplicativo Durable Functions. Para obter mais informações sobre opções de armazenamento e benefícios, consulte provedores de armazenamento de Durable Functions.

Testar a função localmente

As Azure Functions Core Tools oferecem a capacidade de executar um projeto do Azure Functions em seu computador de desenvolvimento local. Você será solicitado a instalar essas ferramentas na primeira vez que iniciar uma função no Visual Studio Code.

1. No Visual Studio Code, defina um ponto de interrupção no código da função de atividade SayHello e então selecione F5 para iniciar o projeto do aplicativo de funções. O painel Terminal exibirá saída do Core Tools.

   Observação

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

   Se a mensagemNenhuma função de trabalho encontrada, aparece atualizar sua instalação do Azure Functions Core Tools para a versão mais recente.

2. No painel do terminal, copie o ponto de extremidade da URL da sua função acionada por HTTP.

   

3. Use uma ferramenta de teste HTTP para enviar uma solicitação HTTP POST ao ponto de extremidade da URL.

   A resposta é o resultado inicial da função HTTP. Ela informa que o aplicativo da Durable Functions foi iniciada com sucesso. Ainda não exibe o resultado final da orquestração. A resposta inclui algumas URLs úteis.

   Neste ponto, o ponto de interrupção na função de atividade deve ser atingido porque a orquestração foi iniciada. Percorra-o para obter uma resposta para o status da orquestração.

4. 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 a 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":"HelloCities",
       "instanceId":"7f99f9474a6641438e5c7169b7ecb3f2",
       "runtimeStatus":"Completed",
       "input":null,
       "customStatus":null,
       "output":"Hello, Tokyo! Hello, London! Hello, Seattle!",
       "createdTime":"2023-01-31T18:48:49Z",
       "lastUpdatedTime":"2023-01-31T18:48:56Z"
   }
   

   Dica

   Saiba como você pode observar o comportamento de reprodução de um aplicativo Durable Functions por meio de pontos de interrupção.

5. Para interromper a depuração, no Visual Studio Code, selecione Shift+F5.

Depois de verificar se a função funciona corretamente no seu computador local, é hora de publicar o projeto no Azure.

Entrar no Azure

Antes de criar recursos do Azure ou publicar o aplicativo, entre no Azure.

1. Se ainda não estiver conectado, selecione o ícone do Azure na barra de Atividades. Em seguida, em Recursos, selecione Entrar no Azure.

   

   Se você já estiver conectado e puder ver suas assinaturas existentes, vá para a próxima seção. Se ainda não tiver uma conta do Azure, selecione Criar uma Conta do Azure. Os alunos podem selecionar Criar uma Conta do Microsoft Azure for Students.

2. Quando for solicitado no navegador, selecione sua conta do Azure e entre usando as credenciais da sua conta do Azure. Se você criar uma conta, poderá se conectar depois que a conta for criada.

3. Após fazer login com sucesso, você poderá fechar a nova janela do navegador. As assinaturas que pertencem à sua conta do Azure são exibidas na barra lateral.

Criar o aplicativo de funções no Azure

Nesta seção, você criará um aplicativo de funções e os recursos relacionados na sua assinatura do Azure. Muitas das decisões de criação de recursos são tomadas para você com base em comportamentos padrão. Para mais controle sobre os recursos criados, você deve criar seu aplicativo de função com opções avançadas.

1. No Visual Studio Code, pressione F1 para abrir a paleta de comandos. No prompt (>), insira e, em seguida, selecione Azure Functions: Criar Aplicativo de Funções no Azure.

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

   Prompt	Ação
   Selecionar uma assinatura	Selecione a Assinatura do Azure a ser usada. O prompt não aparece quando você tem apenas uma assinatura visível em Recursos.
   Insira um nome exclusivo globalmente para o aplicativo de funções	Digite um nome que seja válido em um caminho de URL. O nome que você digitar será validado para garantir que seja exclusivo no Azure Functions.
   Selecionar uma pilha de runtime	Selecione a versão da linguagem que você executa localmente no momento.
   Selecione uma localização para novos recursos	Selecionar uma Região do Azure. Para obter um melhor desempenho, escolha uma região perto de você.

   No painel Azure: Log de Atividades, a extensão do Azure mostra o status dos recursos individuais à medida que são criados no Azure.

   

3. Quando o aplicativo de funções é criado, os seguintes recursos relacionados são criados na sua assinatura do Azure. Os recursos são nomeados com base no nome que você inseriu para o seu aplicativo de funções.

   • Um grupo de recursos, que é um contêiner lógico para recursos relacionados.
   • Uma conta de armazenamento do Azure padrão, que mantém o estado e outras informações sobre seus projetos.
   • Um aplicativo de funções, que fornece o ambiente para a execução do código de função. Um aplicativo de funções lhe permite agrupar funções como uma unidade lógica para facilitar o gerenciamento, a implantação e o compartilhamento de recursos dentro do mesmo plano de hospedagem.
   • Um plano do Serviço de Aplicativo do Azure, que define o host subjacente do seu aplicativo de funções.
   • Uma instância do Application Insights conectada ao aplicativo de funções que acompanha o uso das suas funções no aplicativo.

   Uma notificação é exibida depois que seu aplicativo de funções é criado e o pacote de implantação é aplicado.

   Dica

   Por padrão, os recursos do Azure exigidos por seu aplicativo de funções são criados com base no nome que você inseriu para o seu aplicativo de funções. Por padrão, os recursos são criados com o aplicativo de funções no mesmo novo grupo de recursos. Para personalizar os nomes dos recursos associados ou reutilizar os recursos existentes, publique o projeto com opções avançadas de criação.

Implantar o projeto no Azure

1. Na paleta de comandos, insira e, em seguida, selecione Azure Functions: Implantar no Aplicativo de Funções.

2. Selecione o aplicativo de funções que você acabou de criar. Quando solicitado sobre a substituição de implantações anteriores, selecione Implantar para implantar seu código de função no novo recurso do aplicativo de funções.

3. Após sua implantação ser concluída, escolha Ver o resultado para ver os resultados da criação e da implantação, incluindo os recursos do Azure que você criou. Se você deixou passar a notificação, selecione o ícone de sino no canto inferior direito para vê-la novamente.

   

Testar sua função no Azure

1. No painel de saída do Visual Studio Code, copie o URL do gatilho HTTP. A URL que chama a função disparada por HTTP precisa estar no seguinte formato:

   https://<function-app-name>.azurewebsites.net/api/HelloOrchestration_HttpStart

2. Cole o novo URL da solicitação HTTP na barra de endereço do seu navegador. Você consegue a mesma resposta de status que obteve quando testou localmente quando usa o aplicativo publicado.

O aplicativo C# Durable Functions que você criou e publicou usando o Visual Studio Code está pronto para uso.

Limpar os recursos

Se já não precisar dos recursos que criou para concluir o arranque rápido, para evitar custos relacionados na sua subscrição do Azure, elimine o grupo de recursos e todos os recursos relacionados.

Conteúdo relacionado

• Saiba mais sobre padrões comuns de aplicativos de Durable Functions.

Neste artigo de início rápido, você usa o Visual Studio 2022 para criar e testar localmente um aplicativo Durable Functions "olá, mundo". Essas funções orquestrará e encadeará chamadas para outras funções. Em seguida, você publicará o código de função no Azure. As ferramentas que você usar estão disponíveis via a carga de trabalho de desenvolvimento do Azure no Visual Studio 2022.

Pré-requisitos

Para concluir este início rápido, você precisa de:

• Visual Studio 2022 instalado.

  Garanta que a carga de trabalho de desenvolvimento do Azure também seja instalada. O Visual Studio 2019 também dá suporte ao desenvolvimento de Durable Functions, mas a interface do usuário e as etapas são diferentes.

• O emulador de Azurite instalado e em execução.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Crie um projeto de aplicativo de funções

O modelo do Azure Functions cria um projeto que pode publica em um aplicativo de funções no Azure. Você pode usar um aplicativo de funções para as funções do grupo como uma unidade lógica para gerenciamento mais fácil, implantar escala e compartilhar recursos.

1. No Visual Studio, no menu Arquivo, selecione Novo>Projeto.

2. Em Criar um projeto, procure por functions, selecione o modelo Azure Functions, e depois selecione Avançar.

   

3. Para Nome do projeto insira um nome para seu projeto,e depois selecione OK. O nome do projeto precisa ser válido como um namespace do C#. Portanto, não use sublinhados, hifens ou caracteres não alfanuméricos.

4. Em Informações adicionais, use as configurações descritas na próxima tabela.

   

   Configuração	Ação	Descrição
   Função de trabalho do Functions	Selecione .NET 8 Isolado (suporte de longo prazo).	Cria um projeto do Azure Functions que dá suporte ao .NET 8 em execução no processo de trabalho isolado e ao Azure Functions Runtime 4.0. Para obter mais informações, consulte Como direcionar a versão do Azure Functions runtime.
   Função	Insira Orquestração do Durable Functions.	Cria uma orquestração de Durable Functions.

   Observação

   Se isolado (suporte de longo prazo) do .NET 8 não aparecer no menu trabalho do Functions, talvez você não tenha os conjuntos de ferramentas e modelos mais recentes do Azure Functions. Acesse as Ferramentas>Opções>Projetos e Soluções>Azure Functions>Verifique se há atualizações para baixar as atualizações mais recentes.

5. Para usar o emulador do Azurite, verifique se o usar o Azurite para a conta de armazenamento de runtime (AzureWebJobStorage) caixa de seleção está selecionada. Para criar um projeto de função usando um modelo de orquestração do Durable Functions, selecione Criar. Estes projetos têm os arquivos de configuração básicos necessários que você precisa para executar suas funções.

   Observação

   Você pode escolher outras opções de armazenamento no seu aplicativo Durable Functions. Para obter mais informações, consulte Provedores de Armazenamento do Durable Functions.

Na pasta do aplicativo, um arquivo chamado Function1.cs contém três funções. As três funções são os blocos de construção básicos de um aplicativo Durable Functions:

Para obter mais informações sobre essas funções, consulte Tipos e recursos da Durable Functions.

Testar a função localmente

As Azure Functions Core Tools oferecem a capacidade de executar um projeto do Azure Functions em seu computador de desenvolvimento local. Você será solicitado a instalar essas ferramentas na primeira vez que iniciar uma função no Visual Studio Code.

1. No Visual Studio Code, defina um ponto de interrupção no código SayHello de função e então selecione F5. Se solicitado, aceite a solicitação do Visual Studio para baixar e instalar as ferramentas Azure Functions Core (linha de comando). Além disso, talvez seja necessário habilitar uma exceção de firewall para que as ferramentas possam manipular solicitações HTTP.

   Observação

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

2. Copie a URL da sua função da saída do Azure Functions runtime.

   

3. Cole a URL da solicitação HTTP na barra de endereços do navegador e execute a solicitação. A captura de tela a seguir mostra a resposta no navegador à solicitação GET local retornada no navegador:

   

   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.

   Neste ponto, o ponto de interrupção na função de atividade deve ser atingido porque a orquestração começou. Percorra-o para obter uma resposta para o status da orquestração.

4. Copie o valor do URL para statusQueryGetUri, cole-o na barra de endereço do seu navegador e execute a solicitação.

   A solicitação consulta a instância de orquestração do status. Você deve ver que a instância foi concluída e inclui as saídas ou resultados do durable functions, como neste exemplo:

   {
       "name":"HelloCities",
       "instanceId":"668814ac6ce84a43a9e6757f81dbc0bc",
       "runtimeStatus":"Completed",
       "input":null,
       "customStatus":null,
       "output":"Hello, Tokyo! Hello, London! Hello Seattle!",
       "createdTime":"2023-01-31T16:44:34Z",
       "lastUpdatedTime":"2023-01-31T16:44:37Z"
   }
   

   Dica

   Saiba como você pode observar o comportamento de reprodução de um aplicativo Durable Functions por meio de pontos de interrupção.

5. Para interromper a depuração, selecione Shift+F5.

Depois de verificar se a função funciona corretamente no seu computador local, é hora de publicar o projeto no Azure.

Publicar o projeto no Azure

Você deve ter um aplicativo de funções em sua assinatura do Azure antes de publicar seu projeto. Você pode criar um aplicativo de funções no Visual Studio.

1. No Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e selecione Publicar. Em Destino, selecione Azure e, em seguida, selecione Próximo.

   

2. Em Destino específico, selecione Aplicativo de Funções do Azure (Windows). Um aplicativo de funções executado no Windows é criado. Selecione Avançar.

   

3. Na instância do Functions, selecione Criar uma nova função do Azure.

   

4. Crie uma nova instância usando os valores especificados na tabela a seguir:

   Configuração	Valor	Descrição
   Nome	Nome globalmente exclusivo	Nome que identifica seu novo aplicativo de funções de forma exclusiva. Aceite esse nome ou insira um novo nome. Os caracteres válidos são: a-z, 0-9 e -.
   Assinatura	Sua assinatura	A assinatura do Azure a utilizar. Aceite esta assinatura ou selecione uma nova na lista suspensa.
   Grupo de recursos	Nome do seu grupo de recursos	O grupo de recursos no qual você deseja criar o aplicativo de funções. Selecione Novo para criar um novo grupo de recursos. Você também pode optar por usar um grupo de recursos existente na lista suspensa.
   Tipo de Plano	Consumo	Quando você publica seu projeto em um aplicativo de funções executado em um Plano de consumo, você paga apenas pelas execuções do seu aplicativo de funções. Outros planos de hospedagem incorrem em custos mais altos.
   Localidade	Local do serviço de aplicativo	Selecione um Local em uma região do Azure perto de você ou de outros serviços acessados pelas suas funções.
   Armazenamento do Azure	Conta de armazenamento para uso geral	Uma conta de armazenamento do Azure é requerida pelo runtime do Functions. Selecione Novo para configurar uma conta de armazenamento para uso geral. Você também pode optar por usar uma conta existente que atenda aos requisitos da conta de armazenamento.
   Application Insights	Instância do Application Insights	Você deve habilitar a integração do Azure Application Insights para o seu aplicativo de funções. Selecione Novo para criar uma nova instância, em um workspace novo ou em um workspace do Log Analytics existente. Você também pode optar por usar uma instância existente.

   

5. Selecione Criar para criar um aplicativo de funções e recursos relacionados no Azure. O status da criação de recursos é mostrado no canto inferior esquerdo da janela.

6. Na instância do Functions, certifque-se de que a caixa de seleção Executar a partir do arquivo de pacote esteja selecionada. Seu aplicativo de funções é implantado usando a Implantação Zip com o modo Run-From-Package habilitado. A Implantação Zip é o método de implantação recomendado para o seu projeto de funções para melhorar o desempenho.

   

7. Selecione Concluir e, no painel Publicar, selecione Publicar para implantar o pacote que contém os seus arquivos de projeto em seu novo aplicativo de funções no Azure.

   Quando a implantação é concluída, a URL raiz do aplicativo de funções no Azure é mostrada na guia Publicar.

8. Na guia Publicar, na seção Hospedagem, selecione Abrir no portal do Azure. O novo recurso de aplicativo de funções do Azure é aberto no portal do Azure.

   

Testar sua função no Azure

1. Na página Perfil de publicação, copie a URL base do aplicativo de funções. Substitua a parte localhost:port da URL que você usou quando testou a função localmente pela nova URL base.

   A URL que chama o gatilho HTTP da função durável precisa estar no seguinte formato:

   https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>_HttpStart

2. Cole o novo URL da solicitação HTTP na barra de endereço do seu navegador. Quando você testou o aplicativo publicado, você pode esperar obter a mesma resposta de status que obteve quando testou localmente.

O aplicativo C# Python Durable Functions que você criou e publicou usando o Visual Studio está pronto para uso.

Limpar os recursos

Se já não precisar dos recursos que criou para concluir o arranque rápido, para evitar custos relacionados na sua subscrição do Azure, elimine o grupo de recursos e todos os recursos relacionados.

Conteúdo relacionado

• Saiba mais sobre padrões comuns de aplicativos de Durable Functions.