Criar uma função no portal do Azure que é executada em uma agenda

  • Artigo

Saiba como usar o portal do Azure para criar uma função que é executada sem servidor no Azure com base em uma agenda que você definir.

Nota

A edição no portal só é suportada para funções JavaScript, PowerShell e C# Script. A edição Python no portal é suportada apenas quando executada no plano de consumo. Sempre que possível, deve desenvolver as suas funções localmente.

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.

Pré-requisitos

Para concluir este tutorial:

Certifique-se de que tem uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Criar uma aplicação de funções

  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. Em Selecione uma opção de hospedagem, selecione Consumo>Selecione para criar seu aplicativo no plano de consumo padrão. Nesta opção de 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. 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 -.
    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.

  5. Aceite as opções padrão nas guias restantes, incluindo o comportamento padrão de criar 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.

  6. 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.

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

  8. 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.

    Captura de tela da notificação de implantação.

Seu novo aplicativo de função está pronto para uso. Em seguida, você criará uma função no novo aplicativo de função.

Captura de tela mostrando a criação bem-sucedida do aplicativo de função.

Criar uma função acionada por temporizador

  1. Na sua aplicação de funções, selecione Descrição Geral e, em seguida, selecione + Criar em Funções.

    Captura de ecrã a mostrar a adição de uma função no portal do Azure.

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

    Captura de ecrã da seleção da página de gatilho do temporizador no portal do Azure.

  3. Em Detalhes do modelo, configure o novo gatilho com as configurações, conforme especificado na tabela abaixo da imagem, e selecione Criar.

    Captura de tela que mostra a página Nova Função com o modelo Gatilho de Timer selecionado.

    Definição Valor sugerido Description
    Nome Predefinido Define o nome da sua função acionada por temporizador.
    Schedule 0 */1 * * * * Uma expressão CRON de seis campos que agenda a função para ser executada todos os minutos.

Testar a função

  1. Na sua função, selecione Código + Teste e expanda os Logs.

    Captura de ecrã da página Testar o gatilho do temporizador no portal do Azure.

  2. Verifique a execução visualizando as informações gravadas nos logs.

    Captura de ecrã a mostrar a página Ver o gatilho do temporizador no portal do Azure.

Agora, altere a agenda da função, para que seja executada a cada hora, em vez de cada minuto.

Atualizar a agenda do temporizador

  1. Na sua função, selecione Integração. Aqui, você define as ligações de entrada e saída para sua função e também define o cronograma.

  2. Selecione Timer (myTimer).

    Captura de ecrã da página Atualizar a agenda do temporizador no portal do Azure.

  3. Atualize o valor Schedule para 0 0 */1 * * *e selecione Salvar.

    Captura de ecrã da página Atualizar agenda de temporizador de função no portal do Azure.

Agora você tem uma função que é executada uma vez a cada hora, na hora.

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.

    Captura de tela que mostra a seleção do grupo de recursos a ser excluído da página do aplicativo de função.

    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

Você criou uma função que é executada com base em uma agenda. Para obter mais informações sobre gatilhos de temporizador, consulte Agendar a execução de código com o Azure Functions.

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)