微信小程序和asp.net core基于docker和nginx的交互

这个文章的题目起的比较长，我想实现这样一个产品：

前端是微信小程序，后端是基于docker运行的asp.net core webapi。webapi通过nginx实现的反向代理接入，nginx同样基于docker来运行。开撸！

准备工作

1、微信小程序注册账号

微信小程序注册有一个限制，一个邮箱只能注册一个小程序。我用的qq邮箱，因为之前使用qq邮箱的默认账号注册过一个，但是qq邮箱可以针对同一个邮箱设置不同的账户（好像是三个），所以可以先设置一个额外的账号，然后通过这个账号来注册小程序

2、购买服务器

你要建立api必须得有一台服务器，我从腾讯云申请了一台免费的（3个月）2核心4G的服务器。

3、申请域名

申请域名是有一个原因的，你可以参考看看是不是否和你的条件，否则，你可以跳过这步。我的原因是首先小程序如果要接入api这个api必须是一个https的连接，https的连接涉及到ssl/tls证书,我采用let's encrypt来获取证书。但是let's encrypt不允许使用ip地址来获取证书，需要域名。所以，我又申请了一个域名。域名申请在腾讯云官网完成，花了45（原价55，10块的代金券）块钱申请了一个域名，有效期一年。但是需要注意你申请域名的时候必须得先有一台服务器。服务器用于一个公网ip。

4、申请ssl/tls证书

当你完成购买服务器和申请域名的步骤后，可以开始申请证书了。我的证书是通过let's encrypt来申请的，let's encrypt发布了一个certbot的工具，通过certbot来对证书进行获取和管理。certbot的网址是https://certbot.eff.org/

当然还有很多其他的工具，比如certbot-auto和acme.sh等，这里不做过多介绍，百度吧。

首先是安装certbot，我是用的是centos7，certbot是包含在epel（extra packges for enterprise linux）中的，所以需要安装epel包源，另外，需要python的运行环境。在centos7中，这些默认都有，所以，我直接运行

sudo yum install certbot 

就完成了安装。

关于epel的官网在这里：https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F 你可以对照你的操作系统来查看如何安装这个包源。

关于certbot的官网在这里：https://certbot.eff.org/lets-encrypt/centosrhel7-nginx 你可以查看相关文档。

安装好之后就是获取证书的环节了：

certbot certonly

键入上述命令后，根据提示操作，很快就会完成，然后在/etc/letsencrypt/live/you.domain.com下面会有你的证书和证书对应的key证书和key都是pem文件，证书的名字是fullchain.pen，key的名字是privkey.pem.

5、安装docker

docker：https://docs.docker.com/install/

windows开发机上的docker安装过程省略。下面是服务器（centos7.2）的安装步骤

centos安装docker的条件是系统在7以上，并且开通了centos-extras包源，它默认是开启的。从https://wiki.centos.org/AdditionalResources/Repositories上面可以查看centos关于这方面的一些信息。确认完上述信息后，按照一下步骤来完成安装：

  sudo yum install -y yum-utils \
  device-mapper-persistent-data \
  lvm2

yum-utils提供了 yum-config-manager 这个工具，而device-mapper-persistent-data 和lvm2对于devicemapper存储驱动程序来说是必须的。然后配置包源：

sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

然后安装docker：

sudo yum install docker-ce docker-ce-cli containerd.io

安装文档在这里：https://docs.docker.com/install/linux/docker-ce/centos/ 不细说了。

6、安装nginx

我的nginx是通过docker来安装的。

docker pull nginx

上述命令会安装最新版的nginx docker镜像。

关于nginx的docker镜像可以参考我翻译的一篇文章。

nginx的主配置文件是/etc/nginx/nginx.conf，子配置文件在/etc/nginx/conf.d/default.conf主配置文件会使用include指令来调用子配置文件。

当使用nginx镜像时，我们在宿主系统上写好配置，然后通过将容器的目录挂载到宿主的相应目录上即可。

7、创建asp.net core api应用并制作镜像

我创建了一个asp.net core 的webapi，这个web服务监听了5000端口：

它的本地目录是这样的：

Source目录是这样：

列出目录的主要目的是要书写Dockerfile。Dockerfile里面有对路径的操作。Source目录里面放的就是api的工程文件了。Source目录的上一级放了Dockerfile文件，Dockerfile文件内容如下：

FROM microsoft/dotnet:2.2-sdk-alpine AS dotnetcore-sdk #以这个镜像为基础镜像
WORKDIR /source #定义工作路径，下面的命令都是以这个工作路径为基础
#复制工程文件
COPY Source/Widget.Application/Widget.Application.csproj ./Widget.Application/ #COPY命令有两个参数，第一个参数是宿主的目录，第二个参数是镜像上面的目录，如果是相对路径，那都是相对于WORKDIR的
COPY Source/Widgets.Core/Widgets.Core.csproj ./Widgets.Core/
COPY Source/Widgets.Domain/Widgets.Domain.csproj ./Widgets.Domain/
COPY Source/Widgets.Infrastructure/Widgets.Infrastructure.csproj ./Widgets.Infrastructure/
COPY Source/Widgets.UI/Widgets.UI.csproj ./Widgets.UI/
#执行命令
RUN dotnet restore ./Widgets.UI/Widgets.UI.csproj
#将Source目录复制到镜像中(WORKDIR指定的目录下)
COPY Source .

#构建和发布
FROM dotnetcore-sdk as dotnetcore-publish #以上一个FROM子句制作好的镜像为基础镜像，并给了这个镜像一个新的命名
RUN dotnet publish  ./Widgets.UI/Widgets.UI.csproj -c Release -o /publish #执行publish命令并将发布的内容放到容器内的/publish目录下

#ASP.NET CORE RUNTIME 用上一步发布好的dotnet core镜像作为基础镜像
FROM microsoft/dotnet:2.2-aspnetcore-runtime-alpine AS aspnetcore-runtime
WORKDIR /app #定义工作目录
COPY --from=dotnetcore-publish /publish . #--from=dotnetcore-publish这个参数说明COPY的第一个参数是从哪里复制的
EXPOSE 5000 #对外暴露5000端口
ENTRYPOINT [ "dotnet","Widgets.UI.dll" ] #镜像启动时执行的命令

上面就是这个dockerfile做的工作。里面有详细说明。我们从这个dockerfile构建一个镜像出来：

docker build -t widgets:1.0 .

上面的命令是在dockerfile这个目录下执行的，必须从这里执行，最后面有一个点，表示的就是执行路径。-t参数指明了镜像的名称和标签。

构建完镜像后，需要吧镜像上传到服务器，我没有构建私有仓库，我采用docker image save的方式将镜像保存成tar文件：

docker image save widgets:1.0 C:\\registry\widgets.tar

我将这个镜像保存成一个tar文件，然后上传到云服务器，然后在云服务器上面，使用下面命令将tar文件还原成镜像：

docker image load -i /path/to/widgets.tar

这样就从tar文件还原了一个镜像，然后之后后续的步骤。

8、启动应用和nginx

我是分别做了两个镜像，一个是nginx的，一个是asp.net core的，nginx作为asp.net core的反向代理来使用。这两个镜像运行后得到两个容器。因为nginx容器要和asp.net core容器进行交互，所以我需要一种方式来实现这个需求，我采用的是docker network命令来创建一个桥，然后吧这两个应用都运行在这个桥上。具体如下：

首先是nginx：

docker run -d -p : --name nginx \
 --network=widgetsweb \
 --network-alias=nginx \
 -v /home/wallee/nginx/conf.d:/etc/nginx/conf.d \
 -v /home/wallee/nginx/nginx.conf:/etc/nginx/nginx.conf \
 -v /home/wallee/nginx/log:/var/log/nginx \
 -v /etc/letsencrypt:/etc/letsencrypt \
 nginx

解释一下这个命令的参数：

• -d:后台运行
• -p端口映射，从容器外部到容器内部的映射
• --name指定容器名称
• --network指定容器运行在那个桥，桥使用docker network create来创建的，这里桥的名称是widgetsweb
• --network-alias指定容器运行的桥的别名，这个别名在nginx的配置中有用
• 第一个-v 将宿主上的conf.d挂载到容器的conf.d上，包含了default.conf这个子配置文件
• 第二个-v将宿主上的nginx.conf挂载到容器的的nginx.conf文件中，包含了nginx的主配置文件
• 第三个-v将宿主上的log文件挂载到容器的log，包含了access.log和error.log
• 第四个-v将宿主上的/etc/letsencrypt挂载到容器的/etc/letsencrypt上，包含了证书（ssl）的相关信息

然后启动asp.net core容器：

docker run -d -p :  --name widgetsweb \
--network=widgets  \
--network-alias=widgetsweb \
widgets:1.0

我将容器内的5000端口映射到外部的5000端口，并将容器运行到widgets这个桥上，这样，asp.net core容器和nginx容器都在一个桥上，实现了互通信息的目的。然后，我给asp.net core 容器的桥起了一个别名，这个别名在nginx的配置中有用，下面来看看nginx的配置文件是怎杨的：

user  nginx;
worker_processes  ;

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;

events {
    worker_connections  ;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';

    access_log  /var/log/nginx/access.log  main;

    sendfile        on;
    #tcp_nopush     on;

    keepalive_timeout  ;

    #gzip  on;

    include /etc/nginx/conf.d/*.conf;
}

这个nginx的主配置文件分了几个模块:

events模块主要定义了工作者进程的连接数，https模块定义了一些在http模块上下文的全局参数如日志格式，长连接过期时间等，然后它里面有一个include指令，这个指令将conf.d文件夹下的defualt.conf文件包含了进来，default.conf文件的内容如下：

upstream widgets{
server widgetsweb:;
}
server{
    listen   ssl;
    server_name www.bankskit.com;
    ssl_certificate /etc/letsencrypt/live/www.bankskit.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/www.bankskit.com/privkey.pem;
    location / {
        proxy_pass         http://widgets;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }

}

upstream模块定义了上游服务器的一些信息，upstream主要用来做负载均衡，这里面只定义了一台服务器，这个服务器就是asp.net core容器运行的服务。注意看这句：

server widgetsweb:5000

widgetsweb这个就是运行asp.net core容器时给这个容器的桥器的别名。这里配置成这样是生效的。

在server模块中定义了监听的地址（https的标准端口）和ssl证书以及证书的密钥。location模块中定义了代理的地址，proxy_pass http://widgets这句话中的widgets是upstream后面定义的名称。

到此主要的配置已经完成。

然后在浏览器上访问你的网站已经成功。

然后就需要在微信小程序中将你申请好的域名配置到里面，然后你的小程序就能访问你建立好的api了