Create your first function in the Azure portal (Criar a sua primeira função no portal do Azure)

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

Escolha a sua linguagem de programação preferida no topo do artigo.

Nota

Atualmente, a edição do código da função C# no portal do Azure só tem suporte para funções de script C# (.csx). Para saber mais sobre as limitações na edição de 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ção no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local escolhido:

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

Nota

Atualmente, não há suporte para a edição do código da função Java no portal do Azure. Para obter mais informações, 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ção no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local escolhido:

• Eclipse
• Gradle
• IntelliJ IDEIA
• Maven
• Quarkus
• Nuvem de primavera
• Visual Studio Code

Nota

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

• Visual Studio Code
• Terminal/prompt de comando

Nota

Atualmente, não há suporte para a edição do código da função TypeScript no portal do Azure. Para obter mais informações, 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ção no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Nota

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

• Visual Studio Code
• Terminal/prompt de comando

Nota

Atualmente, o desenvolvimento de funções Python no portal do Azure só é suportado quando executado em um plano de consumo. Para obter mais informações, 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ção no Azure. Use um dos links a seguir para começar a usar o ambiente de desenvolvimento local escolhido:

• Visual Studio Code
• Terminal/prompt de comando

Analise os problemas conhecidos para o desenvolvimento do Azure Functions usando Python no portal do Azure.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

Iniciar sessão no Azure

Inicie sessão no portal do Azure com a sua conta do Azure.

Criar uma aplicação de funções

Precisa de uma aplicação Function App para alojar a execução das suas funções. Um aplicativo de função 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 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 .NET Version.

1. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.

2. Na página Novo, selecione Aplicativo de função de computação>.

3. Na página Noções básicas, use as configurações do aplicativo de função conforme especificado na tabela a seguir:

   Definição	Valor sugerido	Description
   Subscrição	a sua subscrição	A subscrição ao abrigo da qual cria a sua nova aplicação funcional.
   Grupo de Recursos	myResourceGroup	Nome para o novo grupo de recursos no qual você cria seu aplicativo de função. Você deve criar um novo grupo de recursos porque há limitações conhecidas ao criar novos aplicativos de função em um grupo de recursos existente.
   Nome da Aplicação de Funções	Nome globalmente exclusivo	Nome que identifica a sua aplicação Function App nova. Os carateres válidos são a-z (não sensível a maiúsculas e 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	Idioma Preferencial	Escolha um tempo de execução que suporte a sua linguagem de programação de funções favorita. A edição no portal só está disponível para JavaScript, PowerShell, Python, TypeScript e script 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 tempo de execução instalado.
   Região	Região preferida	Selecione uma região perto de você ou perto de outros serviços que suas funções possam acessar.
   Sistema Operativo	Windows	Um sistema operacional é pré-selecionado para você com base na seleção da pilha de tempo de execução, mas você pode alterar a configuração, se necessário. A edição no portal só é suportada no Windows. A publicação de contêineres só é suportada no Linux.
   Opções e planos de hospedagem	Consumo (Sem servidor)	O plano de alojamento que define a forma como os recursos são alocados à sua aplicação de funções. No Plano de Consumo predefinido, os recursos são adicionados dinamicamente, conforme necessário por parte das suas funções. Nesta hospedagem sem servidor, você paga apenas pelo tempo em que suas funções são executadas. O plano Premium também oferece escalonamento dinâmico. Quando executa num plano do Serviço de Aplicações, tem de gerir o dimensionamento da sua aplicação 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 Insight na guia Monitoramento . Você também pode optar por usar uma conta de armazenamento existente ou uma instância do Application Insights.

5. Selecione Rever + criar para rever a configuração da aplicação que escolheu e, em seguida, selecione Criar para provisionar e implementar a aplicação funcional.

6. Selecione o ícone Notificações no canto superior direito do portal e observe a mensagem Implantação bem-sucedida .

7. Selecione Ir para o recurso para ver a sua nova aplicação de funções. Você também pode selecionar Fixar no painel. A fixação facilita o retorno a esse recurso de aplicativo funcional a partir do seu painel.

   

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

Criar uma função de gatilho HTTP

1. Na sua aplicação de funções, selecione Descrição Geral e, em seguida, selecione + Criar em Funções. Se não vir o botão + Criar , pode criar as suas funções localmente.

2. Em Selecione um modelo, role para baixo e escolha o modelo de gatilho HTTP.

3. Em Detalhes do modelo, use HttpExample para 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, pode enviar um pedido HTTP para executar a função nova.

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 em seu novo aplicativo de função.

1. No seu aplicativo de funções, selecione Visão geral e, em seguida, em Criar funções em seu ambiente preferido, 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.

   Gorjeta

   Ao publicar seu novo projeto, certifique-se de usar o aplicativo de função e os recursos relacionados que você acabou de criar.

Testar a função

Gorjeta

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

1. No portal, localize a função acionada HTTP no seu novo aplicativo de função, selecione Código + Teste no menu esquerdo e, em seguida, 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 selecione o ícone Copiar para área de transferência.

   

3. Cole o URL da função na barra de endereço do browser. Adicione o valor ?name=<your_name> da cadeia de caracteres de consulta ao final deste URL e pressione Enter para executar a solicitação. O navegador deve exibir uma mensagem de resposta que ecoe o valor da cadeia de caracteres de consulta.

   Se o URL do pedido incluísse uma chave de acesso (?code=...), significa que selecionou Função em vez do nível de acesso Anónimo ao criar a função. Nesse caso, você deve anexar &name=<your_name>.

4. Quando a sua função é executada, são escritas informações de rastreio nos registos. Para ver a saída de rastreamento, retorne à página Código + Teste 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.

   

Clean up resources (Limpar recursos)

Outros guias de introdução desta coleção têm por base este guia de introdução. Se você planeja trabalhar com inícios rápidos, tutoriais ou com qualquer um dos serviços criados neste início rápido, não limpe os recursos.

Os recursos no Azure referem-se a aplicações de funções, funções, contas de armazenamento e assim sucessivamente. Eles são agrupados em grupos de recursos e você pode excluir tudo em um grupo excluindo o grupo.

Você criou recursos para concluir esses inícios rápidos. Você pode ser cobrado por esses recursos, dependendo do status da sua conta e do preço do serviço. Se já não precisar dos recursos, pode eliminá-los da seguinte forma:

1. No portal do Azure, visite a página Grupo de recursos.

   Para aceder a essa página a partir da página da aplicação de funções, selecione o separador Descrição Geral e, em seguida, selecione a ligação em Grupo de recursos.

   

   Para aceder a essa página a partir do dashboard, selecione Grupos de recursos e, em seguida, selecione o grupo de recursos que utilizou para este artigo.

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

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

   A exclusão pode levar alguns minutos. Quando terminar, é apresentada uma notificação durante alguns segundos. Também pode selecionar o ícone de sino na parte superior da página para ver a notificação.

Próximos passos

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

Add messages to an Azure Storage queue using Functions (Utilizar as Funções para adicionar mensagens a uma fila do Armazenamento do Azure)