.NET Core 3.0 - Criando tarefas de segundo plano com Worker Service \| TreinaWeb Promoção no ar Matricule-se agora e garanta **54% de desconto** Termina em Tempo restante da oferta: 17 Horas 54 Min 02 Seg Tempo restante da oferta: 17 54 02 [Assinar →](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Explorar [ Quanto custa? ](#assinatura) [ FAQ ](https://www.treinaweb.com.br#faq) [Matricule-se](#assinatura) [ Entrar ](https://www.treinaweb.com.br/login) [ Início ](https://www.treinaweb.com.br) [ Artigos ](https://www.treinaweb.com.br/blog) .NET Core 3.0 - Criando tarefas de segundo plano com Worker Service [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) [ ASP .NET ](https://www.treinaweb.com.br/blog/categoria/asp-net) [ .NET Core ](https://www.treinaweb.com.br/blog/categoria/net-core) # .NET Core 3.0 - Criando tarefas de segundo plano com Worker Service Você já quis criar tarefas em segundo plano com o .NET Core? Na versão 3.0 foi introduzido o template Worker Service que facilita a criação deste tipo de aplicação. Caso tenha passado por uma situação assim, neste artigo mostramos como você pode aproveitar este novo recurso do .NET Core 3.0. [ Wladimilson M. Nascimento ](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) 7 anos atrás ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/08/01172547/NET-CORE-3.png) Quando se pensa em uma aplicação ASP.NET Core, provavelmente irá pensar em uma aplicação [MVC](https://www.treinaweb.com.br/blog/operacoes-crud-no-asp-net-mvc-5-com-o-ado-net/), [Web API](https://www.treinaweb.com.br/blog/documentando-uma-asp-net-core-web-api-com-o-swagger/) ou [Razor](https://www.treinaweb.com.br/blog/net-core-3-0-razor-components/). Mas um detalhe pouco conhecido é que também é possível criar tarefas de segundo plano com o ASP.NET Core, através do conceito de [*generic hosts*](https://docs.microsoft.com/pt-br/aspnet/core/fundamentals/host/generic-host). Na versão 3.0 do .NET Core, este tipo de aplicação foi definida em um novo template chamado Worker Service, facilitando assim a criação das tarefas de segundo plano e dando mais destaque para este recurso. O conceito de *generic host* foi introduzido na [versão 2.1 do .NET Core](https://www.treinaweb.com.br/blog/novos-recursos-do-asp-net-core-2-1/) e trata-se de uma aplicação ASP.NET Core que não processa requisições [HTTP](https://www.treinaweb.com.br/blog/o-que-e-http-request-get-post-response-200-404/). O objetivo deste tipo de aplicação é remover o pipeline HTTP enquanto mantém os demais recursos de uma aplicação ASP.NET Core, como configuração, [injeção de dependência](https://www.treinaweb.com.br/blog/entendendo-injecao-de-dependencia/) e logging. Permitindo assim a criação de aplicações que precisam ser executadas em segundo plano, como serviços de mensagens. [ ![C# (C Sharp) Básico](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/csharp.svg) Curso C# (C Sharp) Básico Conhecer o curso ](https://www.treinaweb.com.br/curso/csharp-basico) ## Criando uma aplicação Worker Service Para criar uma aplicação Worker Service é necessário ter instalado o .NET Core 3.0, que no momento da criação deste artigo está no preview 7. Caso esteja utilizando o Visual Studio, este tipo de aplicação está disponível a partir da versão 2019. Como estou utilizando o Visual Studio Code, vou criar a aplicação pela linha de comando com o código abaixo: ```dos dotnet new worker -n WorkerSample ``` No Visual Studio 2019 você pode encontrar o template desta aplicação dentro dos subtemplates do ASP.NET Core. Na classe `Program`, podemos notar que é criado um servidor web: ```Csharp public class Program { public static void Main(string[] args) { CreateHostBuilder(args).Build().Run(); } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureServices((hostContext, services) => { services.AddHostedService(); }); } ``` Que define um serviço, a classe `Worker`, que veremos a seguir. ## Definindo a tarefa A classe responsável por executar a tarefa em segundo plano é a classe `Worker`: ```csharp public class Worker : BackgroundService { private readonly ILogger _logger; public Worker(ILogger logger) { _logger = logger; } protected override async Task ExecuteAsync(CancellationToken stoppingToken) { while (!stoppingToken.IsCancellationRequested) { _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now); await Task.Delay(1000, stoppingToken); } } } ``` Note que o construtor recebe uma instância de `Logger`. Podemos utilizar esta instância para notificar o usuário do estado do serviço. Já no método `ExecuteAsync` é onde a tarefa de segundo plano é executada. Note que ela é executada enquanto o serviço não for cancelado. Para este artigo iremos modificar apenas o método `ExecuteAsync`, adicionando informações sobre o estado do serviço: ```csharp protected override async Task ExecuteAsync(CancellationToken stoppingToken) { _logger.LogInformation("O serviço está iniciando."); stoppingToken.Register(() => _logger.LogInformation("Tarefa de segundo plano está parando.")); while (!stoppingToken.IsCancellationRequested) { _logger.LogInformation("Executando tarefa: {time}", DateTimeOffset.Now); await Task.Delay(10000, stoppingToken); } _logger.LogInformation("O serviço está parando."); } ``` Ao executar a aplicação temos o resultado abaixo: ![](https://dkrn4sk0rn31v.cloudfront.net/2019/07/31155928/worker_service_1.png) No momento ela ainda não está sendo executada como serviço, vamos configurá-la para isso. [ ![C# (C Sharp) Intermediário](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/csharp.svg) Curso C# (C Sharp) Intermediário Conhecer o curso ](https://www.treinaweb.com.br/curso/csharp-intermediario) ## Configurando a tarefa como serviço para ser executada em segundo plano Para executar a aplicação como serviço, é necessário adicionar o pacote “`Microsoft.Extensions.Hosting.WindowsServices`” na aplicação: ```dos dotnet add package Microsoft.Extensions.Hosting.WindowsServices ``` Ao adicioná-lo podemos chamar o método `UseWindowsService()`: ```csharp public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .UseWindowsService() .ConfigureServices((hostContext, services) => { services.AddHostedService(); }); ``` Este método verifica se a aplicação está executando como serviço e faz as configurações necessárias de acordo deste contexto. Ela também configura a aplicação para utilizar o `ServiceBaseLifetime `, que auxilia no controle do ciclo de vida da aplicação enquanto ela é executada como serviço. Isso sobrescreve o padrão `ConsoleLifetime`. ## Publicando o serviço Com o `ServiceBaseLifetime` configurado, podemos publicar a nossa aplicação: ```dos dotnet publish -c Release ``` O comando acima irá publicar a aplicação de acordo com o ambiente de desenvolvimento. Você também pode publicar a aplicação para um sistema específico com a opção `-r`: ```dos dotnet publish -c Release -r ``` `` significa [Runtime Identifier (RID) e na documentação você pode ver as opções disponíveis](https://docs.microsoft.com/pt-br/dotnet/core/rid-catalog). ## Instalando o serviço no Windows Com a aplicação publicada, ela pode ser instalada como serviço no **Windows** com o utilitário [sc](https://docs.microsoft.com/en-us/windows/win32/services/controlling-a-service-using-sc): ```dos sc create workersample binPath=C:\Programs\Services\WorkerSample.exe ``` ## Instalando o serviço no Mac OS X No caso do Mac OS X, os serviços são conhecimentos como *daemon*. Para definir o nosso serviço neste sistema como um *daemon*, é necessário possuir o .NET Core instalado na máquina e definir um script: ```shell #!bin/bash #Start WorkerSample if not running if [ “$(ps -ef | grep -v grep | grep WorkerSample | wc -l)” -le 0 ] then dotnet /usr/local/services/WorkerSample.dll echo "WorkerSampler Started" else echo "WorkerSample Already Running" fi ``` Dê para este script permissão de execução: ```dos chmod +x ~/scripts/startup/startup.sh ``` Os daemons neste sistema operacional são definidos na pasta `/Library/LaunchDaemons/ `, onde deve ser configurado em um arquivo XML com a extensão `.plist` (não faz parte do escopo deste artigo explicar as configurações deste arquivo, você pode conhecê-las na documentação do [launchd](https://www.launchd.info/)). No nosso caso, o arquivo terá o conteúdo abaixo: ```xml EnvironmentVariables PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin: Label br.com.treinaweb.workersample Program /Users/admin/scripts/startup/startup.sh RunAtLoad KeepAlive LaunchOnlyOnce StandardOutPath /tmp/startup.stdout StandardErrorPath /tmp/startup.stderr UserName admin GroupName admin InitGroups ``` Com isso, para iniciar o *daemon* basta carregar o arquivo `.plist`, que acabamos de definir: ```dos sudo launchctl load -w /Library/LaunchDaemons/br.com.treinaweb.workersample.plist ``` ## Instalando o daemon no Linux Assim como no Mac OS X, no Linux os serviços são conhecidos como *daemon* e nesta plataforma também é necessário possuir o .NET Core instalado na máquina. Fora isso, cada distribuição pode definir uma forma de criação de *daemon*, aqui vou explicar a criação utilizando o [systemd](https://www.freedesktop.org/wiki/Software/systemd/). No *systemd* o serviço é definido em um arquivo `.service` salvo em `/etc/systemd/system` e que no exemplo deste artigo conterá o conteúdo o abaixo: ```tex [Unit] Description=Dotnet Core Demo service [Service] ExecStart=/bin/dotnet/dotnet WorkerSample.dll WorkingDirectory=/usr/local/services User=dotnetuser Group=dotnetuser Restart=on-failure SyslogIdentifier=dotnet-sample-service PrivateTmp=true [Install] WantedBy=multi-user.target ``` Após isso, basta habilitar o *daemon*: ```dos systemctl enable worker-sample.service ``` Que ele poderá ser iniciado: ```dos systemctl start dotnet-sample-service.service ``` *Obs:* Infelizmente no Mac OS X e Linux, a aplicação não sabe quando está sendo parada, algo que ocorre no Windows, quando ela é executada como serviço. [ ![C# (C Sharp) Avançado](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/csharp.svg) Curso C# (C Sharp) Avançado Conhecer o curso ](https://www.treinaweb.com.br/curso/csharp-avancado) ## O Worker Service é bom? O template Worker Service é uma boa adição para o .NET Core, pois isso pode tornar os generic hosts cada vez mais populares. Permitindo que as pessoas consigam utilizar os recursos do ASP.NET Core em uma aplicação console. E com o tempo, espero que melhore o suporte da aplicação como daemon em ambientes Unix. - [ #.NET Core ](https://www.treinaweb.com.br/blog/tag/net-core) - [ #ASP.NET ](https://www.treinaweb.com.br/blog/tag/asp-net) - [ #ASP .NET Core ](https://www.treinaweb.com.br/blog/tag/asp-net-core) - [ #.NET Core 3.0 ](https://www.treinaweb.com.br/blog/tag/net-core-3-0) - [ #Service ](https://www.treinaweb.com.br/blog/tag/service) - [ #Daemon ](https://www.treinaweb.com.br/blog/tag/daemon) Autor ![Wladimilson M. Nascimento](//secure.gravatar.com/avatar/f0dd442f156a3eacd2880e9cd0eafbd1?d=mm) ## Wladimilson M. Nascimento Instrutor, nerd, cinéfilo e desenvolvedor nas horas vagas. Graduado em Ciências da Computação pela Universidade Metodista de São Paulo. [Todos os artigos](https://www.treinaweb.com.br/blog/autor/wladimilson-m-nascimento) ## Continue estudando Transforme leitura em prática com os cursos e formações da TreinaWeb. [Ver cursos](https://www.treinaweb.com.br/cursos) Continue lendo ## Artigos relacionados - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/09/enviando-e-mails-no-asp-net-core-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 6 anos atrás ## [ Enviando e-mails no ASP.NET Core ](https://www.treinaweb.com.br/blog/enviando-e-mails-no-asp-net-core) O .NET possui um módulo nativo para o envio de e-mails. Entretanto, veja como facilitar este processo utilizando a biblioteca Coravel. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2017/09/automatizando-tarefas-de-um-projeto-csharp-com-o-cake-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 9 anos atrás ## [ Automatizando tarefas de um projeto C# com o Cake ](https://www.treinaweb.com.br/blog/automatizando-tarefas-de-um-projeto-csharp-com-o-cake) Veja como o Cake pode auxiliar na automação de tarefas de um projeto .NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/03/01154814/NUGET-400x280.png) [ Desenvolvimento Back-end ](https://www.treinaweb.com.br/blog/categoria/desenvolvimento-back-end) 7 anos atrás ## [ O que é o NuGet? ](https://www.treinaweb.com.br/blog/o-que-e-o-nuget) Um gerenciador de pacote é essencial em qualquer plataforma de desenvolvimento moderna. Para o .NET há o Nuget, o conheça em detalhes neste artigo. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2022/05/como-instalar-o-csharp-e-nosso-primeiro-exemplo-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 4 anos atrás ## [ Guia da linguagem C# ](https://www.treinaweb.com.br/blog/guia-da-linguagem-csharp) Nesse guia de C# você aprenderá o necessário para criar os seus primeiros softwares com a linguagem de programação C#. Acesse agora mesmo! Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/04/16095041/OCELOT-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 8 anos atrás ## [ Criando um API Gateway com ASP.NET Core e Ocelot ](https://www.treinaweb.com.br/blog/criando-um-api-gateway-com-asp-net-core-e-ocelot) Conheça o conceito de API Gateway e veja como criá-lo em uma aplicação ASP.NET utilizando a biblioteca Ocelot. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/08/14131229/HEALTH-CHECKS-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ Verificando a integridade da aplicação ASP.NET Core com Health Checks ](https://www.treinaweb.com.br/blog/verificando-a-integridade-da-aplicacao-asp-net-core-com-health-checks) Verificar e monitorar a integridade de uma aplicação web é algo essencial, principalmente em ambientes distribuídos. O ASP.NET Core facilita esta tarefa através de Health Checks, como você verá neste artigo. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/03/29132239/PROTOCOLO-TUS-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 8 anos atrás ## [ Implementando o protocolo tus em uma aplicação ASP.NET Core ](https://www.treinaweb.com.br/blog/implementando-o-protocolo-tus-em-uma-aplicacao-asp-net-core) Realizar o upload de grandes arquivos pode ser uma dor de cabeça, mas o protocolo tus foi criado para facilitar este processo. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2019/02/18175820/RAZOR-COMPONENTS-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 8 anos atrás ## [ .NET Core 3.0 - Criando componentes no Razor Components ](https://www.treinaweb.com.br/blog/net-core-3-0-criando-componentes-no-razor-components) Veja neste artigo como é a estrutura de um componente do Razor Componente e aprenda a criar um. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/01/06113752/streaming-api-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ ASP.NET Core - Criando uma Streaming API ](https://www.treinaweb.com.br/blog/asp-net-core-criando-uma-streaming-api) Streaming não se resume apenas a conteúdo de media. Aprenda neste artigo como criar uma streaming API de dados no ASP.NET Core. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/08/clicando-publicando-lambda-com-net-core-cli-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 6 anos atrás ## [ Criando e publicando uma função AWS Lambda com o CLI do .NET Core ](https://www.treinaweb.com.br/blog/criando-e-publicando-uma-funcao-aws-lambda-com-o-cli-do-net-core) O .NET Core CLI, que já é uma ferramenta poderosa e com recursos fornecidos pela AWS, também permite criar e gerar funções Lambda. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/11/criando-aplicacoes-desktop-multiplataforma-com-asp-net-core-e-electron-net-400x280.png) [ ASP .NET ](https://www.treinaweb.com.br/blog/categoria/asp-net) 6 anos atrás ## [ Criando aplicações desktop multiplataforma com ASP.NET Core e Electron.NET ](https://www.treinaweb.com.br/blog/criando-aplicacoes-desktop-multiplataforma-com-asp-net-core-e-electron-net) Otimize a criação de aplicações desktop reutilizando códigos do ASP.NET Core, com a ajuda do Electron.NET. Ler artigo - ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2020/01/05103838/SIGNALR-400x280.png) [ C# ](https://www.treinaweb.com.br/blog/categoria/csharp) 7 anos atrás ## [ Criando um Chat com ASP.NET Core SignalR ](https://www.treinaweb.com.br/blog/criando-um-chat-com-asp-net-core-signalr) Continuando o estudo do SignalR, aprenda como criar um chat utilizando esta biblioteca de aplicações em tempo real do ASP.NET Core. Ler artigo ## Um ano de acesso total para você viver de programação. Todos os cursos e formações da TreinaWeb numa única assinatura, com professores que atuam no mercado, suporte direto e certificados. Do primeiro `console.log` ao mercado de trabalho. - **1 ano** de acesso a **todos os cursos** - Cursos novos **toda semana** - Suporte **direto com professores** - Plano de carreira **personalizado** - **Certificados digitais** inclusos - **Aplicativos** para Android e iOS, com **acesso offline** **Garantia incondicional de satisfação** Teste por 7 dias e, se não fizer sentido para você, devolvemos seu dinheiro. ### Acesso completo a todos os cursos e dezenas de Formações. 12 meses Economize R$ 840,00 54% OFF de 12x R$ 129,00 por apenas 12x R$ 59,00 sem juros no cartão de crédito ou R$ 599,00 à vista Oferta termina em **17h 54min 02s** - Acesso imediato e ilimitado durante 1 ano. - Plano de carreira personalizado. - Suporte direto com professores. - E muito mais! [Matricule-se agora](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Escola online de programação, tecnologia e IA. - [ ](https://www.facebook.com/TreinaWeb/) - [ ](https://www.instagram.com/treinaweb/) - [ ](https://www.youtube.com/user/TreinaWeb) - [ ](https://twitter.com/treinaweb) - [ ](https://www.linkedin.com/company/treinaweb) - [ ](https://github.com/treinaweb) ## Inscreva-se em nossa newsletter Receba lançamentos, promoções e novidades. Seu nome Seu WhatsApp Seu melhor e-mail Inscrever-se ## Cursos - [ Base para Devs ](https://www.treinaweb.com.br/categoria/base-para-devs) - [ Front-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-front-end) - [ Back-end ](https://www.treinaweb.com.br/categoria/desenvolvimento-back-end) - [ Mobile ](https://www.treinaweb.com.br/categoria/desenvolvimento-mobile) - [ Bancos de Dados ](https://www.treinaweb.com.br/categoria/bancos-de-dados) - [ Cloud ](https://www.treinaweb.com.br/categoria/cloud-computing) - [ IA ](https://www.treinaweb.com.br/categoria/ia) - [ E mais ](https://www.treinaweb.com.br/categoria/e-mais) - [ Ver todos os cursos ](https://www.treinaweb.com.br/cursos) ## Conteúdo - [ Formações ](https://www.treinaweb.com.br/formacoes) - [ Projetos práticos ](https://www.treinaweb.com.br/projetos-praticos) - [ Direto ao ponto ](https://www.treinaweb.com.br/direto-ao-ponto) - [ Planos ](https://www.treinaweb.com.br#assinatura) - [ Depoimentos ](https://www.treinaweb.com.br#depoimentos) - [ Comunidade ](https://www.treinaweb.com.br#comunidade) - [ Corpo docente ](https://www.treinaweb.com.br#docente) ## A empresa - [ Sobre a TreinaWeb ](https://www.treinaweb.com.br#sobre) - [ Perguntas frequentes ](https://www.treinaweb.com.br#faq) - [ Vantagens de estudar na TreinaWeb ](https://www.treinaweb.com.br/vantagens-de-estudar-na-treinaweb) - [ Cursos para empresas ](https://www.treinaweb.com.br/empresas) - [ Sugira um novo curso ](https://www.treinaweb.com.br/sugerir-curso) - [ Trabalhe conosco ](https://www.treinaweb.com.br/trabalhe-conosco) - [ Artigos ](https://www.treinaweb.com.br/blog) - [ Desenvolvedores e agentes ](https://www.treinaweb.com.br/developers) - [ Contato ](https://www.treinaweb.com.br/contato) - [ Política de privacidade ](https://www.treinaweb.com.br/politica-de-privacidade) - [ Termos de uso ](https://www.treinaweb.com.br/termos-de-uso) ## Baixe nosso aplicativo [ Disponível na **App Store** ](https://apps.apple.com/us/app/treinaweb/id1322729447) [ Disponível no **Google Play** ](https://play.google.com/store/apps/details?id=br.com.treinaweb.mobile) Av. Paulista, 1765, Conj 71 e 72 · Bela Vista · São Paulo · SP · 01311-200 © 2004 – 2026 TreinaWeb Tecnologia LTDA · CNPJ 06.156.637/0001-58