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系统中，你可以使用

  1. apt-get install build-essential python mono-xsp4 asp.net-examples

mono-xsp4 是一次性安装所有我们需要的东东的窍门，而ASP.net样例将会被用来测试我们的安装。

我们可以构建一个嵌入了Mono的单片uWSGI发行版：

  1. UWSGI_PROFILE=mono make

在这个过程的最后 (如果一切顺利的话)，你将会得到到 uwsgi.dll 组合的路径。

你或许想要在你的GAC中安装它 (使用gacutil -i <path>)，以避免每次都要指定其路径。这个库让你访问来自Mono应用的uWSGI api。

启动服务器

Mono插件有一个官方的 modifier1, 15。

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. mono-app = /usr/share/asp.net-demos
  5. mono-index = index.asp

前一个步骤假设已在GAC中安装了uwsgi.dll，如果你并非如此，那么你可以这样强制它的路径使用：

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. mono-app = /usr/share/asp.net-demos
  5. mono-index = index.asp
  6. mono-assembly = /usr/lib/uwsgi/uwsgi.dll

/usr/share/asp.net-demos 是包含Mono的样例ASP.net应用的目录。

如果启动uWSGI，那么你会得到一个关于不能找到uwsgi.dll的错误，你可以这样强制使用一个特定的路径

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. mono-app = /usr/share/asp.net-demos
  5. mono-index = index.asp
  6. mono-assembly = /usr/lib/uwsgi/uwsgi.dll
  7. 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映射到虚拟机的情况。要将一个虚拟机路径映射到一个指定的键，你可以使用

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. 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内部路由来构建一个海量虚拟主机栈

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. mono-key = MONO_APP
  5. 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的线程支持工作良好。

  1. [uwsgi]
  2. http = :9090
  3. http-modifier1 = 15
  4. mono-app = /usr/share/asp.net-demos
  5. mono-index = index.asp
  6. mono-assembly = /usr/lib/uwsgi/uwsgi.dll
  7. env = MONO_PATH=/usr/lib/uwsgi/
  8.  
  9. master = true
  10. processes = 4
  11. threads = 20

有了这个而设置，你会生成4个进程，每个进程有20个线程。试着不要依赖于单个进程。尽管在所谓的“企业环境”下，这是一个常见的设置，但是拥有多进程确保了更好的可用性 (多亏了master工作)。这个规则（例如）甚至应用到了 uWSGI服务器中的JVM (更新至1.9) 插件上。

API访问

这是一个在进行中的工作。目前，只导出了几个函数。 uWSGI RPC栈 和信号子系统，以及 uWSGI缓存框架 框架将是高优先级的。

技巧

如往常一样，uWSGI试着优化（可能的话）你的应用的“常见”操作。提供静态文件服务会被自动加速 (或者当卸载启用的时候进行卸载)，并且会缓存所有的路径解析。