Criar uma função no portal do Azure executada segundo 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 agendamento definido por você.

Observação

A edição no portal só tem suporte para funções JavaScript, PowerShell e C# Script. A edição no portal do Python é suportada somente quando executada no plano de Consumo. Quando possível, você deve desenvolver suas funções localmente.

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.

Pré-requisitos

Para concluir este tutorial:

Verifique se você tem uma assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Criar um aplicativo de funções

  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.

    Screenshot of deployment notification.

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

Screenshot showing successful creation of the function app.

Criar uma função disparada por temporizador

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

    Screenshot of adding a function in the Azure portal.

  2. Em Selecionar um modelo, role para baixo e escolha o modelo de gatilho de timer.

    Screenshot of select the timer trigger page in the Azure portal.

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

    Screenshot that shows the New Function page with the Timer Trigger template selected.

    Configuração Valor sugerido Description
    Nome Padrão Define o nome da sua função disparada por temporizador.
    Agenda 0 */1 * * * * Uma expressão CRON de seis campos que agenda sua função para ser executada a cada minuto.

Testar a função

  1. Em sua função, selecione Codificar + Testar e expanda os Logs.

    Screenshot of the Test the timer trigger page in the Azure portal.

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

    Screenshot showing the View the timer trigger page in the Azure portal.

Agora você altera o agendamento da função para que ela seja executada uma vez por hora em vez de uma vez por minuto.

Atualizar o agendamento do temporizador

  1. Em sua função, selecione Integração. É aqui que você define as associações de entrada e saída de sua função e define o agendamento.

  2. Selecione Timer (myTimer) .

    Screenshot of Update the timer schedule page in the Azure portal.

  3. Atualize o valor de Agendamento para 0 0 */1 * * * e, em seguida, selecione Salvar.

    Screenshot of the Update function timer schedule page in the Azure portal.

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

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.

    Screenshot that shows select the resource group to delete from the function app page.

    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

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

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