Giriş & Kurulum

Karar Rehberi

Örnek: Bir e-ticaret platformunda sipariş sonrası fatura PDF oluşturma, kargo entegrasyonu çağırma ve müşteriye e-posta gönderme — üçü de fire-and-forget job olarak enqueue edilir. Kullanıcı anında "Siparişiniz alındı" görür, arka planda işlemler güvenilir şekilde tamamlanır.

Lisans ve Özellik Katmanları

Hangfire'ın özellik katmanları ile satın alma planları aynı şey değildir. Core açık kaynaklı temel üründür; Pro ve Ace ise ücretli planlarla sunulan ek paketlerdir.

NuGet Paketleri

Kurulum

dotnet add package Hangfire.AspNetCore
dotnet add package Hangfire.SqlServer

Minimal Konfigürasyon (Program.cs)

using Hangfire;
using Hangfire.SqlServer;

var builder = WebApplication.CreateBuilder(args);

// Hangfire servislerini kaydet
builder.Services.AddHangfire(config => config
    .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UseSqlServerStorage(builder.Configuration.GetConnectionString("HangfireConnection"), new SqlServerStorageOptions
    {
        CommandBatchMaxTimeout = TimeSpan.FromMinutes(5),
        SlidingInvisibilityTimeout = TimeSpan.FromMinutes(5),
        QueuePollInterval = TimeSpan.Zero,              // Long-polling (SlidingInvisibilityTimeout ile birlikte)
        UseRecommendedIsolationLevel = true,
        DisableGlobalLocks = true,                      // Schema 7+ gerektirir (yeni kurulumda otomatik)
        TryAutoDetectSchemaDependentOptions = true,     // 1.8: Schema'ya göre opsiyonları otomatik ayarlar
        SchemaName = "hangfire"
    }));

// Background job server'ı IHostedService olarak ekle
builder.Services.AddHangfireServer(options =>
{
    options.WorkerCount = Environment.ProcessorCount * 5; // Varsayılan (IO-bound iş yükleri için)
    options.Queues = new[] { "critical", "default", "low" };
});

var app = builder.Build();

// Dashboard — development'ta serbest, production'da auth zorunlu
if (app.Environment.IsDevelopment())
{
    app.UseHangfireDashboard("/hangfire");
}
else
{
    app.UseHangfireDashboard("/hangfire", new DashboardOptions
    {
        Authorization = new[] { new HangfireAuthorizationFilter() },
        DisplayStorageConnectionString = false
    });
}

app.Run();

appsettings.json

{
  "ConnectionStrings": {
    "HangfireConnection": "Server=.;Database=HangfireDb;Trusted_Connection=true;TrustServerCertificate=true;"
  }
}

Örnek: İlk kurulumda Hangfire otomatik olarak gerekli tabloları oluşturur (schema migration). Production'da SchemaName parametresi ile kendi schema'nızda izole edebilirsiniz — böylece uygulama tabloları ile karışmaz.

Hangfire 1.7 → 1.8 Migration

// 1.8'e geçerken CompatibilityLevel'ı yükseltin
// Bu, yeni storage optimizasyonlarını aktif eder
builder.Services.AddHangfire(config => config
    .SetDataCompatibilityLevel(CompatibilityLevel.Version_180)
    .UseSimpleAssemblyNameTypeSerializer()
    .UseRecommendedSerializerSettings()
    .UseSqlServerStorage(connectionString));