راه‌اندازی استک نرم‌افزاری MySql/Asp.Net Core/PHP/Redis توسط داکر (۱)

داکر یه پلتفرم متن‌باز برای توسعه (development) و استقرار (deployment) نرم‌افزارهاست. تو داکر هر سرویس یا نرم‌افزار رو میشه روی یک محیط ایزوله که بهش Container گفته میشه اجرا کرد که کارایی Container ها به شدت از ماشین‌های مجازی بهتره.

تو این نوشته، میخوایم نحوهٔ راه‌اندازی یک استک نرم‌افزاری که شامل یک سرور Asp .Net Core، یک سرور MySql، یک سرور PHP و یک سرور Redis هست رو با استفاده از Docker Compose شرح بدیم. در ضمن، کدها و کانفیگ‌های توضیح داده‌شده در این مطلب، به طور کامل تو این ریپازیتوری گیت‌هاب موجوده.

راه‌اندازی Docker و Docker Compose

با استفاده از دستور زیر، به راحتی می‌تونید docker و docker-compose رو روی سیستم لینوکسی‌تون نصب کنید.

> curl -sSL https://get.docker.com/ | sh
> sudo apt install docker-compose

راه‌اندازی سرور Asp .Net Core

قبل از شروع، باید dotnet cli رو نصب کنید. نحوهٔ نصب این نرم‌افزار رو می‌تونید تو این لینک ببینید.

حالا باید Solution پروژه رو بسازیم و یک پروژهٔ Web API بهش اضافه کنیم. این کار با استفاده از کامند زیر قابل انجامه:

> dotnet new sln -n SimpleWebApi -o aspnetcore
> cd aspnetcore
> dotnet new webapi -n SimpleWebApi -o SimpleWebApi
> dotnet sln add SimpleWebApi

حالا فایل‌های پروژه ساخته شده و می‌تونیم سرور رو آماده کنیم. تو این سرور، می‌خوایم یک مدل Note داشته باشیم که شامل عنوان و متنه، و برای اضافه کردنش به دیتابیس یا خوندن Note هایی که داریم API بنویسیم.

اول از همه مدلمون رو تو مسیر aspnetcore/SimpleWebApi/Models/Note.cs می‌نویسیم.

using System.ComponentModel.DataAnnotations.Schema;

namespace SimpleWebApi.Models
{
    public class Note
    {
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
        public int Id { get; set; }
        public string Title { get; set; }
        public string Text { get; set; }
    }
}

حالا باید برای این مدل، DbContext بنویسیم که بشه اون رو تو دیتابیس MySql مون نوشت یا ازش خوند.

قبل از هر چیزی، باید پکیج‌های مورد نیاز رو به پروژه اضافه کنیم.

> dotnet add SimpleWebApi package MySql.Data
> dotnet add SimpleWebApi package MySql.Data.EntityFrameworkCore
> dotnet add SimpleWebApi package EntityFramework
> dotnet add SimpleWebApi package Microsoft.EntityFrameworkCore.Tools

حالا DbContext رو تو فایل aspnetcore/SimpleWebApi/MySql/MySqlDbContext.cs می‌نویسیم.

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using SimpleWebApi.Models;

namespace SimpleWebApi.MySql
{
    public class MySqlDbContext : DbContext
    {
        private readonly IConfiguration config;

        public MySqlDbContext(IConfiguration config)
        {
            this.config = config;
            Database.EnsureCreated();
        }

        public DbSet<Note> Notes { get; set; }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            var connectionString = $&quotServer={config[&quotDB_HOST&quot]};Database={config[&quotDB_DATABASE&quot]};port=3306;user={config[&quotDB_USER&quot]};password={config[&quotDB_PASSWORD&quot]}&quot
            optionsBuilder.UseMySQL(connectionString);
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);

            modelBuilder.Entity<Note>(entity =>
            {
                entity.HasKey(e => e.Id);
                entity.Property(e => e.Title)
                    .IsRequired()
                    .HasMaxLength(100);
                entity.Property(e => e.Text)
                    .IsRequired()
                    .HasColumnType(&quotTEXT&quot);
            });
        }
    }
}

همونطور که می‌بینید، تو خط ۲۱ که connection string رو ساختیم، مشخصات دیتابیس از کانفیگ خونده می‌شه که در ادامه می‌بینیم چجوری.

حالا باید کانفیگ‌ها، و DbContext ای که نوشتیم رو به سرویس‌های Web App اضافه کنیم. قبل از همه، باید به Asp .Net Core بگیم که متغیرهای محیطی‌ای که با DOTNET_ شروع میشن رو برامون بعنوان کانفیگ در نظی بگیره. برای این کار، تو Program.cs، تابع CreateHostBuilder رو به صورت زیر تغییر میدیم.

public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            config.AddEnvironmentVariables(prefix: &quotDOTNET_&quot);
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

و بعد هم تو Startup.cs، دو خط زیر رو به تابع ConfigureServices اضافه می‌کنیم.

services.Configure<IConfiguration>(Configuration);
services.AddDbContext<MySqlDbContext>();

و خط زیر رو هم از تابع Configure حذف می‌کنیم که سرور، request ها رو مجبور به استفاده از https نکنه.

app.UseHttpsRedirection();

در قدم آخر هم، باید Api Controller مون رو بنویسیم. این کنترلر، یک API برای اضافه کردن یک Note و یک API برای گرفتن لیست تمام Note ها داره. قبل از نوشتن API ها، برای API اضافه کردن Note، باید یک DTO بنویسیم.

namespace SimpleWebApi.ApiParameters
{
    public class NoteParameter
    {
        public string Title { get; set; }
        public string Text { get; set; }
    }
} 

کنترلر رو هم باید تو مسیر aspnetcore/SimpleWebApi/Controllers/NotesController.cs بسازیم.

using Microsoft.AspNetCore.Mvc;
using SimpleWebApi.ApiParameters;
using SimpleWebApi.Models;
using SimpleWebApi.MySql;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace SimpleWebApi.Controllers
{
    [ApiController]
    [Route(&quot[controller]&quot)]
    public class NotesController : Controller
    {
        private readonly MySqlDbContext dbContext;
        
        public NotesController(MySqlDbContext dbContext) => this.dbContext = dbContext;

        [HttpPost]
        public async Task Post([FromBody] NoteParameter parameter)
        {
            var note = new Note
            {
                Title = parameter.Title,
                Text = parameter.Text
            };

            await dbContext.Notes.AddAsync(note);
            await dbContext.SaveChangesAsync();
        }

        [HttpGet]
        public IEnumerable<Note> Get() => dbContext.Notes.ToList();
    }
}

همونطور که می‌بینید، دو تا API داریم که بصورت زیر میشه ازشون استفاده کرد.

POST /notes
{
    &quottitle&quot: &quottitle&quot,
    &quottext&quot: &quottext&quot
}

GET /notes

خب تبریک میگم. سرور Asp Net Core حاضره. حالا کافیه که این سرور رو برای داکر کانفیگ کنیم. اول باید براش یه Dockerfile بنویسیم. این فایل رو تو مسیر aspnetcore/Dockerfile می‌سازیم.

FROM mcr.microsoft.com/dotnet/sdk:3.1 AS build
WORKDIR /app

# copy csproj and restore as distinct layers
COPY *.sln .
COPY SimpleWebApi/*.csproj ./SimpleWebApi/
RUN dotnet restore

# copy everything else and build app
COPY SimpleWebApi/. ./SimpleWebApi/
WORKDIR /app/SimpleWebApi
RUN dotnet publish -c Release -o out

FROM mcr.microsoft.com/dotnet/aspnet:3.1 AS runtime
WORKDIR /app
COPY --from=build /app/SimpleWebApi/out ./
ENTRYPOINT [&quotdotnet&quot, &quotSimpleWebApi.dll&quot]

تو این فایل، اول فایل‌های csproj رو منتقل می‌کنیم به container، و در ادامه پکیج‌های لازم رو restore می‌کنیم. بعد اپلیکیشن رو build می‌کنیم و کامند مربوط به اجرای اپلیکیشن رو مشخص می‌کنیم. حالا باید فایل docker-compose.yml رو تو دایرکتوری اصلی پروژه بسازیم و دیتابیس MySql و سرور AspNetCore مون رو بهش اضافه کنیم.

version: '3.3'
services:
  aspnetcore:
    image: amadev/aspnetcore
    container_name: amadev-aspnetcore
    build: ./aspnetcore/
    depends_on:
      - database
    environment:
      - DOTNET_DB_HOST=database
      - DOTNET_DB_USER=root
      - DOTNET_DB_DATABASE=amadev_database
      - DOTNET_DB_PASSWORD=${MYSQL_ROOT_PASSWORD}
      - DOTNET_URLS=http://*
    ports:
      - 5000:80
  database:
    image: mysql:latest
    container_name: amadev-mysql
    environment:
      - MYSQL_ROOT_PASSWORD
    volumes:
      - ./db-data:/var/lib/mysql

همونطور که می‌بینید، کانتینر aspnetcore وابسته‌ست به database، و متغیرهای محیطی مربوط به دیتابیس و پورت اپلیکیشن توش مشخص شده. کانتینر database هم از image مربوط به mysql استفاده می‌کنه، که هنگام بیلد کردن پروژه برای اولین بار، داکر دانلودش می‌کنه. فایل‌های مربوط به دیتابیس هم تو مسیر db-data ذخیره میشن.

حالا با ران کردن دستور زیر، کانتینرها شروع به کار می‌کنن و سرور راه‌اندازی میشه.

> sudo docker-compose up --build

از اونجایی که پورت aspnetcore روی 5000 قرار داده شده، از طریق http://localhost:5000 قابل دسترسیه.

ممنون از این که تا اینجا با این مطلب همراه بودید. ادامهٔ این نوشته و اضافه کردن سرور PHP و Redis رو، می‌تونید از اینجا به قلم مبینا پورنعمت و آرمان زارعی بخونید.