‫انتشار بدون قطعی (Zero-Downtime) با ترکیب Nginx Retry و Graceful Shutdown دات‌نت

• خرابی تراکنش‌های جاری: درخواست‌های Create/Update/Delete که کاربران در همان لحظه فرستاده‌اند، با قطع شدن ناگهانی پروسس، ناقص و نیمه‌کاره رها می‌شوند.
• خطای Bad Gateway (502/503): کاربرانی که دقیقاً در همان ۲ الی ۴ ثانیهٔ ری‌استارت شدن برنامه وارد سایت می‌شوند، با صفحه خطای وب‌سرور روبرو می‌شوند.

[کاربران] ---> [Nginx Proxy (Retry Buffer)] ---> [.NET Kestrel (Graceful Shutdown)]

• لایه دات‌نت: وقتی سیگنال خاموشی دریافت می‌کند، بلافاصله پورت Kestrel را برای ریکوئست‌های جدید می‌بندد اما تا ۳۰ ثانیه پردازش‌های دیتابیسی فعلی را به پایان می‌رساند.
• لایه Nginx: در طول این ۲ تا ۴ ثانیه‌ای که Kestrel خاموش و مجدداً با کد جدید روشن می‌شود، Nginx درخواست‌های کاربران را در یک بافر نگه داشته (Retry) و به محض آماده شدن پروسس جدید، آنها را پاس می‌دهد. کاربر نهایی تنها یک تاخیر کوتاه ۲ ثانیه‌ای حس می‌کند و هیچ خطایی نمی‌بیند.

# /etc/nginx/conf.d/app.conf

upstream backend_dotnet {
    server 127.0.0.1:5000 max_fails=0;
    keepalive 32;
}

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend_dotnet;
        proxy_http_version 1.1;
        proxy_set_header Connection "";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # ----------------------------------------------------
        # هسته اصلی راهکار: مکانیزم Retry و Draining موقت
        # ----------------------------------------------------
        proxy_next_upstream error timeout http_502 http_503;
        proxy_next_upstream_tries 3;
        proxy_next_upstream_timeout 10s;
        proxy_connect_timeout 2s;

        # مهلت مجاز برای درخواست‌های سنگین دیتابیسی
        proxy_read_timeout 60s;
        proxy_send_timeout 60s;
    }
}

• proxy_next_upstream error timeout http_502 http_503: به Nginx دستور می‌دهد اگر در حین اتصال با خطای قطع شبکه، تایم‌اوت یا خطای ۵۰۲ مواجه شد، درخواست را لغو نکرده و دوباره تلاش کند.
• proxy_connect_timeout 2s: زمان انتظار برای اتصال اولیه به Kestrel. اگر Kestrel در حال ری‌استارت باشد، حداکثر ۲ ثانیه صبر کرده و سپس تلاش بعدی را آغاز می‌کند.
• proxy_next_upstream_tries 3: تعداد دفعات مجاز برای تلاش مجدد قبل از برگرداندن خطا به کلاینت.
• max_fails=0: جلوگیری از اینکه Nginx سرور محلی را کلاً Unhealthy و از کار افتاده تلقی کند.

// Program.cs
var builder = WebApplication.CreateBuilder(args);

// تنظیم زمان مهلت خاموشی Kestrel برای اتمام عملیات جاری
builder.Services.Configure<HostOptions>(options =>
{
    options.ShutdownTimeout = TimeSpan.FromSeconds(30);
});

var app = builder.Build();

// نمونه اندپوینت CRUD دیتابیسی
app.MapPost("/api/orders", async (OrderDto dto, AppDbContext db, CancellationToken ct) =>
{
    var order = new Order { Title = dto.Title, CreatedAt = DateTime.UtcNow };
    db.Orders.Add(order);
    
    // عبور دادن توکن لغو برای پشتیبانی از Rollback امن
    await db.SaveChangesAsync(ct);
    
    return Results.Created($"/api/orders/{order.Id}", order);
});

app.Run();

# /etc/systemd/system/myapp.service
[Unit]
Description=My .NET Production App
After=network.target

[Service]
WorkingDirectory=/var/www/myapp
ExecStart=/usr/bin/dotnet /var/www/myapp/MyApp.dll
Restart=always
RestartSec=5
KillSignal=SIGTERM
TimeoutStopSec=35s
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

• کپی فایل‌های جدید: نسخه کامپایل‌شده در مسیر /var/www/myapp کپی می‌شود.
• اجرای دستور ری‌استارت:

sudo systemctl restart myapp

• سیستم‌عامل سیگنال SIGTERM به دات‌نت می‌فرستد.
• دات‌نت پذیرش درخواست جدید را متوقف کرده، اما تا ۳۰ ثانیه منتظر اتمام تراکنش‌های در حال پردازش می‌ماند.
• در بازه زمانی ۲ الی ۳ ثانیه‌ای ری‌استارت، درخواست‌های جدید وارد Nginx شده و به لطف proxy_next_upstreamمنتظر می‌مانند.
• پروسه جدید بالا می‌آید و Nginx ترافیک معلق را بدون قطعی تحویل آن می‌دهد.