Decorative image frame

D-107

3wly 项目开发组自留地

向net core 3.0进击——多平台项目发布与部署

前言

在经历过好多折腾后,总算是把部署走通了一遍,之前只是简单创建个工程在linux下部署,后来一直将这件事搁置,直到最近刚好团队入手一个小服务器,很显然是linux的,那就没啥说的了,Come On!

发布

在这个时候我挺想也秀一把命令行,什么dotnet build啊,publish什么的,但是还是老老实实用我的宇宙第一神器吧。

右键工程发布。
发布
发布
发布

这个地方我引用下官网的介绍。

依赖框架

优点:

  • 不需要设置部署的系统,因为都是通用的pe文件,这就是跨平台很嗨皮的地方
  • 部署包小
  • 允许程序使用net core最新的runtime
  • 多应用可通用一个net core类库

缺点:

  • 主机系统必须安装当前程序net core版本或更高的版本
  • 如果net core高版本砍掉部分使用的功能,那升级可能就会有问题

独立部署

优点:

  • 可以单独维护当前使用的net core
  • 目标系统也可以运行你的net core

缺点:

  • 需要提前选择你部署的系统
  • 部署包大,因为独立嘛
  • 每个应用自己本身都会带个net core,重复率,emm

其他的倒没有太多注意的地方,我这里选择的是依赖框架。

之后就是生成文件了,我们来看下这一堆玩意儿。
发布

这里注意自己复制下April.xml这个文件,因为我没连带发布,留个坑。。。

测试

Windows

我们来试下dotnet命令吧。
测试
直接访问https://localhost:5001吧,这里没有输出内容。
测试
好了,这说明发布直接在Windows运行,应该是没啥问题。

IIS部署

本身想着这里都不多说了,后来一想,算了,既然写相关部署了,那哪能少的了这伴随了好长时间的IIS啊。

新建网站
新建站点
这里注意下标注的模块,IIS部署net core需要单独安装一个.NET Core Windows Server Hosting,然后置于sdk到这一步了应该是都安装过了,路径就选择自己发布的路径。

然后在应用池中更改下托管。
新建站点
之后运行网站就可以了,测试这块儿我就不放了,毕竟一般这地方没啥问题,如果前面都能运行的话,有问题的朋友可以私信我。

Linux

这里我用的是Centos 7(虚拟机Vmware),相关的安装软件什么的我在之前新手向相关的也已经介绍过了,这里不多说了,直接开始吧。

首先我们把publish下发布的文件打包上传到linux,我这里放的目录是/www/april-webapi/,这里我们直接运行的话,是不行的,毕竟linux下我们还没有安装dotnet相关的环境,已经安装的忽视。
Linux部署
一个是运行库dotnet,一个是运行时库runtime,这个都可以通过官网来下载的,当然可以直接通过docker(直接跳过这块儿往下看),但是我这里只是把我自己趟的一遍复述下而已。

1
2
$ sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
$ sudo yum install dotnet-sdk-3.0
1
2
$ sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
$ sudo yum install aspnetcore-runtime-3.0

ok,小等会儿就可以安装完了,完成之后,我们来切到工程目录下。

1
$ cd /www/april-webapi/publish/

来试下dotnet的命令吧。

1
$ dotnet April.WebApi.dll

运行之后,如果不出意外,我们会看到下面这个错误,当然如果你的工程比较简洁(什么引用都没有,就是个空工程),那这个地方你就完全运行了,但是那样的工程除了demo毫无卵用(就像我当年那么天真以为走一遍新建工程发布就已经大结局了一样)。

问题

好了,不扯了,我们来看下这个问题,提示我们在对应lib/xxx路径下找不到xxx.dll,但是为何我们windows就可以了呢,这是因为类库缓存,在你运行程序的时候这些类库已经有了,默认会从net core的安装目录也就是系统盘下对应的不知道哪个文件夹下/lib/netstandardx.x/xxx.dll,所以windows下就没有报错。

这里我第一反应就是,那既然这样我就把需要的dll文件都放过来,然后路径换换不就得了(不得不说确实好麻烦),于是就这样一通操作,把类库都单独放到一个文件夹,其实发布之后的工程已然包含这些类库了,对April.WebApi.deps.json这个文件修改路径之后(我是全改成/lib/netcore-libs/xxx.dll),我们运行之后还是提示找不到。

对于这种现象,我只能说,世界之大~,然后继续查资料吧,最终在一个 Nate McMaster的博客中找到了这个问题的解决方法,原来还有这个April.WebApi.runtimeconfig.json的属性additionalProbingPaths配置,这种要不是深入还真是不行啊,国外的钻研精神不得不说,值得学习,看过之后也发现,原来发布的文件夹中有一个这种写法的配置,注意看April.WebApi.runtimeconfig.dev.json

配置好对应路径之后,我们来测试下,如果没有其他问题,应该跟我看到的界面效果一样,ok,那这样不就已经结束了。

测试

Docker

docker的配置这块儿,我也是在Linux配置部署_新手向(五)——Docker的安装与使用简单的介绍了,包括基本用到的命令语句什么的。

这里直接来个Dockerfile吧,这里也只是简单写下需要的环境,端口,路径等基础配置。

1
2
3
4
5
6
FROM mcr.microsoft.com/dotnet/core/aspnet:3.0-buster-slim AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443
COPY . /app
ENTRYPOINT ["dotnet", "April.WebApi.dll"]

然后我们在当前目录下,运行以下命令生成镜像,注意末尾,还有个点,意思就是当前目录。

1
$ docker build -t april-webapi .

稍等一会儿(网速不好的话可能很长时间),提示完成的时候,我们来看下镜像。

1
$ docker images

测试

看到有镜像那就说明走了一大半了,然后我们只需要运行镜像创建容器就行了。

1
2
$ docker run --name april-webapi-demo -d -p 8080:80 april-webapi
$ docker ps -a

指定8080来接收80端口,指定名字叫april-webapi-demo,然后看下运行容器的情况。

测试

这里我们看到已经创建了容器,但是注意状态EXIT(140),这很明显我们的程序跑了但是没有持久,emm,不持久可不行。

看下日志是咋回事吧。

1
$ docker logs april-webapi-demo

测试

一看,哟,又是同样的错误,但是我们的路径已经指向绝对路径了,为啥还错呢,这里注意下,我们的类库是在linux下的根目录下的指定文件夹,但是docker呢,可以理解为单独的虚拟机,那很显然docker当中没有这个路径下的文件,那既然这样,我们就好解决了,因为Dockerfile中我们的WorkingDir是/app,那么我们是不是只要指定到这个目录下就可以了呢?Let’s 踹踹。

首先我们在publish下创建个packages,然后把类库包复制到文件夹下,之后替换April.WebApi.deps.json中/lib/netcore-libs/为/app/packages/,这里说下为啥是/app/xxx呢,因为Dockerfile中配置的工作区为app。

一番替换之后,我们来重新走一遍build,这次改个名字(当然可以删除之前的无效镜像跟容器),重新运行下我们再看容器的状态,咦好像是可以了,那我们来访问下,这次用主机访问这个地址,看到这个界面之后,不禁感慨,路漫漫啊。

测试
测试

小结

这篇同样没有测试,因为一路都捎带着测试,所有的走完一遍之后,我在想,为何会这么麻烦,按说通用的话,一个文件夹移哪都能用才对,至于相对路径我也是试过,但是没有效果,应该还是那个配置查找路径的属性问题,我们还是需要先指明从哪读类库,后续看看有啥新进展的话,我还是会继续更新的。

在net core刚开始的时候,我们都已经知道这是一个要跨平台的,但是直到现在我才开始鼓捣linux下部署,实在是惭愧,一直在windows下让我有点儿过于舒适(当然还是因为windows服务器到期了),还是来一句结束吧,我们总是想的太多,而却做的太少,总以为理所当然,可现实四处碰壁,生活在于折腾,而折腾使人进步,树欲静而风不止,那就可劲儿刮吧。