Fork me on GitHub

在CentOS上使用Jexus托管运行 ZKEACMS

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.MySqlPomelo.EntityFrameworkCore.MySql ,推荐大家使用,经过了实际项目的检验。

ZKEACMS Core 的数据库脚本只有SQL Server, 将SQL Server数据库转换为MySQL的工具非常多,这里不做具体介绍了。

发布 ZKEACMS.Core

发布 ZKEACMS.Core 比较简单,双击 Publish.cmd 即可

image

生成的文件在目录 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中进行文件传输

image

配置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应用程序的配置全过程

posted @ 2017-05-22 07:24 张善友 阅读(...) 评论(...) 编辑 收藏