Criar sua primeira função no portal do Azure

O Azure Functions lhe permite executar seu código em um ambiente sem servidor sem que seja preciso primeiro criar uma VM (máquina virtual) ou publicar um aplicativo Web. Neste artigo, você aprende a usar o Azure Functions para criar a função de gatilho por HTTP "Olá, Mundo" no portal do Azure.

Escolha sua linguagem de programação preferida na parte superior do artigo.

Observação

Atualmente, a edição do código da função C# no portal do Azure só é compatível com as funções do script C# (.csx). Para saber mais sobre as limitações na edição do código de função no portal do Azure, consulte Limitações de desenvolvimento no portal do Azure.

Em vez disso, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Visual Studio
• Visual Studio Code
• Terminal/prompt de comando

Observação

No momento, não há suporte para editar seu código de função Java no portal do Azure. Para obter mais informações, veja Limitações de desenvolvimento no portal do Azure.

Em vez disso, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Eclipse
• Gradle
• IntelliJ IDEA
• Maven
• Quarkus
• Spring Cloud
• Visual Studio Code

Observação

Devido às limitações de desenvolvimento no portal do Azure, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Observação

No momento, não há suporte para editar seu código de função TypeScript no portal do Azure. Para obter mais informações, veja Limitações de desenvolvimento no portal do Azure.

Em vez disso, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Observação

Devido às limitações de desenvolvimento no portal do Azure, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Observação

No momento, o desenvolvimento de funções Python no portal do Azure só é suportado quando executado em um Plano de consumo. Para obter mais informações, veja Limitações de desenvolvimento no portal do Azure.

Em vez disso, você deve desenvolver suas funções localmente e publicar em um aplicativo de funções no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local e o idioma escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Revise os problemas conhecidos quanto ao desenvolvimento do Azure Functions usando o Python no portal do Azure.

Pré-requisitos

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

Entrar no Azure

Entre no portal do Azure com sua conta do Azure.

Criar um aplicativo de funções

Você deve ter um aplicativo de funções para hospedar a execução de suas funções. Um aplicativo de funções lhe permite agrupar funções como uma unidade lógica para facilitar o gerenciamento, a implantação, o dimensionamento e o compartilhamento de recursos.

Use estas etapas para criar seu aplicativo de função e os recursos relacionados do Azure, independentemente de você poder ou não editar seu código no portal do Azure.

Para poder criar um aplicativo de script C# que você pode editar no portal, você deve escolher 6 (LTS) para a Versão .NET.

1. No menu do portal do Azure ou na Página inicial, selecione Criar um recurso.

2. Na página Novo, selecione Computação>Aplicativo de Funções.

3. Na página Informações básicas, use as configurações do aplicativo de funções conforme especificado na seguinte tabela:

   Configuração	Valor sugerido	Descrição
   Assinatura	Sua assinatura	A assinatura sob a qual você cria seu novo aplicativo de funções.
   Grupo de Recursos	myResourceGroup	Nome do novo grupo de recursos no qual você cria o aplicativo de funções. Você deve criar um novo grupo de recursos porque há limitações conhecidas ao criar novos aplicativos de funções em um grupo de recursos existente.
   Nome do aplicativo de funções	Nome globalmente exclusivo	Nome que identifica seu novo aplicativo de funções. Os caracteres válidos são a-z (não diferencia maiúsculas de minúsculas), 0-9 e -.
   Deseja implantar código ou imagem de contêiner?	Código	Opção para publicar arquivos de código ou um contêiner do Docker.
   Pilha de runtime	Linguagem preferencial	Escolha um runtime compatível com sua linguagem de programação de funções favorita. A edição no portal só está disponível para scripts JavaScript, PowerShell, Python v1, TypeScript e C#. A biblioteca de classes C# e as funções Java devem ser desenvolvidas localmente.
   Versão	Número de versão	Escolha a versão do seu runtime instalado.
   Região	Região preferencial	Selecione uma região perto de você ou perto de outros serviços que suas funções podem acessar.
   Sistema operacional	Windows	Um sistema operacional é pré-selecionado para você com base na seleção da pilha de runtime, mas você pode alterar a configuração, se necessário. Só há suporte para edição no portal no Windows. A publicação de contêiner só tem suporte no Linux.
   Opções e planos de hospedagem	Consumo (Sem servidor)	Plano de hospedagem que define como os recursos são alocados para seu aplicativo de funções. No plano Consumo padrão, os recursos são adicionados dinamicamente conforme exigido por suas funções. Nesta hospedagem sem servidor, você paga somente pelo tempo durante o qual suas funções são executadas. O plano Premium também oferece colocação em escala dinâmica. Quando você executa em um Plano do Serviço de Aplicativo, deve gerenciar o dimensionamento do aplicativo de funções.

4. Aceite as opções padrão de criação de uma nova conta de armazenamento na guia Armazenamento e uma nova instância do Application Insights na guia Monitoramento. Você também pode optar por usar uma conta de armazenamento existente ou uma instância do Application Insights.

5. Selecione Examinar + criar para examinar as configurações do aplicativo escolhidas e selecione Criar para provisionar e implantar o aplicativo de funções.

6. Selecione o ícone Notificações no canto superior direito do portal e veja se a mensagem Implantação concluída com êxito é exibida.

7. Selecione Ir para recursos para exibir o novo aplicativo de funções. Você também pode selecionar Fixar no painel. A fixação torna mais fácil retornar a esse recurso de aplicativo de função no seu painel.

   

Em seguida, crie uma função no novo aplicativo de funções.

Criar uma função de gatilho HTTP

1. No seu aplicativo de funções, selecione Visão gerale selecione + Criar em Funções. Se você não vir o botão + Criar, poderá criar suas funções localmente.

2. Em Selecione um modelo, role para baixo e escolha o modelo do Gatilho HTTP.

3. Em Detalhes do modelo, use HttpExample na Nova Função, selecione Anônimo na lista suspensa Nível de autorização e selecione Criar.

   O Azure cria a função de gatilho HTTP. Agora você pode executar a nova função enviando uma solicitação HTTP.

Crie suas funções localmente

Se você não conseguir criar seu código de função no portal, poderá criar um projeto local e publicar o código de função no seu novo aplicativo de funções.

1. No seu aplicativo de funções, selecione Visão Geral, em Criar funções no seu ambiente preferencial em Funções.

2. Escolha seu ambiente de desenvolvimento local preferido e siga as etapas no artigo vinculado para criar e publicar seu primeiro projeto do Azure Functions.

   Dica

   Ao publicar seu novo projeto, use o aplicativo de funções e os recursos relacionados que você acabou de criar.

Testar a função

Dica

A funcionalidade Código + Teste no portal funciona até mesmo para funções que são somente leitura e não podem ser editadas no portal.

1. No portal, localize a função disparada por HTTP no seu novo aplicativo de funções, selecione Código + Teste no menu à esquerda e selecione Obter URL da função no menu superior.

   

2. Na caixa de diálogo Obter URL da função, selecione padrão na lista suspensa e, em seguida, selecione o ícone Copiar para a área de transferência.

   

3. Cole a URL de função na barra de endereços do navegador. Adicione o valor da cadeia de caracteres de consulta ?name=<your_name> ao final desta URL e pressione ENTER para executar a solicitação. O navegador deverá exibir uma mensagem de resposta que retorna o valor da cadeia de consulta.

   Se a URL de solicitação incluiu uma chave de acesso (?code=...), isso significa que você selecionou Função em vez do nível de acesso Anônimo ao criar a função. Neste caso, você deve acrescentar &name=<your_name>.

4. Quando a função é executada, informações de rastreamento são gravadas nos logs. Para ver a saída do rastreamento, retorne à página Codificar + Testar no portal e expanda a seta Logs na parte inferior da página. Chame sua função novamente para ver a saída de rastreamento gravada nos logs.

   

Limpar os recursos

Outros inícios rápidos nessa coleção aproveitam esse início rápido. Se você planeja trabalhar com guias de início rápido subsequentes, tutoriais ou com qualquer serviço criado por você nesse início rápido, não limpe os recursos.

Os Recursos no Azure se referem a aplicativos de funções, funções, contas de armazenamento e assim por diante. Eles são agrupados em grupos de recursos e você pode excluir tudo junto ao excluir o grupo.

Você criou recursos para concluir esses guias de início rápido. Esses recursos podem ser cobrados, dependendo do status da sua conta e do preço do serviço. Caso não precise mais dos recursos, é possível excluí-los desta maneira:

1. No portal do Azure, vá até a página Grupo de recursos.

   Para acessar essa página por meio da página de aplicativo de funções, selecione a guia Visão geral e o link em Grupo de recursos.

   

   Para acessar essa página no painel, selecione Grupos de recursos, depois o grupo de recursos usado para este artigo.

2. Na página Grupo de recursos, examine a lista de recursos incluídos e verifique se eles são aqueles que deseja excluir.

3. Selecione Excluir grupo de recursos e siga as instruções.

   A exclusão pode levar alguns minutos. Ao ser concluída, uma notificação será exibida por alguns segundos. Também é possível selecionar o ícone de sino na parte superior da página para exibir a notificação.

Próximas etapas

Agora que você criou sua primeira função, vamos adicionar uma associação de saída à função, que grava uma mensagem em uma fila do Armazenamento.

Adicionar mensagens a uma fila do Armazenamento do Azure usando o Functions