Dokcer入门之发布.NET Core 3.x

本文主要介绍一下如何在Docker中发布.NET Core 3.x 并对整个过程所遇到的问题加以记录和分析.

环境、工具、准备工作

• 服务器: VM中安装CentOS, 内核版本3.10.x;
• 客户端: Windows 10;
• IDE: VS2019
• SFTP客户端: FileZilla; 用来进行文件传输;
• SSH工具: Putty; 用来在Windows 上远程访问CentOS;
• 本文示例均为Root权限;
• 因为是本地环境,所以防火墙是关闭状态,如果没有关闭防火墙,端口映射的时候记得处理.

Docker安装 (如已安装可忽略)

参考官方文档

1. 卸载删除旧Docker版本,使用如下命令;

yum remove docker  docker-client  docker-client-latest  docker-common  docker-latest  docker-latest-logrotate  docker-logrotate  docker-engine

2. 安装 yum-config-manager ,DeviceMapper(了解DeviceMapper) 和 lvm2(了解lvm2); 使用如下命令:

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

3. 设置仓库地址; 使用如下命令:

//官方地址:
yum-config-manager  --add-repo  https://download.docker.com/linux/centos/docker-ce.repo

//阿里云(建议):
yum-config-manager  --add-repo  http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

4. 安装社区版Docker, 使用如下命令:  (如需安装指定版本请参考官方文档)

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

 5. 启动Docker, 使用如下命令:

//设置开机自动启动docker
systemctl enable docker

//启动docker
systemctl start docker

 6. 运行测试, 使用如下命令:

docker version

 Docker发布.NET Core MVC

1. 使用VS2019创建.NET Core MVC, 选不选择Docker 支持都无所谓,重要的是Dockerfile.  (Dockerfile学习)

 

 2. 编写Dockerfile, 并设置始终复制到目录; Dockerfile内容如下:

FROM mcr.microsoft.com/dotnet/core/sdk:3.1     
WORKDIR /app　　　　　　　　　　　　　　　　　　　　　　
COPY . .
EXPOSE 80
ENTRYPOINT ["dotnet", "TestMVC.dll"]

说明:

　　2.1 如果创建项目时选择了Docker支持, 请将内容修改为上面内容(主要为方便理解);

　　2.2 Dockerfile 路径默认先放置在Project 下,并设置始终复制到目录; 文件路径并非一定要在Project下,但是这样对初学者好理解;

　　2.3 着重说明下EXPOSE选项:

　　　   可以不设置,该选项只是告诉镜像使用者容器准备以什么协议暴露哪个端口号,实际运行是不发布端口的;相当于描述信息(Docker Run -p);

　　　   Docker Run -P 命令会使用到该选项,后面介绍;

　　2.4 官方基础镜像库 https://hub.docker.com/_/microsoft-dotnet-core 根据自己需要选择

3. 发布项目并上传到CentOS;

 

4. 使用命令构建镜像: (Build命令学习)

 进入项目发布目录:

cd /home/publish

构建镜像:

docker build -t testmvc:v1 .

 注意: . 号不能丢失, 表示当前目录

 查看镜像信息:

docker images

5. 使用命令运行容器: (Run命令学习)

docker run -d -p 5000:5000 --name testmvc testmvc:v1

 查看容器:

docker ps -a

 容器启动, 这个时候我们的.NET Core MVC就算发布完了, 在浏览器输入http://你的服务器地址:5000 访问程序, 你会惊喜的发现,无论怎么访问你都访问不到, 是不是很意外?

为什么会访问不到呢? 这也是初学者踩的最多的坑, 目前网上大部分博文的部署都是上面的流程, 你部署下来会发现无论如何都访问不到, 很少有讲解为什么, 其实原因很简单,我们使用命令来看看为什么:

docker logs testmvc

 

 根据log我们发现我们的程序是正常运行了, 但是仔细看内容, .NET Core 程序默认监听的是localhost:5000 和 localhost:5001 而localhost 是回环网络地址, 而我们的容器和宿主机是隔离的, 所以即便我们将容器端口和宿主机端口进行了映射绑定, 宿主机依然无法访问容器内的应用.

解决方案有以下四种(顺序既是优先级,任选一种即可)

(1) 在程序Program.cs修改程序端口监听配置;

(2) 修改Dockerfile的ENTRYPOINT参数;

 

 (3) 启动容器设置应用监听端口;

docker run -d -p 5000:5000 -e ASPNETCORE_URLS=http://+:5000 --name testmvc testmvc:v1

(4)设置Dockerfile的环境变量;

 

 以上四种方式都可以重新设置应用程序端口监听,四种情况共存的话1最优先,4最后;一般建议使用3, 方便各种容器编排工具进行动态管理;

停止之前运行的容器,并删除;

//停止运行的镜像
docker stop testmvc
//删除已经创建的容器
docker rm testmvc

使用第三者方案重新创建运行容器, 并测试, 你会发现我们的应用程序已经可以正常的访问了.

最后我们再来解析下Dockerfile的EXPOSE的作用;

使用命令来查看我们的容器配置信息:

docker inspect testmvc

我们会看到以下配置信息:

 使用查看容器命令来看容器启动信息:

docker ps 

 

 从以上内容来看,EXPOSE定义的端口,并未暴露给宿主机, 这也是我们上面说的EXPOSE实际并不发布端口,仅相当于描述信息;

我们在启动容器时使用了-p 5000:5000 意义是将容器的5000端口和宿主机5000端口进行绑定;

但是 docker run还有一个参数 -P ,我们使用以下命令:

docker run -d -P --name testmvc1 testmvc:v1

你会发现有一个随机的端口和EXPOSE暴露的80端口进行了绑定,如果这个时候你的应用程序默认监听了80端口, 则就可以使用http://服务器地址:32768进行程序访问了

这就是EXPOSE的作用;