‫لینوکس برای توسعه‌دهندگان دات‌نت: از ویندوز تا کراس-پلتفرم؛ بخش سوم: دیپلوی و اجرای برنامه‌های دات‌نت روی لینوکس

• مزیت: حجم خروجی بسیار کم است، چون فریمورک دات‌نت در آن وجود ندارد.
• عیب: سرور لینوکس حتماً باید همان نسخه از .NET Runtime (یا نسخه‌ی بالاتر) را از قبل نصب شده داشته باشد.

dotnet publish -c Release

dotnet YourApp.dll

• مزیت: برنامه شما روی هر سرور لینوکسی (با معماری یکسان) اجرا می‌شود، بدون هیچ پیش‌نیازی.
• عیب: حجم خروجی به مراتب بیشتر است (معمولاً بالای ۶۰ مگابایت).

dotnet publish -c Release --self-contained -r linux-x64

chmod +x ./YourApp
./YourApp

• ReadyToRun (R2R): این گزینه کدهای شما را از زبان میانی (IL) به کد ماشین (Native Code) کامپایل می‌کند. این کار سرعت اجرای اولیه‌ی برنامه (startup time) را به شدت افزایش می‌دهد، اما حجم خروجی را کمی بیشتر می‌کند. این گزینه را می‌توان با هر دو مدل بالا ترکیب کرد.

# مثال با مدل Self-Contained
dotnet publish -c Release --self-contained -r linux-x64 -p:PublishReadyToRun=true

• فایل اجرایی واحد (Single File Executable): این گزینه تمام فایل‌های خروجی (شامل Runtime در حالت Self-Contained) را در یک فایل اجرایی واحد جمع می‌کند که جابجایی و اجرای آن را بسیار ساده می‌کند.

# مثال با هر دو بهینه‌سازی
dotnet publish -c Release --self-contained -r linux-x64 -p:PublishReadyToRun=true -p:PublishSingleFile=true

sudo nano /etc/systemd/system/kestrel-myapp.service

[Unit]
Description=My Cool ASP.NET Core App running on Linux

[Service]
# مسیر پوشه‌ای که فایل‌های منتشر شده‌ی برنامه در آن قرار دارد
WorkingDirectory=/var/www/myapp

# دستوری که برای اجرای برنامه استفاده می‌شود
# اگر از مدل Self-Contained استفاده کردید: ExecStart=/var/www/myapp/YourApp
# اگر از مدل Framework-Dependent استفاده کردید: ExecStart=/usr/bin/dotnet /var/www/myapp/YourApp.dll
ExecStart=/var/www/myapp/YourApp

# سرویس همیشه باید ری‌استارت شود، مگر اینکه به صورت دستی متوقف شود
Restart=always
# زمان انتظار قبل از ری‌استارت در صورت بروز خطا (به ثانیه)
RestartSec=10
# کاربر و گروهی که برنامه با دسترسی آن‌ها اجرا می‌شود (برای امنیت بیشتر)
User=www-data
Group=www-data
# متغیرهای محیطی مورد نیاز برنامه (مثلاً برای حالت پروداکشن)
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

• بارگذاری مجدد systemd برای شناسایی سرویس جدید:
• sudo systemctl daemon-reload
• فعال‌سازی سرویس (برای اجرای خودکار پس از بوت):
• sudo systemctl enable kestrel-myapp.service
• اجرای فوری سرویس:
• sudo systemctl start kestrel-myapp.service
• بررسی وضعیت سرویس:
• sudo systemctl status kestrel-myapp.service
• مشاهده لاگ‌های زنده برنامه:
• sudo journalctl -fu kestrel-myapp.service

• یکپارچگی: دیگر نگران نصب بودن یا نبودن نسخه‌ی صحیح دات‌نت روی سرور نیستید.
• ایزوله‌سازی: هر کانتینر محیط ایزوله‌ی خود را دارد و با سایر برنامه‌ها تداخلی ایجاد نمی‌کند.
• تکرارپذیری: با یک فایل به نام Dockerfile، می‌توانید ایمیج برنامه را بارها و بارها به صورت خودکار بسازید.

# ----- مرحله ۱: بیلد کردن برنامه (استفاده از ایمیج کامل SDK) -----
# از ایمیج رسمی .NET SDK به عنوان پایه‌ی بیلد استفاده می‌کنیم
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build-env
WORKDIR /app

# فایل‌های پروژه را کپی می‌کنیم
COPY *.csproj ./
# پکیج‌های نوگت را ریستور می‌کنیم
RUN dotnet restore

# تمام سورس کد را کپی می‌کنیم
COPY . ./
# برنامه را در حالت Release پابلیش می‌کنیم
RUN dotnet publish -c Release -o out


# ----- مرحله ۲: ساخت ایمیج نهایی (استفاده از ایمیج سبک Runtime) -----
# از ایمیج سبک ASP.NET Runtime استفاده می‌کنیم که برای اجرای برنامه کافی است
FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app

# فایل‌های پابلیش شده از مرحله‌ی بیلد را به این مرحله کپی می‌کنیم
COPY --from=build-env /app/out .

# مشخص می‌کنیم که برنامه روی کدام پورت داخل کانتینر گوش می‌دهد
EXPOSE 8080

# نقطه‌ی ورود یا دستوری که با اجرای کانتینر باید اجرا شود
ENTRYPOINT ["dotnet", "YourApp.dll"]

• docker build -t my-webapp .
• (-t my-webapp یک تگ یا نام برای ایمیج شما مشخص می‌کند)

• docker run -d -p 8080:8080 my-webapp
• -d: اجرای کانتینر در حالت detached (در پس‌زمینه).
• -p 8080:8080: پورت 8080 سیستم میزبان (Host) را به پورت 8080 کانتینر متصل (map) می‌کند. حالا با مراجعه به http://localhost:8080 می‌توانید اپلیکیشن را ببینید.