ZKEACMS Core 是基于 .net core 开发的,可以在 windows, linux, mac 上跨平台运行,接下来我们来看看如何在 CentOS 上使用Jexus托管运行 ZKEACMS,通常我们在Linux部署ASP.NET Core应用,按照微软的官方文档,我们通常需要Nginx 搭配 Systemd , Nginx并没有接管Kestrel 进程,我们需要维护2个进程,增加了复杂度。如果你把asp.net core部署于windows上,我们可以用IIS来接管Kestrel进程,我们在Linux上也可以用Jexus来达到IIS一样的体验
ZKEACMS Core 是基于 .net core 开发的,可以在 windows, linux, mac 上跨平台运行,接下来我们来看看如何在 CentOS 上使用Jexus托管运行 ZKEACMS,通常我们在Linux部署ASP.NET Core应用,按照微软的官方文档,我们通常需要Nginx 搭配 Systemd (https://docs.microsoft.com/en-us/aspnet/core/publishing/linuxproduction), Nginx并没有接管Kestrel 进程,我们需要维护2个进程,增加了复杂度。如果你把asp.net core部署于windows上,我们可以用IIS来接管Kestrel进程,我们在Linux上也可以用Jexus来达到IIS一样的体验。
安装 .Net Core 运行时
按照官方文档https://www.microsoft.com/net/core#linuxcentos :运行以下命令,安装 .Net Core Runtime
sudo yum install libunwind libicu
curl -sSL -o dotnet.tar.gz https://go.microsoft.com/fwlink/?linkid=843421
sudo mkdir -p /usr/local/dotnet && sudo tar zxf dotnet.tar.gz -C /usr/local/dotnet
sudo ln -s /usr/local/dotnet/dotnet /usr/local/bin
安装 Jexus
按照《CentOS 7.2下安装Mono 5.0》安装好了Mono 5, 我这里是安装通用版的Jexus,通用版的Jeuxs 才能使用到我们自己安装的最新版的Mono 5。安装 Jexus 直接使用一下命令即可(需要在root身份下执行):
curl https://jexus.org/release/install | sh
安装成功后会提示:OK, Jexus has been installed in /usr/jexus.
备注:
你可以直接安装独立版的Jexus,独立版的Jexus自带Mono,使用的是Mono的稳定版本4.8,安装命令也是一个命令就可以搞定:curl https://jexus.org/release/x64/install.sh|sh
发布 ZKEACMS.Core
数据库 MySql
我使用的是腾讯云的云数据库MySQL(Cloud Database for MySQL)是腾讯云基于全球最受欢迎的开源数据库MySQL专业打造的高性能分布式数据存储服务,100%完全兼容MySQL 协议,适用于面向关系型数据库的场景。ZKEACMS Core 默认使用的是Oracle官方的Mysql驱动,由于Oracle官方的mysql驱动有很多问题,目前还是beta版本,最近也不见更新,我在生产环境使用的是Pomelo.EntityFrameworkCore.MySql ,我ZKEACMS的MySQL驱动更改为Pomelo.EntityFrameworkCore.MySql,经测试工作良好,我已经把相关修改pull 给ZKEACMS。 MySQL for .NET Core - Pomelo 扩展包系列 包括Pomelo.Data.MySql 和 Pomelo.EntityFrameworkCore.MySql ,推荐大家使用,经过了实际项目的检验。
ZKEACMS Core 的数据库脚本只有SQL Server, 将SQL Server数据库转换为MySQL的工具非常多,这里不做具体介绍了。
发布 ZKEACMS.Core
发布 ZKEACMS.Core 比较简单,双击 Publish.cmd 即可
生成的文件在目录 ZKEACMS.Core\src\ZKEACMS.WebHost\bin\Release\PublishOutput
修改连接字符串
打开 appsettings.json,加入 MySQL的数据库连接字符串,结果如下
{
"ConnectionStrings": {
"DefaultConnection": "",
"Sqlite": "",
"MySql": "Server=10.66.241.199;Database=ZKEACMS_Core;User Id=root;Password=xxxxxxx;"
},
"ApplicationInsights": {
"InstrumentationKey": ""
},
"Logging": {
"IncludeScopes": false,
"LogLevel": {
"Default": "Debug",
"System": "Information",
"Microsoft": "Information"
}
},
"CDN": {
"Enable": true,
"Url": "http://cdn.zkeasoft.com/core" },
"Culture": "zh-CN"
}
上传服务器
我们将发布好的程序同winscp 程序上传到服务器/var/www/csharpkit 目录,具体操作可参考文章《使用WinSCP软件在windows和Linux中进行文件传输》
配置Jexus运行ZKEACMS Core
定位到目录,然后使用 dotnet 命令运行
cd /var/www/csharpkit
dotnet ZKEACMS.WebHost.dll
运行成功以后,就可以使用您服务器的IP或者域名访问了,默认访问的端口是5000 退出SSH远程连接客户端后,发现访问不了,这是因为 dotnet 也退出了。下面我们就通过Jexus来管理我们服务进程。
使用以下命令:
1、切换到Jexus配置文件目录
cd /usr/jexus/siteconf
2、复制默认的配置文件为test
cp default csharpkit
3、编辑csharpkit配置文件
nano csharpkit
######################
# Web Site: csharpkit
########################################
port=80
root=/ /var/www/csharpkit
hosts=www.csharpkit.com #OR your.com,*.your.com
AppHost={
cmd=dotnet /var/www/csharpkit/ZKEACMS.WebHost.dll;
root=/var/www/csharpkit;
port=0;
}
配置的重点就在于AppHost中,需要注意的是在AppHost中的port(端口号)不代表Jexus对外服务的port(端口号),而是指要转发的 Asp.Net Core应用程序的端口号,如果在程序中使用了UsrUrls自定义端口则使用UsrUrls中填写的端口(不建议使用UsrUrls自定义端口),在没有使用UsrUrls自定义端口的情况下端口号设置为 0,Jexus会在运行时与Asp.Net Core进行"协商"具体使用的端口号,避免多个应用分配,端口的麻烦和冲突的风险。 简单来说就是会将外部的请求转发到这个端口,由这个端口对应的Asp.Net Core应用程序对请求进行处理。
4、启动/重启 Jexus
当配置文件编辑完成后使用以下命令对Jexus进行 启动/重启
# 如果已启动 Jexus:
sh /usr/jexus/jws restart
# 如果未启动 Jexus:
sh /usr/jexus/jws start
启动/重启成功后,在浏览器中输入 ip地址/域名:端口号 例如(http://www.csharpkit.com/) 即可访问Asp.Net Core应用程序
以上即是Jexus托管Asp.Net Core应用程序的配置全过程