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

• نوشتن کد کراس-پلتفرم با رعایت تفاوت‌های فایل سیستم.
• مدیریت پیکربندی از طریق فایل json و متغیرهای محیطی.
• کانتینرسازی اپلیکیشن با استفاده از داکر و یک Dockerfile بهینه.
• استقرار نهایی اپلیکیشن روی یک سرور لینوکس به عنوان یک سرویس systemd پایدار.

dotnet new webapi -n MyTodoApi
cd MyTodoApi

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// یک لیست ثابت برای داده‌های نمونه
var todos = new List<Todo>
{
    new(1, "Learn .NET on Linux", false),
    new(2, "Build a Docker container", true)
};

// Endpoint برای گرفتن تمام کارها
app.MapGet("/todos", () => todos);

// Endpoint برای گرفتن یک کار با ID
app.MapGet("/todos/{id}", (int id) =>
{
    var todo = todos.FirstOrDefault(t => t.Id == id);
    return todo is not null ? Results.Ok(todo) : Results.NotFound();
});

app.Run();

// یک کلاس ساده برای مدل داده
public record Todo(int Id, string Title, bool IsCompleted);

dotnet run

"WelcomeMessage": "Hello from appsettings.json!"

// این خط را بعد از app.MapGet(...) اضافه کنید
app.MapGet("/", (IConfiguration config) => config["WelcomeMessage"]);

// لاگ‌نویسی در یک مسیر امن
try
{
    // مسیر پوشه ApplicationData را در هر سیستم‌عاملی به درستی پیدا می‌کند
    var appDataPath = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
    // یک پوشه برای اپلیکیشن ما می‌سازد
    var logDirectory = Path.Combine(appDataPath, "MyTodoApiLogs");
    Directory.CreateDirectory(logDirectory);

    var logFilePath = Path.Combine(logDirectory, "startup.log");
    var logMessage = $"Application started at {DateTime.UtcNow} on {Environment.OSVersion}.{Environment.NewLine}";

    // از Environment.NewLine برای سازگاری با ویندوز و لینوکس استفاده می‌کند
    File.AppendAllText(logFilePath, logMessage);
    Console.WriteLine($"Startup log written to: {logFilePath}");
}
catch (Exception ex)
{
    Console.WriteLine($"Failed to write startup log: {ex.Message}");
}

app.Run(); // این خط باید در انتها باشد

# مرحله 1: بیلد کردن با SDK
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /source

COPY *.csproj .
RUN dotnet restore

COPY . .
RUN dotnet publish -c Release -o /app/out

# مرحله 2: ساخت ایمیج نهایی با Runtime
FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY --from=build /app/out .

# تعریف متغیر محیطی پیش‌فرض (می‌تواند هنگام اجرا تغییر کند)
ENV ASPNETCORE_URLS=http://+:80
ENV WelcomeMessage="Hello from Docker default environment!"

EXPOSE 80
ENTRYPOINT ["dotnet", "MyTodoApi.dll"]

docker build -t my-todo-api .

docker run -d -p 8080:80 -e WelcomeMessage="Hello from a LIVE Docker Container!" --name todo-api-instance my-todo-api

• به آدرس http://localhost:8080/todos بروید تا لیست کارها را ببینید.
• به آدرس http://localhost:8080 بروید. باید پیام "Hello from a LIVE Docker Container!" را مشاهده کنید.

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

• sudo nano /etc/systemd/system/my-todo-api.service
• محتوای زیر را در آن قرار دهید:

[Unit]
Description=MyTodoApi - ASP.NET Core Web API

[Service]
WorkingDirectory=/var/www/my-todo-api
ExecStart=/var/www/my-todo-api/MyTodoApi
Restart=always
RestartSec=10
SyslogIdentifier=my-todo-api
User=www-data
Group=www-data
# اینجا می‌توانید متغیرهای محیطی را برای override کردن تنظیمات قرار دهید
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ASPNETCORE_URLS=http://localhost:5001
Environment=WelcomeMessage="Hello from a systemd service!"

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable my-todo-api.service
sudo systemctl start my-todo-api.service
sudo systemctl status my-todo-api.service