为博客添加对Docker的支持

03/25/2020 03:47:18 | China Standard Time

我的博客一直都部署在Windows的服务器上，为了方便以后更换Linux的服务器（换不换是一回事。。。。有这个功能就行了）方便部署和迁移。这一段给博客系统添加了对Docker的支持，方便以后更换服务器，不需要折腾环境什么的。这篇博客记录一下为webapp添加Docker支持所踩的一些坑。

## 环境
微软在Windows10 2004中新增了WSL2，Docker也推出了 [Docker Desktop WSL 2 backend](https://docs.docker.com/docker-for-windows/wsl-tech-preview/ "Docker Desktop WSL 2 backend") ，现在不是专业版Windows也可以通过此方法安装Docker，具体可以查看Docker官方的 [Docker Desktop WSL2 backend 文档](https://docs.docker.com/docker-for-windows/wsl-tech-preview/ "Docker Desktop WSL2 backend 文档") 进行安装。

当然你也可以手动在WSL2中安装Docker，具体可以看我前面的一篇博客[《在WSL2中使用Docker》](https://www.lllxy.net/Blog/Detail/21ffdf7f-103c-4236-a022-419e344b78e8 "在WSL2中使用Docker") 。

[![](https://corehome.oss-cn-shenzhen.aliyuncs.com/blogs/批注 2020-04-17 002334.jpg)](https://docs.docker.com/docker-for-windows/wsl-tech-preview/)

## 创建Dockerfile
 Dockerfile是docker中镜像文件的的描述文件，就是描述Docker容器是怎么构成的，一共就几个指令，看看文档就知道了，这里放个文档地址 [Dockerfile reference](https://docs.docker.com/engine/reference/builder/ "Dockerfile reference") ，常用的一般就那几个，如果你会Linux的Shell脚本（反正你只要会用Linux），接受起来都很容易。

这里就直接放我的DockerFile（默认的稍作修改）

> CoreHome.HomePage 的 Dockerfile

```bash
#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

RUN apt update
RUN apt install libgdiplus -y

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
WORKDIR /src
COPY ["CoreHome.HomePage/CoreHome.HomePage.csproj", "CoreHome.HomePage/"]
COPY ["CoreHome.Infrastructure/CoreHome.Infrastructure.csproj", "CoreHome.Infrastructure/"]
COPY ["CoreHome.Data/CoreHome.Data.csproj", "CoreHome.Data/"]
RUN dotnet restore "CoreHome.HomePage/CoreHome.HomePage.csproj"
COPY . .
WORKDIR "/src/CoreHome.HomePage"
RUN dotnet build "CoreHome.HomePage.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "CoreHome.HomePage.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "CoreHome.HomePage.dll","urls=http://*"]
```

基本上就是用默认的镜像，项目复制进去，发布一下，容器启动的时候运行

**注意**：我在中间执行了这个命令。
```bash
apt update
apt install libgdiplus -y
```
这个是因为我用到了System.Drawing.Common来生成验证码，结果抛了异常找不到这个。。。所以就装一下，如果你没有用System.Drawing就不需要这两行了，，，，

> CoreHome.Admin 的 Dockerfile

```bash
#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/core/sdk:3.1-buster AS build
WORKDIR /src
COPY ["CoreHome.Admin/CoreHome.Admin.csproj", "CoreHome.Admin/"]
COPY ["CoreHome.Infrastructure/CoreHome.Infrastructure.csproj", "CoreHome.Infrastructure/"]
COPY ["CoreHome.Data/CoreHome.Data.csproj", "CoreHome.Data/"]
RUN dotnet restore "CoreHome.Admin/CoreHome.Admin.csproj"
COPY . .
WORKDIR "/src/CoreHome.Admin"
RUN dotnet build "CoreHome.Admin.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "CoreHome.Admin.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "CoreHome.Admin.dll","urls=http://*"]
```

这个就是标准的ASP.NET Core默认的Dockerfile，设定一下容器对外端口，项目复制进去，生成一下，然后容器启动的时候运行项目。

**注意**：我在两个Dockerfile中启动的命令都添加了一个参数 **urls=http://*** 原因是打算使用 Nginx 进行反向代理，所以就不在443端口跑了，不过也必须加上这个参数。不加的话就443端口也跑，于是就会报错 ：
> Unable to start Kestrel. System.InvalidOperationException: Unable to configure HTTPS endpoint. No server certificate was specified, and the default developer certificate could not be found. 

意思就是让你在Kestrel上配置https证书（因为HomePage和Admin是子目录的关系），所以肯定不能这样干啊，所以就使用Nginx进行反向代理，在Nginx上配置https就好了。

当然，博客不止需要你的项目，还需要其他服务，比如数据库啊，还有上面提到的反向代理服务器Nginx。
所以就把镜像都先拉下来，DockerHub上面搜一下就有啦。

> Mysql
![]( https://corehome.oss-cn-shenzhen.aliyuncs.com/blogs/%E6%89%B9%E6%B3%A8%202020-04-17%20010333.jpg)
> Nginx
![](https://corehome.oss-cn-shenzhen.aliyuncs.com/blogs/%E6%89%B9%E6%B3%A8%202020-04-17%20010412.jpg)

## 容器编排
有人可能这时候就要问了，webapp和数据库不在同一个容器里面，那要怎么样才能连接，难道要查询启动容器的IP然后再去另一个容器里面改连接字符串吗？？？

这个时候，你就需要了解一下容器编排工具了，[Docker-Compose](https://docs.docker.com/compose/ "Docker-Compose") 项目是Docker官方的开源项目，负责实现对Docker容器集群的快速编排。至于怎么安装，文档写的很清楚，这里放个链接 [Install Docker Compose](https://docs.docker.com/compose/install/ "Install Docker Compose")

其实你可以通过 **docker run --link** 来解决这个问题，它可以用来连接两个容器，使这两个容器之间可以互相通信。这样做的话，两三个容器还好，如果数量很多那就比较麻烦了，而且官方好像也并不推荐这个。。。。那就按文档来，用 docker-compose 中的 [user-defined networks](https://docs.docker.com/compose/networking/ "user-defined networks") 。

[![](https://corehome.oss-cn-shenzhen.aliyuncs.com/blogs/%E6%89%B9%E6%B3%A8%202020-04-17%20012114.jpg)](https://docs.docker.com/compose/compose-file/#links)

我也有点迷，反正按文档抄就完了，奥里给，干了！！！

[![](https://corehome.oss-cn-shenzhen.aliyuncs.com/blogs/%E6%89%B9%E6%B3%A8%202020-04-17%20012923.jpg)](https://docs.docker.com/compose/networking/#configure-the-default-network)

这里直接放上我的docker-compose.yml

```yaml
version: '3.4'

services:

  database:
    image: mysql
    command: --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: lxy15937905153
    volumes:
    - db:/var/lib/mysql

  corehome.homepage:
    image: ${DOCKER_REGISTRY-}corehomehomepage
    build:
      context: .
      dockerfile: CoreHome.HomePage/Dockerfile
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://*:80
    depends_on:
      - database
    restart: always
    volumes:
    - server:/home

  corehome.admin:
    image: ${DOCKER_REGISTRY-}corehomeadmin
    build:
      context: .
      dockerfile: CoreHome.Admin/Dockerfile
    environment:
      - ASPNETCORE_ENVIRONMENT=Production
      - ASPNETCORE_URLS=http://*:80
    depends_on:
      - database
    restart: always
    volumes:
    - server:/home

  reverse-proxy:
    image: nginx
    depends_on:
      - corehome.homepage
      - corehome.admin
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./default.conf:/etc/nginx/conf.d/default.conf

volumes:
  db:
  server:
```

这里介绍一下，一共定义了四个服务，database，corehome.homepage，corehome.admin，reverse-proxy
每个服务都包含了image，定义了这个服务需要的镜像

有人可能会发现我好像并没按文档写的，去定义一个networks，其实当docker-compose up时，默认会帮你创建一个网络，包含了services中的所有服务，你可以inspect查看一下那个网络。。。😂

> 这里说明一下volumes，说白了就是存储状态保持，因为容器更新或删除之后，里面的数据都会丢失，所以可以通过创建volumes，将volumes挂载到容器中，这样只要卷不被删除，数据就不会丢失，当然还有一个作用就是共享存储。

我的docker-compose.yml中定义了两个卷，db和server，db其实就是mysql的存储，挂载在database容器中的 /var/lib/mysql 位置，db则是用于保存homepage和admin共享的一些配置文件，挂载在corehome.homepage和corehome.admin的 /home 目录下

**还有！！！！数据库连接字符串需要注意！！！！** 连接字符串中的host要改为服务名（就像database，corehome.homepage，corehome.admin，reverse-proxy这些）
如果原本你的连接字符串是
> server=**localhost**;user id=root;password=lxy15937905153;database=articles

现在需要改为
> server=**database**;user id=root;password=lxy15937905153;database=articles

因为当docker-compose up创建容器时，会将服务名和对应的容器的IP写到host里 ？？？？？（我猜的）反正记得改就对了，不改的话你肯定连接不上数据库的😛。。。

最后再来介绍一下reverse-proxy服务，其实就是反向代理服务器，外部80端口对应容器内部80端口，外部443对应容器内部443（对外暴漏的端口:容器内部的端口），这个服务也挂载了一个卷，其实就是用来配置反向代理的，将 ./default.conf （当前目录下的default.conf）挂载到容器中的 /etc/nginx/conf.d/default.conf 这样就完成了反向代理的配置，所以你需要在docker-compose.yml的同级目录下创建一个default.conf里面写反向代理的配置，这里直接挂上我的。

```json
server {
    listen        80;

    location / {
        proxy_pass         http://corehome.homepage/;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection $http_connection;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }

    location ~* /admin {
        proxy_pass         http://corehome.admin;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection $http_connection;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
}
```

**注意**一下请求转发的地址要用服务名，理由我在前面**数据库连接字符串**那说过了

接下来在docker-compose.yml的目录下执行 **docker-compose up** 就可以了，然后你就会发现报错了，连不上数据库。
这个不是你配置的问题，时因为webapp启动了，数据库还没启动好，所以就连不上了，这时候你只需要加上depends_on，配置好依赖关系，启动顺序就不会出问题了，所有服务就都跑起来了。