本文模拟一个比较完整的项目,包括前端(MVC), 后端(WebApi)和数据库(mssql-server-linux)。通过Docker Compose 定义,组合并执行它们。涉及到 Docker Compose 安装,命令,docker-compose.yml文件编写,WebApi 和 MVC 项目编写,Dockfile编写等
Docker Compose
简介
Docker Compose是Docker三剑客之一,用于定义和运行多个Docker容器应用,负责实现对 Docker 容器集群的快速编排。
我们可以通过Dockerfile定义一个单独的应用容器。然而在日常工作中,经常会碰到需要多个容器相互配合来完成某项任务的情况。例如要实现一个 Web 项目,除了 Web 服务容器本身,往往还需要再加上后端的数据库服务容器等。
Compose 恰好满足了这样的需求。它允许用户通过一个单独的 docker-compose.yml 配置板文件(YAML 格式)来定义一组相关联的应用容器。然后使用使用单个命令,就可以根据配置中创建并启动所有服务。
安装
curl 下载 Docker Compose
sudo curl -L https://github.com/docker/compose/releases/download/{{site.compose_version}}/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
替换{{site.compose_version}}为最新的版本号
赋执行权限
sudo chmod +x /usr/local/bin/docker-compose
测试是否安装成功
docker-compose --version
WebApi 项目
创建项目
参考微软示例Create a Web API 创建一个基于 net core 2.1的WebApi项目,命名为Todo.Api. 参照示例添加 model 和 database context。
在 ConfigureServices 里注册 database context.
services.AddDbContext<TodoContext>(options =>options.UseSqlServer(Configuration["ConnectionString"]));
参考微软示例Work with SQL Server LocalDB 添加 Seed 类并在Program.cs里面添加 seed initializer等。
只需要运行Add-Migration命令生成迁移。无需执行Update-Database命令,因为程序运行起来时候会通过context.Database.Migrate()来执行迁移。
编写Dockfile
FROM microsoft/dotnet:2.1-aspnetcore-runtimeWORKDIR /appEXPOSE 80/tcpENTRYPOINT ["dotnet", "Todo.Api.dll"]
Web MVC 项目
创建项目
创建一个基于 net core 2.1的Web MVC项目,命名为webMVC.
添加 Service 去调用 WebApi 开放的接口。
编写Dockfile
FROM microsoft/dotnet:2.1-aspnetcore-runtimeWORKDIR /appEXPOSE 80/tcpENTRYPOINT ["dotnet", "WebMVC.dll"]
编写 docker-compose.yml文件
image: 指定镜像或构建生成镜像的名字
build:构建生成镜像。context 指令指定 Dockerfile 所在文件夹的路径,dockerfile 指令指定 Dockerfile 文件名
environment:设置环境变量
ports:暴露端口信息。使用宿主端口:容器端口 (HOST:CONTAINER) 格式
volumes:数据卷所挂载路径设置。可以设置宿主机路径 (HOST:CONTAINER)
container_name:指定容器名称。默认将会使用 项目名称_服务名称_序号 这样的格式
depends_on:解决容器的依赖、启动先后的问题
详细请参考 Compose file version 3 reference
运行项目
在docker-compose.yml文件通目录下执行
docker-compose build
构建项目中的服务容器.
docker-compose build
通过
docker-compose up
创建,关联并启动服务.
docker-compose up
-d 在后台运行服务容器。
--scale SERVICE=NUM 创建服务的N个实例。
详细请参考 Compose (docker-compose) CLI reference
源代码
github
参考
compose gitHub
Quickstart: Compose and ASP.NET Core with SQL Server
Get Started Building Microservices with ASP.NET Core and Docker in Visual Studio Code
Docker Compose 项目