WeText项目的服务端

WeText项目的服务端

在《WeText项目：一个基于.NET实现的DDD、CQRS与微服务架构的演示案例》文章中，我介绍了自己用Visual Studio 2015（C# 6.0 with .NET Framework 4.6.1）开发的DDD/CQRS/微服务架构的案例项目：WeText。文章发出后反响很好，也很感谢大家的关注。在本文中我将介绍如何在Ubuntu 14.04.4 LTS中运行WeText项目的服务端。

为跨平台而生

从一开始的设计，我就把WeText的服务端跨平台纳入了实践目标，因此，所选择的框架和技术全部都是可以跨平台运行的。在这个过程中我没有尝试最新的.NET Core RC，而是继续使用最新版本的Mono。Mono目前对微软官方的.NET Framework兼容性已经做得非常好了，一句话概括：除了WPF、WWF不支持，以及部分WCF与ASP.NET 4.5异步支持不完善以外，其它功能完全支持。.NET Framework已经支持到4.6.1，C#语言规范已经支持到C# 6.0。具体详情可以参考Mono的官方说明：http://www.mono-project.com/docs/about-mono/compatibility/。在最近工作上遇到一个项目需要能够运行在Linux下，项目本身不大，也非常简单，但美国团队一听说我打算采用Mono就不太愿意接受，最后还是选择使用Java。当然我承认Java在多平台的支持方面的确非常出色，但我还是想亲身实践一下Mono，想证明基于Mono的方案的确也能做得很好。这也是我将WeText定位为能够跨平台的一个原因吧。话说回来，从客户的角度，微软的开源为解决方案的技术选型提供了更为广阔的选择余地，客户的整套方案不需要像以前那样，一个部分使用了微软技术，就整个解决方案都要使用微软技术（比如，选择了.NET Framework，就需要运行Windows的服务器；使用了Windows服务器，LDAP就是Active Directory最合适；使用Entity Framework，就需要SQL Server做数据库，客户一想，我还有一大堆的服务程序都是运行于Linux的，凭什么我的服务器一定要选择Windows？于是，客户也不会选择.NET Framework）。当然，这是另外的话题，在这里我还是继续介绍WeText服务端的跨平台特性吧。

我在Ubuntu 14.04.4 LTS版本的Linux系统中成功安装并运行了WeText的服务端，而且成功从Windows下的WeText.Web项目访问这台Linux服务器并跑通了所有的业务逻辑。听起来是不是很让人兴奋？现在，就请和我一起了解一下整个安装和运行过程吧。

环境准备

首先，得要有一台Ubuntu 14.04.4 LTS的机器（如果是其它系列的Linux，以下安装过程会有些不同，请大家自行参考各种组件在相应版本的Linux下的安装步骤进行安装，但不会影响后续WeText的编译和执行）。在准备完这台机器之后，就可以开始一步步地准备环境了。

安装Mono

在Linux系统中安装Mono，可以参考http://www.mono-project.com/docs/compiling-mono/linux/。基本上有两种方式：一种是直接从发布版本进行编译安装，另一种是通过克隆代码库然后编译安装。当然，无论哪种方式，在编译之前，请先通过下面的命令确保所有所需的软件包都已经正确安装：

1	sudo apt-get install git autoconf libtool automake build-essential mono-devel gettext

我自己是通过下载Release Package完成安装的，Mono所有的Release Package位于：http://download.mono-project.com/sources/mono/。直接选择最新版本下载解压即可。

解压完成后，进入解压后的目录，依次执行下面的命令完成编译安装：

1 2 3

./configure --prefix=/usr/local make make install

第一条命令中的—prefix参数可以根据自己的情况设定。

安装MongoDB

在WeText中，MongoDB被用作Event Store（事实上Event Sourcing暂时还未实现）。使用MongoDB的原因，是因为事件数据本身是非结构化的，而且MongoDB在replication方面有着很好的解决方案。安装过程如下：

1. 为包管理系统导入公钥

1	sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927

2. 为MongoDB创建list文件

这将为MongoDB在/etc/apt/sources.list.d目录下创建mongodb-org-3.2.list文件。

1	echo "deb http://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list

3. 刷新本地包数据库

1	sudo apt-get update

4. 安装最新版本的MongoDB

1	sudo apt-get install -y mongodb-org

5. 启动MongoDB服务

1	sudo service mongod start

6. 直接执行mongo命令，检查MongoDB是否已经正确安装

如果需要更加详细的安装步骤，请直接参考官方文档，或者也可以上网搜索相关的中文资料参考。注意：目前暂时建议整个安装过程采用默认设置，因为MongoDB的配置目前是写死在服务端代码中的（具体位置是：WeText.DomainRepositories项目下的WeTextMongoSetting.cs文件中）。如果更改了MongoDB的配置，那么也需要相应地更改这部分代码，然后重新编译WeText服务端（本文后半部分会介绍编译过程）。今后会将MongoDB的配置移到配置文件中。

安装RabbitMQ

1. 使用以下命令将RabbitMQ的APT Repository加到/etc/apt/sources.list.d目录下

1	echo 'deb http://www.rabbitmq.com/debian/ testing main' | sudo tee /etc/apt/sources.list.d/rabbitmq.list

2. 将RabbitMQ的公钥加入受信秘钥列表中

1	wget -O- https://www.rabbitmq.com/rabbitmq-signing-key-public.asc | sudo apt-key add -

3. 刷新本地包数据库

1	sudo apt-get update

4. 安装RabbitMQ

1	sudo apt-get install rabbitmq-server

如果需要更加详细的安装步骤，请直接参考官方文档。

安装MySQL

1. 刷新本地包数据库

1	sudo apt-get update

2. 安装MySQL

1	sudo apt-get install mysql-server

3. 使用以下命令尝试连接MySQL服务

1	mysql -u root -p

如果需要更加详细的安装步骤，请直接参考这篇文章。

从源代码编译

1. 使用下面的git命令将WeText源代码克隆到本地

1	git clone https://github.com/daxnet/we-text.git

2. 进入we-text\scripts目录，执行mysql –u root –p命令启动MySQL客户端。并在MySQL中执行下面的命令，初始化WeText所需使用的查询数据库：

1	\. mysql_query_databases.sql

3. 注意：在Linux下的nuget.exe还是有些问题，在WeText下执行nuget.exe restore命令无法将所有的依赖库下载下来（我还没找到解决方案）。因此，只能在Windows中先使用Visual Studio 2015编译WeText.sln，然后再将下载下来的packages目录复制到Linux下we-text\src目录下。可以通过Samba服务，或者使用FTP将packages目录上传到Linux系统中

4. 进入we-text\src目录，使用下面的命令完成WeText服务端的编译：

1	xbuild /p:TargetFrameworkVersion=v4.6.1 /p:Configuration=ServerDebug WeText.sln

5. 编译完成后，会出现一些Assembly Binding的警告，请暂且忽略

运行WeText服务端

进入we-text\bin目录，执行./WeText.Service.exe命令，启动WeText服务端，将看到以下画面：

在Windows中通过Visual Studio 2015打开WeText项目，修改WeText.Web项目的web.config文件，将下图中的设置更改为Linux中的WeText服务端地址：

启动WeText.Web项目，新建一个daxnet的用户：

登录后点击菜单栏的My Texts菜单，创建一个新的Text：

现在，查看Linux下的MongoDB数据库：

查看MySQL查询数据库：

查看RabbitMQ消息队列：

OK，整个流程运行下来没什么问题。最后，只要在WeText.Service.exe的窗口中直接回车，即可退出服务端的运行（退出需要花几秒钟时间）。

总结

本文详细介绍了在Linux环境中编译运行WeText客户端的方法，并成功走通了整个流程。正如前文所述，WeText还有很多需要改进的地方，我也会一步步对其进行改进调整，如果有新的心得体会，我也会继续分享给大家。