使用wfastcgi在IIS上部署Python Flask应用

本文介绍了如何在Windows上部署Python Flask应用,相关环境如下:

  • 操作系统:windows 7
  • Python:3.4
  • WFastCGI: 2.2

应用所用到的包版本如下:

Flask==0.10.1
Flask-SQLAlchemy==2.1
itsdangerous==0.24
Jinja2==2.8
MarkupSafe==0.23
pyodbc==3.0.10
SQLAlchemy==1.0.9
Werkzeug==0.11.2
wheel==0.24.0

1. WFastCGI

wfastcgi.py使用WSGI和FastCGI提供了IIS和Python之间的桥接,类似于Apache HTTP服务器上的mod_python.

它能够用于任何支持WSGI的Python web应用或者框架,而且提供了IIS处理请求和进程池的高效方法。

2. 安装

2.1 下载安装包

通过PyPI安装:

pip install wfastcgi

2.2 IIS安装FastCGI和URL重写

IIS需要安装FastCGI和URL重写,这个可以通过Microsoft Web Platform Installer来安装。下载过Microsoft Web Platform Installer点击运行,会出现如下的界面。

1448583956986.png

在搜索栏分别输入cgi和url重写,点击添加按钮:

1448584071863.png
1448584044495.png

:windows10上的IIS 10现在不支持url重写。

3. 启用wfastcgi

一旦wfastcgi和IIS安装完毕,用管理员的身份运行wfastcgi-enable来在IIS上启用wfastcgi配置。这个能配置一个路由处理器的CGI应用。

wfastcgi-enable

要在卸载之前禁用wfastcgi,运行wfastcgi-disable

wfastcgi-disable
pip uninstall wfastcgi

注意: 卸载wfastcgi不会自动的取消注册CGI应用。

如果传递给wfastcgi-enable或者wfastcgi-disable的第一个参数是一个有效的文件,整个命令行就用来注册或取消注册这个CGI处理器。

例如,下面的命令就是在IIS Express上启用wfastcgi,而且指定主机配置。

wfastcgi-enable "C:\Program Files (x86)\IIS Express\appcmd.exe"
    /apphostconfig:C:\Path\To\applicationhost.config

你也可以使用wfastcgi-disable来禁用相同配置的wfastcgi:

wfastcgi-disable "C:\Program Files (x86)\IIS Express\appcmd.exe"
    /apphostconfig:C:\Path\To\applicationhost.config

4. 使用PTVS创建Python Web项目

PTVS是Visual Studio的一个插件,能够让VS支持Python开发,下载并安装后,就可以使用它来开发Python项目了。
使用PTVS创建一个Flask项目(Django项目类似):

1448584435904.png

PTVS会自动根据模板创建一个项目,点击运行,就会在项目根目录下创建一个web.config文件。我在下面对文件进行了一些修改说明。

?xml version="1.0"?>
<configuration>
  <system.diagnostics>
    <!--如果不用此节点可以移除-->
  </system.diagnostics>
  <appSettings>
    <add key="WSGI_ALT_VIRTUALENV_HANDLER" value="TgwlDataCenter.app" /><!--value指定Flask实例,PTVS会自动生成,也可以自己定义-->
    <add key="WSGI_ALT_VIRTUALENV_ACTIVATE_THIS" value="%ROOTDIR%\env\Scripts\activate_this.py" /><!--value指定激活虚拟路环境用到的内容-->
    <add key="WSGI_HANDLER" value="ptvs_virtualenv_proxy.get_virtualenv_handler()" /><!--也是虚拟路径的WSGI_HANDLER,不用修改-->
    <add key="PYTHONPATH" value="%ROOTDIR%" /><!--项目根目录-->
  </appSettings>
  <system.web>
    <compilation debug="true" targetFramework="4.0" />
  </system.web>
  <system.webServer>
    <modules runAllManagedModulesForAllRequests="true" />
    <handlers>
      <add name="Python FastCGI" path="handler.fcgi" verb="*" modules="FastCgiModule" scriptProcessor="%INTERPRETERPATH%|%WFASTCGIPATH%" resourceType="Unspecified" requireAccess="Script" /><!--scriptProcessor的值就是你在运行wfastcgi-enbale时输出的值-->
    </handlers>
    <rewrite>
      <rules>
        <rule name="Static Files" stopProcessing="true">
          <match url="^/static/.*" ignoreCase="true" /><!--静态文件不用CGI处理,直接使用IIS返回静态文件-->
          <action type="Rewrite" url="^/TgwlDataCenter/static/.*" appendQueryString="true" />
        </rule>
        <rule name="Configure Python" stopProcessing="true">
          <match url="(.*)" ignoreCase="false" />
          <conditions>
          </conditions>
          <action type="Rewrite" url="handler.fcgi/{R:1}" appendQueryString="true" />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
</configuration>

scriptProcessor的值是wfastcgi-enable命令执行时输出的,不同机器值也不一样。pathverb的值也可以进一步自定义来限制request的类型。

name值可以在子文件夹的web.config文件中使用,来屏蔽handler的作用。比如,在/static子文件夹中添加一个web.config文件,包含<remove name="Python FastCGI"/>来阻止IIS通过Python应用来解析静态文件。

app setting被转换为环境变量,并且能够在Python应用中通过os.getenv来获取。下面这些变量由wfastcgi使用。

注意:部署时需要将%ROOTDIR%全部替换为项目根目录,%INTERPRETERPATH%|%WFASTCGIPATH%替换为wfastcgi-enable命令执行时输出,我的是C:\Python34\python.exe|C:\Python34\lib\site-packages\wfastcgi.py

此时,将项目部署到IIS上就可以了,创建方法同普通的ASP.NET网站创建方法相同。

作者:liulixiang1988#gmail.com (#换成@)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,732评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,496评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,264评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,807评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,806评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,675评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,029评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,683评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,704评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,666评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,773评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,413评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,016评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,978评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,204评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,083评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,503评论 2 343

推荐阅读更多精彩内容

  • 0 系列目录# WEB请求处理 WEB请求处理一:浏览器请求发起处理 WEB请求处理二:Nginx请求反向代理 本...
    七寸知架构阅读 13,879评论 22 190
  • 本文翻译自HOWTO Use Python in the web 摘要 本文提供了一些集成Python和Web服务...
    大蟒传奇阅读 3,961评论 -1 12
  • 1. Nginx的模块与工作原理 Nginx由内核和模块组成,其中,内核的设计非常微小和简洁,完成的工作也非常简单...
    rosekissyou阅读 10,190评论 5 124
  • 转载自标点符的《网关协议学习:CGI、FastCGI、WSGI》 CGI CGI即通用网关接口(Common Ga...
    李绍俊阅读 1,655评论 0 1
  • 时间总是在不经意间溜走,不觉间父亲已离去十年了。 他每次出现在我的梦里,都像往常一样,保持着惯有的样子,让我丝毫没...
    今灿阅读 273评论 2 5