.NET Core 3.1使用docker打包并部署

目录

• 简介
• 环境介绍
  • 开发环境
  • 部署环境
• 编写Dockerfile文件
• 生成Docker镜像
• 运行容器
• 访问接口
• 结语

简介

本文主要说明使用.NET Core 3.1搭建的站点如何使用docker打包并运行容器供外网访问。

环境介绍

开发环境

Windows 10

Visual Studio 2019

.NET Core 3.1

部署环境

CentOS 8

Docker 1.19.03

编写Dockerfile文件

将编写好的.NET Core项目发布至指定文件夹，在发布文件夹下添加名为Dokcerfile文件，需要注意此文件没有后缀，同时需要注意文件名的大小写，如下图所示：

对应的Dockerfile文件如下所示：

#引入镜像，低版本 docker 去掉  AS base
#换成别人做的阿里镜像
#FROM registry.cn-hangzhou.aliyuncs.com/newbe36524
FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base

#配置工作目录 相当于cd
WORKDIR /app

#暴露容器端口，此端口与程序运行路径一致，可
EXPOSE 5000

#复制文件到工作目录
COPY . .

#ENV ：配置系统环境变量，比如程序环境环境等在这里配置（开发、预发、线上环境）
#这里是配置程序运行端口，如果程序不使用默认的80端口这里一定要设置（程序运行端口）
ENV ASPNETCORE_URLS http://+:5000

#设置时间为中国上海，默认为UTC时间
ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

#启动程序
ENTRYPOINT ["dotnet", "DotNetCore.API.dll"]

生成Docker镜像

Dockerfile文件编写完成后，上传至CentOS目录下，如下所示：

[root@localhost web]# ll
total 376
-rw-r--r--. 1 root root    162 Aug 25 13:56 appsettings.Development.json
-rw-r--r--. 1 root root    192 Aug 25 13:56 appsettings.json
-rw-r--r--. 1 root root    850 Aug 27 00:55 Dockerfile
-rw-r--r--. 1 root root 106577 Aug 27  2020 DotNetCore.API.deps.json
-rw-r--r--. 1 root root   8192 Aug 27  2020 DotNetCore.API.dll
-rw-r--r--. 1 root root 174592 Aug 27  2020 DotNetCore.API.exe
-rw-r--r--. 1 root root  19480 Aug 27  2020 DotNetCore.API.pdb
-rw-r--r--. 1 root root    224 Aug 25 14:04 DotNetCore.API.runtimeconfig.json
-rw-r--r--. 1 root root  25088 Aug 27  2020 DotNetCore.API.Views.dll
-rw-r--r--. 1 root root  20032 Aug 27  2020 DotNetCore.API.Views.pdb
-rw-r--r--. 1 root root    558 Aug 27  2020 web.config
drwxr-xr-x. 5 root root     57 Aug 25 14:04 wwwroot

在此目录下执行构建docker镜像命令。

# 构建docker image
docker build -t apitest:v1 .

# 执行结果
Sending build context to Docker daemon  4.755MB
Step 1/8 : FROM mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim AS base
3.1-buster-slim: Pulling from dotnet/core/aspnet
bf5952930446: Pull complete
95f9f5484a21: Pull complete
ebc43d54b0d9: Pull complete
eb8b3fc30ae1: Pull complete
c42d79623507: Pull complete
Digest: sha256:3209fc5e97bcc9d4137d603baf7971475435a3760fbcbba13a4a13ecb973bdb8
Status: Downloaded newer image for mcr.microsoft.com/dotnet/core/aspnet:3.1-buster-slim
 ---> bdca989bc8d3
Step 2/8 : WORKDIR /app
 ---> Running in e1bc2cdcce7e
Removing intermediate container e1bc2cdcce7e
 ---> d115392570f1
Step 3/8 : EXPOSE 8001
 ---> Running in 7329d738bc32
Removing intermediate container 7329d738bc32
 ---> facb418c8e93
Step 4/8 : COPY . .
 ---> db32752819a7
Step 5/8 : ENV ASPNETCORE_URLS http://+:5000
 ---> Running in aa6129a3c24d
Removing intermediate container aa6129a3c24d
 ---> 26dbc37969a1
Step 6/8 : ENV TZ=Asia/Shanghai
 ---> Running in 5972afb49e7b
Removing intermediate container 5972afb49e7b
 ---> 8ba512fe33ac
Step 7/8 : RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
 ---> Running in 7af56acee843
Removing intermediate container 7af56acee843
 ---> 6063c7efb5e3
Step 8/8 : ENTRYPOINT ["dotnet", "DotNetCore.API.dll"]
 ---> Running in a5747e363825
Removing intermediate container a5747e363825
 ---> 490d51c5dfb0
Successfully built 490d51c5dfb0
Successfully tagged apitest:v1

此时，Docker镜像已经构建完成，可以查看下构建结果。

# 查看构建后的docker image
docker images

# 执行结果
REPOSITORY                             TAG                 IMAGE ID            CREATED             SIZE
apitest                                v1                  490d51c5dfb0        9 seconds ago       212MB
mcr.microsoft.com/dotnet/core/aspnet   3.1-buster-slim     bdca989bc8d3        2 weeks ago         207MB

运行容器

执行下面命令运行生成的容器，需要注意一下几点：

• 挂载目录，映射容器内目录到宿主机，如文件下载、上传等
• 端口，宿主机与容器内端口号映射，容器内端口号要保证与Dockerfile文件内一致
• 自动重启，设置restart属性为always，防止宿主机或者docker重启后容器停止

# 启动容器
docker run -d -p 8001:5000 --restart=always --name api.test api.test:v1

# 查看已经启动的容器
docker ps 或者 docker container ls

# 执行结果
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                    NAMES
306917290c1c        api.test:v1         "dotnet DotNetCore.A…"   6 seconds ago       Up 4 seconds        0.0.0.0:8001->5000/tcp   api.test

访问接口

在网内其他终端或者宿主机访问http://192.168.43.131:8001/api/test/getstr即可查看运行效果，运行效果如下：

结语

此时，已将基于.NET Core 3.1的Web API站点打包、部署至Linux平台。