.Net Core in Docker極簡入門(下篇)


Tips:本篇已加入系列文章閱讀目錄,可點擊查看更多相關文章。

前言

上一篇【.Net Core in Docker極簡入門(上篇)】講解了docker的一些基本命令和操作,並成功構建了自己的asp.net core web應用的鏡像,啟動容器。本篇繼續。

開始

上一篇的項目例子非常簡單,通常我們的實際項目要復雜的多。項目中會依賴各種組件服務,比如數據庫,MQ,緩存等等。這就會涉及到多個容器,如果手動用docker命令去一個一個的啟動就很麻煩了,那么這時候就可以使用Docker-Compose來完成多個容器的管理。

Docker-Compose

什么是Docker Compose?

Compose 是用於定義和運行多容器 Docker 應用程序的工具。通過 Compose,您可以使用 YML 文件來配置應用程序需要的所有服務。然后,使用一個命令,就可以從 YML 文件配置中創建並啟動所有服務。

簡單來理解,Compose類似一個批量工具,可以執行一組命令,支持批量構建鏡像,批量啟動容器,批量刪除容器等等功能。

Windows的Docker Desktop中已經包括了Compose,Linux下Compose則需要單獨安裝一下。

下面在項目中添加一些數據庫操作的相關代碼便於測試,使用EF Core+SQL Server。

代碼修改

安裝EF Code相關的包:

修改代碼:

public class WeatherForecast
{
    [Key]
    public int Id { get; set; }

    public DateTime Date { get; set; }

    public int TemperatureC { get; set; }

    public int TemperatureF { get; set; }

    public string Summary { get; set; }
}
public class DemoContext : DbContext
{
    public DemoContext(DbContextOptions<DemoContext> options)
        : base(options)
    {

    }

    public DbSet<WeatherForecast> WeatherForecasts { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);
        //初始化種子數據
        modelBuilder.Entity<WeatherForecast>().HasData(new WeatherForecast
        {
            Id = 1,
            Date = DateTime.Now,
            Summary = "none",
            TemperatureC = 20,
            TemperatureF = 32 + (int)(20 / 0.5556)
        }, new WeatherForecast
        {
            Id = 2,
            Date = DateTime.Now.AddDays(1),
            Summary = "none",
            TemperatureC = 25,
            TemperatureF = 32 + (int)(25 / 0.5556)
        });
    }
}
public class Startup
{
    ......
        
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();

        services.AddDbContext<DemoContext>(opt => opt.UseSqlServer(Configuration.GetConnectionString("DemoContext")));
    }
    
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env, DemoContext context)
    {
        //自動遷移
        context.Database.Migrate();

        ......
    }
}
public class WeatherForecastController : ControllerBase
{
    private readonly ILogger<WeatherForecastController> _logger;
    private readonly DemoContext _context;

    public WeatherForecastController(ILogger<WeatherForecastController> logger, DemoContext context)
    {
        _logger = logger;
        _context = context;
    }

    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
        return _context.WeatherForecasts.ToArray();
    }
}

appsettings.json添加數據庫連接字符串配置:

{
  ......
  
  "ConnectionStrings": {
    "DemoContext": "Server=sql-server;Database=DemoDB;User Id=sa;Password=Password@2020;"
  }
}

注意:Server=sql-server,這個sql-server是需要在docker-compose.yml中定義的,下面再說。

添加遷移:

yml file

右鍵項目-添加-容器業務流程協調程序支持

添加后會生成docker-compose相關文件:

其中的docker-compose.yml文件需要修改一下:

version: '3.4'

services:
  webapplication1:
    image: ${DOCKER_REGISTRY-}webapplication1
    build:
      context: .
      dockerfile: WebApplication1/Dockerfile
    ports: 
      - '5000:80'
    networks:
      - my-net
    depends_on:
      - sql-server

  sql-server:
    image: mcr.microsoft.com/mssql/server:2019-CU5-ubuntu-18.04
    ports: 
      - '1434:1433'
    environment: 
      ACCEPT_EULA: Y
      SA_PASSWORD: Password@2020
    networks: 
      - my-net

networks: 
  my-net: 
    driver: bridge 

services下定義了2個服務webapplication1、sql-server,相當於2個容器。webapplication1是基於WebApplication1/Dockerfile構建的鏡像${DOCKER_REGISTRY-}webapplication1來啟動,depends_on用於指定依賴的服務,這里的webapplication1服務依賴於sql-server服務。networks用於指定網絡,因為docker中容器之間默認是無法直接通信的,這里創建了一個bridge模式的網絡my-net,webapplication1和sql-server都在my-net網絡中,那么他們之間就可以通過服務名來通信。所以在上面webapplication1的數據庫連接字符串中就可以寫:Server=sql-server。通常數據庫的數據目錄會掛載到主機上,防止容器發生意外導致數據丟失。

上一篇有小伙伴問容器內能不能訪問容器外的數據庫,這個是可以訪問的。訪問宿主機的話直接用IP訪問就可以,或者用host.docker.internal,這個host.docker.internal是docker安裝時會寫入到你的hosts文件里的一個主機名,實際還是指向你的主機IP。

以上的yml內容還是比較簡單,yml文件是使用Compose必不可少的,語法可以自行學習一下。掌握其語法關鍵字后,你就可以在docker-compose.yml文件中定義更復雜的環境。

up & down

來到項目根目錄,啟動PowerShell或cmd執行docker命令。

執行docker-compose up,也可以加-d參數,讓他在后台運行

啟動完成后,瀏覽器訪問:http://localhost:5000/weatherforecast

成功。這里省略了docker-compose build命令,你也可以在up前先執行build。

docker-compose是不是很方便呢,即使你的系統環境部署再復雜,也只需要一個up指令。

如果你想摧毀這個環境只需要執行docker-compose down即可

同樣的,以上操作也可以直接在vs2019中完成,無需手動執行指令,只需要將docker-compose項目設為啟動項,然后直接運行即可,還支持代碼調試哦。不過由於網絡等問題,可能會遇到一些坑。。。

鏡像倉庫

我們也可以把自己的鏡像推送到遠程倉庫,然后在其他機器上直接就能通過命令拉取了。國內阿里雲之類的都有docker鏡像倉庫服務,也可以搭建私有倉庫,本文就推送到docker的官方倉庫docker hub。首先需要在docker官網https://www.docker.com/注冊賬號。

重新構建鏡像:docker build -t xhznl/webapp1 -f ./WebApplication1/Dockerfile .

其中xhznl是我的docker用戶名。

登錄docker: docker login,輸入自己的用戶名密碼。

登錄成功后即可推送鏡像,執行:docker push xhznl/webapp1

推送成功,在docker官網可以查看鏡像:

這樣在其他機器的docker中也可以通過docker pull xhznl/webapp1來拉取這個鏡像。

修改docker-compose.yml文件,將webapplication1服務的image改為xhznl/webapp1,然后把這個docker-compose.yml文件放到任何裝有docker的機器上,只需執行docker-compose up,即可啟動程序的所有環境,是不是很神奇。

services:
  webapplication1:
    image: xhznl/webapp1
    ports: 
      - '5000:80'
    networks:
      - my-net
    depends_on:
      - sql-server

最后推薦一波vs code,安裝docker相關插件,無論是編寫yml文件還是管理docker都很方便, 很多操作都不用手敲命令啦。。。

最后

Docker作為當今最流行的容器技術,是很多技術架構的基礎。它有很多的優點,使用中也會面臨各種問題,希望本篇入門文章能夠幫助到一些初學的小伙伴。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM