Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
WebJobs é um recurso do Serviço de Aplicativo do Azure que permite executar um programa ou script na mesma instância de um aplicativo Web. Todos os planos do Serviço de Aplicativo suportam WebJobs sem custo extra. Este tutorial guia-o na criação de um WebJob programado (acionado) usando a sua pilha de desenvolvimento preferida.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Um aplicativo .NET 9 existente do App Service.
- Sempre ativado deve estar ativado em seu aplicativo.
- Para contêineres do Windows e todos os aplicativos Linux, verifique se a configuração
WEBSITE_SKIP_RUNNING_KUDUAGENTdo aplicativo está definida comofalse.
Preparar o WebJob localmente
Nesta etapa, você cria um projeto .NET WebJob básico e navega até a raiz do projeto.
dotnet new console -n webjob –framework net9.0 cd webjobEm seguida, substitua
Program.cspelo seguinte código que grava a hora atual no console:using System; class Program { static void Main() { DateTimeOffset now = DateTimeOffset.Now; Console.WriteLine("Current time with is: " + now.ToString("hh:mm:ss tt zzz")); } }A partir do diretório webjob , execute o webjob para confirmar que a hora atual é de saída para o console:
dotnet runDeverá ver um resultado similar ao seguinte:
Current time with is: 07:53:07 PM -05:00Depois de confirmar que a aplicação funciona, compile-a e navegue até o diretório superior:
(Apenas Linux) Na raiz do projeto, crie um
run.shcom o seguinte código para executar o executável compilado:#!/bin/bash ./webjobAgora empacote os arquivos em um .zip como mostrado no comando a seguir:
Criar um WebJob agendado no Azure
No portal do Azure, vá para a página Serviço de Aplicativo do seu aplicativo do Serviço de Aplicativo.
No painel esquerdo, selecione WebJobs e, em seguida, selecione Adicionar.
Preencha as configurações Adicionar WebJob conforme especificado na tabela e selecione Criar Webjob. Para Upload de Arquivo, certifique-se de selecionar o arquivo .zip que você criou ou baixou anteriormente.
Configurações valor Descrição Nome Emprego na Web O nome do WebJob. Deve começar com uma letra ou um número e não deve conter caracteres especiais além de "-" e "_". Upload de arquivo webjob.zip O arquivo .zip que contém o arquivo executável ou de script. Os tipos de ficheiro suportados estão listados na secção Tipos de ficheiro suportados . Tipo Acionado Especifica quando o WebJob é executado: Contínuo ou Acionado. Acionadores Programado Programado ou Manual. Certifique-se de que Always on está ativado para que a agenda funcione de forma confiável. Expressão CRON 0 0/1 * * * * Para este início rápido, usamos um cronograma que corre a cada minuto. Consulte as expressões CRON para saber mais sobre a sintaxe. O novo WebJob aparece na página WebJobs . Se vir uma mensagem a dizer que o WebJob foi adicionado, mas não a vê, selecione Atualizar.
O WebJob agendado é executado no cronograma definido pela expressão CRON.
WebJobs é um recurso do Serviço de Aplicativo do Azure que permite executar um programa ou script na mesma instância de um aplicativo Web. Todos os planos de serviço de aplicativo suportam WebJobs sem custo extra. Este exemplo usa um WebJob agendado (acionado) para gerar a hora do sistema uma vez a cada minuto.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Um aplicativo Linux Python existente.
- Sempre ativado deve estar ativado em seu aplicativo.
- Verifique se a configuração
WEBSITE_SKIP_RUNNING_KUDUAGENTdo aplicativo está definida comofalse.
Preparar o exemplo de WebJob
Faça o download do projeto de exemplo pré-construído para começar rapidamente. O exemplo inclui o arquivo
webjob.py, que envia a hora atual para o console, conforme mostrado abaixo:import datetime current_datetime = datetime.datetime.now() print(current_datetime) # Output: 2025-03-27 10:27:21.240752Extraia o arquivo zip baixado e, em seguida, crie um novo arquivo zip contendo apenas o
webjob.pyarquivo (sem qualquer diretório pai). WebJobs requer que o executável ou script esteja na raiz do arquivo zip.
Criar um WebJob agendado
No portal do Azure, vá para a página Serviço de Aplicativo do seu aplicativo do Serviço de Aplicativo.
No painel esquerdo, selecione WebJobs e, em seguida, selecione Adicionar.
Preencha as configurações Adicionar WebJob conforme especificado na tabela e selecione Criar Webjob. Para Carregar Ficheiro, certifique-se de selecionar o ficheiro .zip criado anteriormente na seção Preparar WebJob de exemplo.
Configurações valor Description Nome Emprego na Web O nome do WebJob. Deve começar com uma letra ou um número e não deve conter caracteres especiais além de "-" e "_". Upload de arquivo webjob.zip O ficheiro .zip que contém webjob.pyno nível raiz. Os tipos de ficheiro suportados estão listados na secção Tipos de ficheiro suportados .Tipo Acionado Especifica quando o WebJob é executado: Contínuo ou Acionado. Acionadores Programado Programado ou Manual. Certifique-se de que Always on está ativado para que a agenda funcione de forma confiável. Expressão CRON 0 0/1 * * * * Para este início rápido, usamos um cronograma que corre a cada minuto. Consulte as expressões CRON para saber mais sobre a sintaxe. O novo WebJob aparece na página WebJobs . Se vir uma mensagem a dizer que o WebJob foi adicionado, mas não a vê, selecione Atualizar.
O WebJob agendado é executado no cronograma definido pela expressão CRON.
WebJobs é um recurso do Serviço de Aplicativo do Azure que permite executar um programa ou script na mesma instância de um aplicativo Web. Todos os planos de serviço de aplicativo suportam WebJobs sem custo extra. Este exemplo usa um WebJob agendado (acionado) para gerar a hora do sistema uma vez a cada minuto.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Uma app Node.js existente do Serviço de Aplicações.
- Sempre ativado deve estar ativado em seu aplicativo.
- Para Linux, verifique se a configuração
WEBSITE_SKIP_RUNNING_KUDUAGENTdo aplicativo está definida comofalse.
Preparar o exemplo WebJob
Faça o download do projeto de exemplo pré-construído para começar rapidamente. O exemplo inclui um arquivo
webjob.jsJavaScript, que envia a hora atual para o console, conforme mostrado abaixo:// Import the 'Date' object from JavaScript const currentTime = new Date(); // Format the time as a string const formattedTime = currentTime.toLocaleTimeString(); // Output the formatted time to the console console.log(`Current system time is: ${formattedTime}`);Extraia o arquivo zip baixado e, em seguida, crie um novo arquivo zip contendo apenas o
webjob.jsarquivo (sem qualquer diretório pai). WebJobs requer que o executável ou script esteja na raiz do arquivo zip.
Criar um WebJob agendado
No portal do Azure, vá para a página Serviço de Aplicativo do seu aplicativo do Serviço de Aplicativo.
No painel esquerdo, selecione WebJobs e, em seguida, selecione Adicionar.
Preencha as configurações Adicionar WebJob conforme especificado na tabela e selecione Criar Webjob. Para o Carregamento de Ficheiro, certifique-se de selecionar o ficheiro .zip criado anteriormente na secção Preparar o WebJob de exemplo.
Configurações valor Description Nome Emprego na Web O nome do WebJob. Deve começar com uma letra ou um número e não deve conter caracteres especiais além de "-" e "_". Upload de arquivo webjob.zip O ficheiro.zip que contém webjob.jsao nível da raiz. Os tipos de ficheiro suportados estão listados na secção Tipos de ficheiro suportados .Tipo Acionado Especifica quando o WebJob é executado: Contínuo ou Acionado. Acionadores Programado Programado ou Manual. Certifique-se de que Always on está ativado para que a agenda funcione de forma confiável. Expressão CRON 0 0/1 * * * * Para este início rápido, usamos um cronograma que corre a cada minuto. Consulte as expressões CRON para saber mais sobre a sintaxe. O novo WebJob aparece na página WebJobs . Se vir uma mensagem a dizer que o WebJob foi adicionado, mas não a vê, selecione Atualizar.
O WebJob agendado é executado no cronograma definido pela expressão CRON.
WebJobs é um recurso do Serviço de Aplicativo do Azure que permite executar um programa ou script na mesma instância de um aplicativo Web. Todos os planos de serviço de aplicativo suportam WebJobs sem custo extra. Este exemplo usa um WebJob agendado (acionado) para gerar a hora do sistema uma vez a cada minuto.
Importante
WebJobs não são suportados em contêineres Linux personalizados baseados no Alpine Linux, incluindo aplicativos Linux usando pilhas de tempo de execução Java 8 e Java 11. A partir dos aplicativos Java 17 Linux, o Serviço de Aplicativo do Azure usa imagens não baseadas em Alpinos, que são compatíveis com WebJobs.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Uma aplicação Java existente no App Service.
- Plug-in Maven para Aplicativos Web do Serviço de Aplicativo do Azure.
- Sempre ativado deve estar ativado em seu aplicativo.
- Verifique se a configuração
WEBSITE_SKIP_RUNNING_KUDUAGENTdo aplicativo está definida comofalse.
Preparar o WebJob
Faça o download do exemplo Java WebJob. Você construirá um arquivo usando o
.JARMaven. O projeto Java localizado emproject/src/main/java/webjob/HelloWorld.javaproduz uma mensagem e a hora atual para o console.import java.time.LocalDateTime; public class HelloWorld { public static void main(String[] args) { System.out.println("------------------------------------------------------------"); System.out.println("Hello World from WebJob: " + LocalDateTime.now()); System.out.println("------------------------------------------------------------"); } }Construa e empacote o projeto Java para produzir o executável
.jarexecutando os seguintes comandos doproject/diretório:mvn install mvn packageOs arquivos jar serão localizados em
project/target/webjob-artifact-1.0.0.jarapós uma compilação bem-sucedida.Empacote o
project/target/webjob-artifact-1.0.0.jarcomo um.ziparquivo.zip webjob.zip project/target/webjob-artifact-1.0.0.jar
Criar um WebJob agendado no Azure
No portal do Azure, vá para a página Serviço de Aplicativo do seu aplicativo do Serviço de Aplicativo.
No painel esquerdo, selecione WebJobs e, em seguida, selecione Adicionar.
Preencha as configurações Adicionar WebJob conforme especificado na tabela e selecione Criar Webjob. Para Upload de Arquivo, selecione o arquivo .zip que você criou na seção anterior.
Configurações valor Descrição Nome Emprego na Web O nome do WebJob. Deve começar com uma letra ou um número e não deve conter caracteres especiais além de "-" e "_". Upload de arquivo webjob.zip O arquivo .zip que contém webjob-artifact-1.0.0.jar. Os tipos de ficheiro suportados estão listados na secção Tipos de ficheiro suportados .Tipo Acionado Especifica quando o WebJob é executado: Contínuo ou Acionado. Acionadores Programado Programado ou Manual. Certifique-se de que Always on está ativado para que a agenda funcione de forma confiável. Expressão CRON 0 0/1 * * * * Para este início rápido, usamos um cronograma que corre a cada minuto. Consulte as expressões CRON para saber mais sobre a sintaxe. O novo WebJob aparece na página WebJobs . Se vir uma mensagem a dizer que o WebJob foi adicionado, mas não a vê, selecione Atualizar.
O WebJob agendado é executado no cronograma definido pela expressão CRON.
WebJobs é um recurso do Serviço de Aplicativo do Azure que permite executar um programa ou script na mesma instância de um aplicativo Web. Todos os planos de serviço de aplicativo suportam WebJobs sem custo extra. Este exemplo usa um WebJob agendado (acionado) para gerar a hora do sistema uma vez a cada minuto.
Pré-requisitos
- Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
- Um aplicativo PHP do Serviço de Aplicativo existente no Linux. Neste início rápido, um aplicativo PHP é usado.
- Sempre ativado deve estar ativado em seu aplicativo.
- Verifique se a configuração
WEBSITE_SKIP_RUNNING_KUDUAGENTdo aplicativo está definida comofalse.
Preparar o WebJob de exemplo
Faça o download do projeto de exemplo pré-construído para começar rapidamente. O exemplo contém o arquivo
webjob.phpPHP , que emite a hora atual para o console, como mostrado abaixo:<?php // Get the current time $current_time = date("Y-m-d H:i:s"); // Display the current time echo "The current time is: " . $current_time; ?>Extraia o arquivo zip baixado e, em seguida, crie um novo arquivo zip contendo apenas o
webjob.phparquivo (sem qualquer diretório pai). WebJobs requer que o executável ou script esteja na raiz do arquivo zip.
Criar um WebJob agendado
No portal do Azure, vá para a página Serviço de Aplicativo do seu aplicativo do Serviço de Aplicativo.
No painel esquerdo, selecione WebJobs e, em seguida, selecione Adicionar.
Preencha as configurações Adicionar WebJob conforme especificado na tabela e selecione Criar Webjob. Para Carregamento de Ficheiro, certifique-se de selecionar o ficheiro .zip criado anteriormente na secção Preparar o WebJob de exemplo.
Configurações valor Description Nome Emprego na Web O nome do WebJob. Deve começar com uma letra ou um número e não deve conter caracteres especiais além de "-" e "_". Upload de arquivo webjob.zip O ficheiro.zip que contém webjob.phpno nível raiz. Os tipos de ficheiro suportados estão listados na secção Tipos de ficheiro suportados .Tipo Acionado Especifica quando o WebJob é executado: Contínuo ou Acionado. Acionadores Programado Programado ou Manual. Certifique-se de que Always on está ativado para que a agenda funcione de forma confiável. Expressão CRON 0 0/1 * * * * Para este início rápido, usamos um cronograma que corre a cada minuto. Consulte as expressões CRON para saber mais sobre a sintaxe. O novo WebJob aparece na página WebJobs . Se vir uma mensagem a dizer que o WebJob foi adicionado, mas não a vê, selecione Atualizar.
O WebJob agendado é executado no cronograma definido pela expressão CRON.
Observação
O fuso horário padrão usado para executar expressões CRON é o Tempo Universal Coordenado (UTC). Para que sua expressão CRON seja executada com base em outro fuso horário, crie uma configuração de aplicativo para seu aplicativo de função chamado WEBSITE_TIME_ZONE. Para saber mais, consulte Fusos horários NCRONTAB.
Verifique os Logs do WebJob
Selecione o registo do WebJob que criou anteriormente.
A saída deve ser semelhante à seguinte.
Limpeza
Para remover o WebJob, selecione o WebJob no portal e selecione Delete.
Próximo passo
Explore cenários de WebJob mais avançados, incluindo gatilhos e opções de implantação