<\/div>\n

Merhaba,<\/p>\n

Bu i\u00e7eri\u011fimizde; Asp.NET Core uygulamalar\u0131nda Background Jobs(Arka plan \u0130\u015fleri) ger\u00e7ekle\u015ftirebilmek i\u00e7in bir a\u00e7\u0131k kaynak k\u00fct\u00fcphanesi olan Hangfire’i inceliyor olaca\u011f\u0131z. Hangfire; \u00e7ok yabanc\u0131 olmad\u0131\u011f\u0131m\u0131z ve zaman\u0131nda hakk\u0131nda detayl\u0131 makale yazd\u0131\u011f\u0131m\u0131z Quartz.Net<\/a> k\u00fct\u00fcphanesinin g\u00fczel bir muadilidir diyebiliriz.<\/p>\n

Background Jobs Nedir?<\/h4>\n
Arka plan i\u015fleri olarak nitelendirilen Background Jobs<\/em> asl\u0131nda zamanlanm\u0131\u015f g\u00f6revlerin ta kendisidir. Bazen uygulamalar\u0131m\u0131z\u0131n ana thread d\u0131\u015f\u0131nda bir task i\u015flemesi yahut senaryo gere\u011fi belli aral\u0131klarla belli i\u015flemlerin ger\u00e7ekle\u015ftirilmesi gerekebilmektedir. \u0130\u015fte bu tarz ihtiya\u00e7lara istinaden ger\u00e7ekle\u015ftirilen zamanlanm\u0131\u015f g\u00f6revleri background jobs<\/em> diyerek tarif etmekteyiz.<\/p>\n
Hangfire’\u0131n Avantajlar\u0131 Nelerdir?<\/h4>\n\n
Olduk\u00e7a kolay kullan\u0131ma ve y\u00f6netilebilirli\u011fe sahiptir.<\/li>\n
Hangfire, veritaban\u0131 ile otomatik entegrasyon sa\u011flad\u0131\u011f\u0131 i\u00e7in tan\u0131mlanan i\u015flere ait t\u00fcm kay\u0131tlar\u0131 fiziksel olarak tutmaktad\u0131r. Dolay\u0131s\u0131yla bir i\u015f tam teferruat\u0131yla tamamlanmadan ge\u00e7ilmeyecek, s\u00fcre\u00e7teki olas\u0131 hatalarla kar\u015f\u0131la\u015f\u0131lma durumunda i\u015f tekrardan \u00e7al\u0131\u015ft\u0131r\u0131lacak ve i\u015fe dair son noktay\u0131 koymaks\u0131z\u0131n bu s\u00fcre\u00e7 b\u00f6yle devam edecektir. Dolay\u0131s\u0131yla fiziksel kay\u0131t s\u00f6z konusu oldu\u011fundan dolay\u0131 i\u015f g\u00fcvenli\u011fi hat safhada sunulmaktad\u0131r.<\/li>\n<\/ul>\n
Hangfire Nas\u0131l \u00c7al\u0131\u015f\u0131r? Mimarisi Nas\u0131ld\u0131r?<\/h4>\n
$\"Asp.NET$ <\/a>
\nHangfire; clienttan al\u0131nan g\u00f6revleri “Hangfire Job Storage(Hangfire \u0130\u015f Deposu)” isimli alanda depolayarak s\u0131raya al\u0131r. Server taraf\u0131ndan ilgili depodaki i\u015fler s\u0131ras\u0131yla tek tek al\u0131narak arka planda i\u015flenir ve sonu\u00e7 olarak clienta haber g\u00f6nderir.<\/p>\n
Projeye Hangfire Entegrasyonu<\/h4>\n
Asp.NET Core projesine Hangfire’\u0131 entegre edebilmek i\u00e7in ilgili projenin ana dizinine odaklanm\u0131\u015f powershell ekran\u0131nda a\u015fa\u011f\u0131daki komutu \u00e7al\u0131\u015ft\u0131rman\u0131z yeterli olacakt\u0131r.
\n $\"Asp.NET$ <\/a><\/p>\n
\r\ndotnet add package Hangfire\r\n<\/pre>\n
Bu i\u015flemden sonra Hangfire k\u00fct\u00fcphanesi projeye entegre edilmi\u015f olacakt\u0131r.<\/p>\n
Hangfire Kurulumu<\/h4>\n
Entegre etti\u011fimiz Hangfire k\u00fct\u00fcphanesini Asp.NET Core projesinde aktif hale getirebilmek i\u00e7in ilk olarak Hangfire’\u0131n kullanaca\u011f\u0131 veritan\u0131n\u0131 olu\u015fturmam\u0131z gerekmektedir.
\n $\"Asp.NET$ <\/a><\/p>\n
Hangfire; arka planda ger\u00e7ekle\u015fecek olan i\u015fleri s\u0131ral\u0131 bir \u015fekilde kayda almak ve sonu\u00e7lar\u0131n\u0131 takip edebilmek i\u00e7in fiziksel olarak bu veritaban\u0131n\u0131 kullanacakt\u0131r. Uygulama ilk aya\u011fa kalkt\u0131\u011f\u0131nda Hangfire yap\u0131lanmas\u0131 ilgili veritaban\u0131nda kendisine ait tablolar\u0131n var olup olmad\u0131\u011f\u0131n\u0131 check etmekte, e\u011fer yoksa an\u0131nda migrate etmektedir. Evet, zaten birazdan bu durumuda g\u00f6zlemleyece\u011fiz \ud83d\ude42<\/p>\n
S\u0131ra veritaban\u0131 provider\u0131n\u0131 “appsettings.json” dosyas\u0131na eklemeye geldi.<\/p>\n
\r\n{\r\n "ConnectionString": "Server=.;Database=HangfireDB;Trusted_Connection=True;"\r\n}\r\n<\/pre>\n
Bu i\u015flemden sonra Hangfire k\u00fct\u00fcphanesini servis olarak uygulamaya dahil etmek ve nimetlerinden faydalanabilmek i\u00e7in “Startup.cs” dosyas\u0131nda a\u015fa\u011f\u0131daki \u00e7al\u0131\u015fmalar\u0131 ger\u00e7ekle\u015ftirelim.<\/p>\n
\r\n public class Startup\r\n {\r\n public IConfiguration Configuration { get; set; }\r\n public Startup(IConfiguration configuration)\r\n {\r\n Configuration = configuration;\r\n }\r\n public void ConfigureServices(IServiceCollection services)\r\n {\r\n services.AddHangfire(_ => _.UseSqlServerStorage(Configuration.GetValue<string>("ConnectionString")));\r\n services.AddMvc();\r\n }\r\n\r\n public void Configure(IApplicationBuilder app, IHostingEnvironment env)\r\n {\r\n if (env.IsDevelopment())\r\n app.UseDeveloperExceptionPage();\r\n\r\n app.UseHangfireDashboard();\r\n app.UseHangfireServer();\r\n\r\n app.UseMvc(_ => _.MapRoute(\r\n name: "Default",\r\n template: "{controller=Home}\/{action=Index}\/{id?}"\r\n ));\r\n }\r\n }\r\n<\/pre>\n
Yukar\u0131daki kod blo\u011funu incelerseniz e\u011fer;
\n“ConfigureServices” metodunda “AddHangfire” fonksiyonu ile Hangfire k\u00fct\u00fcphanesinin kullanaca\u011f\u0131 SQL Server Storage’ini belirlemekteyiz. “Configure” metodunda ise “UseHangfireDashboard” ve “UseHangfireServer” middlewarelerini devreye sokarak Hangfire k\u00fct\u00fcphanesinin Dashboard \u00f6zelli\u011fiyle birlikte Hangfire Server’\u0131 uygulamada kullan\u0131labilir hale getiriyoruz.<\/p>\n
Hangfire dashboard’unda neler var?<\/strong> sorunuzu duyar gibiyim… Bir ka\u00e7 sat\u0131r sonra dashboard yap\u0131s\u0131n\u0131 inceleyece\u011fiz lakin \u015fimdi bu noktaya kadar yapt\u0131\u011f\u0131m\u0131z \u00e7al\u0131\u015fmay\u0131 aya\u011fa kald\u0131rarak Hangfire k\u00fct\u00fcphanesinin tablolar\u0131n\u0131n migrate edildi\u011fini ve temel yap\u0131lanmas\u0131n\u0131n s\u0131k\u0131nt\u0131s\u0131z aktifle\u015ftirildi\u011fini g\u00f6stermek istiyorum.
\n $\"Asp.NET$ <\/a>
\nYukar\u0131daki ekran g\u00f6r\u00fcnt\u00fcs\u00fcnde oldu\u011fu gibi Hangfire yapaca\u011f\u0131 i\u015fleri fiziksel olarak tutaca\u011f\u0131 t\u00fcm veritaban\u0131 yap\u0131lanmas\u0131n\u0131 otomatik migrate etmi\u015f bulunmaktad\u0131r. Burada \u00f6nceki sat\u0131rlarda bahsetti\u011fim durumu tekrarlamak istiyorum ki; ilgili tablolar silindi\u011fi taktirde bir sonraki uygulaman\u0131n aya\u011fa kalkmas\u0131 durumunda, check sonucunda tekrardan migrate edileceklerdir.<\/p>\n
Hangfire Dashboard Yap\u0131s\u0131<\/h4>\n
$\"Asp.NET$ <\/a><\/p>\n
\n
Jobs<\/strong>
\nS\u00fcrece dahil olan t\u00fcm i\u015flemleri durumlar\u0131yla birlikte takip edebildi\u011fimiz sekmedir;<\/p>\n
\n
Enqueued<\/em><\/strong>, s\u0131radaki i\u015fleri<\/li>\n
Scheduled<\/em><\/strong>, ileri tarihe ayarlanm\u0131\u015f i\u015fleri<\/li>\n
Processing<\/em><\/strong>, o anda i\u015flemde olan\/\u00e7al\u0131\u015fan i\u015fleri<\/li>\n
Succeeded<\/em><\/strong>, ba\u015far\u0131l\u0131 bir \u015fekilde tamamlanm\u0131\u015f i\u015fleri<\/li>\n
Failed<\/em><\/strong>, ba\u015far\u0131s\u0131z olmu\u015f i\u015fleri<\/li>\n
Deleted<\/em><\/strong>, silinmi\u015f i\u015fleri<\/li>\n
Awaiting<\/em><\/strong>, s\u0131ras\u0131n\u0131 bekleyen i\u015fleri<\/li>\n<\/ul>\n
g\u00f6sterir.\n<\/li>\n
Retries<\/strong>
\nTan\u0131mlanm\u0131\u015f i\u015flerden olas\u0131 hatalar sonucu tekrara d\u00fc\u015fenleri g\u00f6rd\u00fc\u011f\u00fcm\u00fcz sekmedir. Bir i\u015fin ka\u00e7\u0131nc\u0131 kez tekrara girdi\u011fi g\u00f6r\u00fclebilir. Varsay\u0131lan olarak tekrar say\u0131s\u0131 10’dur.\n<\/li>\n
Recurring Jobs<\/strong>
\nTekrarl\u0131 tan\u0131mlanm\u0131\u015f i\u015flerin g\u00f6r\u00fcld\u00fc\u011f\u00fc sekmedir. Her ne kadar ayarlanm\u0131\u015f tekrar s\u00f6z konusu olsada Trigger ile istenildi\u011fi an tetiklenebilir.\n<\/li>\n
Servers<\/strong>
\nKullan\u0131lan Hangfire sunucular\u0131n\u0131 g\u00f6rebildi\u011fimiz sekmedir.\n<\/li>\n<\/ul>\n
G\u00f6rev Olu\u015fturma<\/h4>\n
Hangfire ile d\u00f6rt farkl\u0131 aksiyonda g\u00f6rev olu\u015fturulabilmektedir. \u015eimdi gelin bu aksiyonlar\u0131 tek tek inceleyelim;<\/p>\n
\n
Fire-And-Forget Jobs<\/strong>
\n\u0130\u015f tan\u0131mlan\u0131r ve hemen ard\u0131ndan bir kereye mahsus tetiklenir.<\/p>\n
\r\n Hangfire.BackgroundJob.Enqueue(() => Console.WriteLine("Fire-And-Forget Jobs tetiklendi"));\r\n<\/pre>\n
$\"\"$ <\/a>\n<\/li>\n
Recurring Jobs<\/strong>
\nBelirlenen CRON zamanlamas\u0131na g\u00f6re tekrarlanan i\u015fler tan\u0131mlan\u0131r.<\/p>\n
\r\n Hangfire.RecurringJob.AddOrUpdate(() => Console.WriteLine("Recurring jobs tetiklendi!"), Hangfire.Cron.MinuteInterval(1));\r\n<\/pre>\n<\/li>\n
Delayed Jobs<\/strong>
\nOlu\u015fturulduktan belirli bir zaman sonra sadece bir seferli\u011fine tetiklenecek olan g\u00f6revler tan\u0131mlan\u0131r.<\/p>\n
\r\n Hangfire.BackgroundJob.Schedule(() => Console.WriteLine("Delayed jobs tetiklendi!"), TimeSpan.FromSeconds(10));\r\n<\/pre>\n
\u00d6rne\u011fin, yukar\u0131daki kod blo\u011fundaki g\u00f6rev register edildikten 10 saniye sonra tetiklenecektir.
\n $\"Asp.NET$ <\/a>\n<\/li>\n
Continuations<\/strong>
\nBirbiriyle ili\u015fkili i\u015flerin oldu\u011fu durumlarda al\u0131nan aksiyondur. Bir jobun tetiklenebilmesi i\u00e7in bir \u00f6ncekinin tamamlanmas\u0131 gerekmektedir.<\/p>\n
\r\n var parentJobId = Hangfire.BackgroundJob.Schedule(() => Console.WriteLine("1. Job"), TimeSpan.FromSeconds(10));\r\n \/\/Continuations job\r\n Hangfire.BackgroundJob.ContinueWith(parentJobId, () => Console.WriteLine("2. Job"));\r\n<\/pre>\n
$\"Asp.NET$ <\/a>\n<\/li>\n<\/ul>\n
Evet… Bu noktadan itibaren Asp.NET Core uygulamalar\u0131nda zamanlanm\u0131\u015f g\u00f6revlerin Hangfire ile tam teferruatl\u0131 nas\u0131l ger\u00e7ekle\u015ftirilebilece\u011fini incelemi\u015f bulunmaktay\u0131z. \u0130lgilenenlerin faydalanmas\u0131 dile\u011fiyle…<\/p>\n
Sonraki yaz\u0131lar\u0131mda g\u00f6r\u00fc\u015fmek \u00fczere…
\n\u0130yi \u00e7al\u0131\u015fmalar…<\/p>\n","protected":false},"excerpt":{"rendered":"
Merhaba, Bu i\u00e7eri\u011fimizde; Asp.NET Core uygulamalar\u0131nda Background Jobs(Arka plan \u0130\u015fleri) ger\u00e7ekle\u015ftirebilmek i\u00e7in bir a\u00e7\u0131k kaynak k\u00fct\u00fcphanesi olan Hangfire’i inceliyor olaca\u011f\u0131z. Hangfire; \u00e7ok yabanc\u0131 olmad\u0131\u011f\u0131m\u0131z ve zaman\u0131nda hakk\u0131nda detayl\u0131 makale yazd\u0131\u011f\u0131m\u0131z Quartz.Net k\u00fct\u00fcphanesinin g\u00fczel bir...<\/p>\n","protected":false},"author":1,"featured_media":10680,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2739,2668,2656],"tags":[2804,2803,2805,2809,2808,2807,2806,2810],"class_list":["post-10673","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-core","category-asp-net-core-2","category-asp-net-core-2-mvc","tag-arka-plan-isleri","tag-background-job","tag-background-jobs","tag-fire-and-forget-jobs","tag-hangfire","tag-hangfire-is-deposu","tag-hangfire-job-storage","tag-recurring-jobs"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/10673","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/comments?post=10673"}],"version-history":[{"count":27,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/10673\/revisions"}],"predecessor-version":[{"id":10708,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/posts\/10673\/revisions\/10708"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media\/10680"}],"wp:attachment":[{"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/media?parent=10673"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/categories?post=10673"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.gencayyildiz.com\/blog\/wp-json\/wp\/v2\/tags?post=10673"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

Hangfire’\u0131n Avantajlar\u0131 Nelerdir?<\/h4>\n\nOlduk\u00e7a kolay kullan\u0131ma ve y\u00f6netilebilirli\u011fe sahiptir.<\/li>\n

G\u00f6rev Olu\u015fturma<\/h4>\nHangfire ile d\u00f6rt farkl\u0131 aksiyonda g\u00f6rev olu\u015fturulabilmektedir. \u015eimdi gelin bu aksiyonlar\u0131 tek tek inceleyelim;<\/p>\n