Mono ASP.NET插件¶
uWSGI 1.9添加了对Mono平台的支持,特别是对于ASP.NET基础设施。
The most common way to deploy 部署Mono ASP.NET应用的最常见方式是使用XSP项目,它是一个简单的web服务器网关,实现了HTTP和FastCGI协议。
通过Mono插件,你将能够给直接在uWSGI中托管ASP.net应用,在你的应用中免费获得它所有的特性。
正如所有其他uWSGI插件一样,你可以使用 uWSGI RPC栈 子系统调用所有从其他语言导出的函数。
构建uWSGI + Mono¶
你可以作为插件或者在一个单片构建中构建Mono支持。
有一个名为”mono”的构建配置文件可用,让这个任务相当简单。
确保你的系统中安装了mono。你需要Mono头部, mcs
编译器和System.Web组合。在标准的mono发行版中都可以找到它们。
在最近的Debian/Ubuntu系统中,你可以使用
apt-get install build-essential python mono-xsp4 asp.net-examples
mono-xsp4
是一次性安装所有我们需要的东东的窍门,而ASP.net样例将会被用来测试我们的安装。
我们可以构建一个嵌入了Mono的单片uWSGI发行版:
UWSGI_PROFILE=mono make
在这个过程的最后 (如果一切顺利的话),你将会得到到 uwsgi.dll
组合的路径。
你或许想要在你的GAC中安装它 (使用gacutil -i <path>),以避免每次都要指定其路径。这个库让你访问来自Mono应用的uWSGI api。
启动服务器¶
Mono插件有一个官方的 modifier1
, 15。
[uwsgi]
http = :9090
http-modifier1 = 15
mono-app = /usr/share/asp.net-demos
mono-index = index.asp
前一个步骤假设已在GAC中安装了uwsgi.dll,如果你并非如此,那么你可以这样强制它的路径使用:
[uwsgi]
http = :9090
http-modifier1 = 15
mono-app = /usr/share/asp.net-demos
mono-index = index.asp
mono-assembly = /usr/lib/uwsgi/uwsgi.dll
/usr/share/asp.net-demos
是包含Mono的样例ASP.net应用的目录。
如果启动uWSGI,那么你会得到一个关于不能找到uwsgi.dll的错误,你可以这样强制使用一个特定的路径
[uwsgi]
http = :9090
http-modifier1 = 15
mono-app = /usr/share/asp.net-demos
mono-index = index.asp
mono-assembly = /usr/lib/uwsgi/uwsgi.dll
env = MONO_PATH=/usr/lib/uwsgi/
或者你可以简单将uwsgi.dll拷贝到你的站点目录的 (在这个情况下,是 /usr/share/asp.net-demos
) /bin
目录下。
mono-index
选项是用来设置当请求一个目录时的搜索文件的。你可以多次指定它。
钩子之下:mono键¶
前一个例子应该会完美运行,但是在内部,做了大量的假设。
整个mono插件依赖于”键”概念。一个键是一个.net应用的唯一标识。在这个例子中,该应用的键是”/usr/share/asp.net-demos”。这是一种键1:1映射到虚拟机的情况。要将一个虚拟机路径映射到一个指定的键,你可以使用
[uwsgi]
http = :9090
http-modifier1 = 15
mono-app = /foobar=/usr/share/asp.net-demos
现在/foobar键映射到/usr/share/asp.net-demos .net应用。
默认情况下,请求键会被映射到DOCUMENT_ROOT变量。因此,在这个新的情况下,/foobar应该是DOCUMENT_ROOT的值。
但是uWSGI http路由器并没有DOCUMENT_ROOT的概念,因此前一个工作要怎么工作呢?这是因为第一个加载的应用通常是默认应用,因此mono插件,不能够查找到一个应用,则返回默认的。
把DOCUMENT_ROOT当成键使用会相当受限的。因此可用–mono-key选项。让我们使用uWSGI内部路由来构建一个海量虚拟主机栈
[uwsgi]
http = :9090
http-modifier1 = 15
mono-key = MONO_APP
route-run = addvar:MONO_APP=/var/www/asp/${HTTP_HOST}
MONO_APP并不是mono插件会用来搜索应用的变量 (取代DOCUMENT_ROOT)。
多亏了内部路径,我们(动态)设置它为指定主机应用的根目录,因此,到example.com的请求将会被映射到/var/www/asp/example.com
并发和fork()不友好¶
由于Mono VM并非 fork()
友好的,因此会为每个worker生成一个新的VM。这确保了你可以在多进程模式下运行你的应用。
Mono拥有相当稳定的多线程支持,并且它与uWSGI的线程支持工作良好。
[uwsgi]
http = :9090
http-modifier1 = 15
mono-app = /usr/share/asp.net-demos
mono-index = index.asp
mono-assembly = /usr/lib/uwsgi/uwsgi.dll
env = MONO_PATH=/usr/lib/uwsgi/
master = true
processes = 4
threads = 20
有了这个而设置,你会生成4个进程,每个进程有20个线程。试着不要依赖于单个进程。尽管在所谓的“企业环境”下,这是一个常见的设置,但是拥有多进程确保了更好的可用性 (多亏了master工作)。这个规则(例如)甚至应用到了 uWSGI服务器中的JVM (更新至1.9) 插件上。
API访问¶
这是一个在进行中的工作。目前,只导出了几个函数。 uWSGI RPC栈 和信号子系统,以及 uWSGI缓存框架 框架将是高优先级的。
技巧¶
如往常一样,uWSGI试着优化(可能的话)你的应用的“常见”操作。提供静态文件服务会被自动加速 (或者当卸载启用的时候进行卸载),并且会缓存所有的路径解析。