一尘不染

如何在IIS中部署Flask应用程序?

flask

谁能帮助我在IIS 6上运行Flask应用程序?我曾尝试使用isapi-wsgi,但是当我访问虚拟目录地址时,会得到一个页面,显示“找不到指定的模块”。还有其他选择吗?

以下是我为isapi-wsgi编写的Python脚本。已创建虚拟目录,并且在IIS管理器中一切正常,但该站点无法正常工作。

from wof import app
import os

app.secret_key=os.urandom(24)

import isapi_wsgi
def __ExtensionFactory__():
    return isapi_wsgi.ISAPISimpleHandler(app)

if __name__ == '__main__':
    from isapi.install import *
    params = ISAPIParameters()
    sm = [ScriptMapParams(Extension="*", Flags=0)]
    vd = VirtualDirParameters(Name="WOFPy_Sondes", Description="ISAPI-WSGI for WOFPY Sondes test", ScriptMaps=sm, ScriptMapUpdate="replace")
    params.VirtualDirs = [vd]
    HandleCommandLine(params)

阅读 954

收藏
2020-04-06

共1个答案

一尘不染

高层概述
HTTP-> IIS-> ISAPI-> FastCGI-> WSGI(Flask应用程序)

设定步骤

步骤1:安装所需的二进制文件

  1. 安装Python(2.7或3.x-我使用3.3)
  2. 安装pip-Win(我使用1.6版)
  3. 安装pywin32(我使用版本218)
  4. 使用fcgisetup 1.5安装IIS FastCGI扩展

步骤2:安装可选的二进制程序包

我pyodbc使用此站点的安装程序.exe进行安装。从源安装(例如,用于安装到虚拟环境中的pip)需要C / C ++编译器。

步骤3:取得的副本 wfastcgi.py

选择一个适合你的版本,最好是一个支持Python 3.3的版本(我使用过David Ebbo的)。你可能需要这里的“官方”版本。

将wfastcgi.py脚本安装到其中C:\Inetpub\wwwroot,并确保将为你的应用程序提供服务的帐户(默认情况下为“网络服务”)对其具有读取权限。

步骤4:安装virtualenv到系统站点包

C:\Python33\Scripts\pip.exe install virtualenv

(如果你使用的是Python 3.3,并且所有内容均安装在默认位置)

步骤5:安装Flask应用程序

你可以在系统上的任何位置安装应用程序。你可能需要将其安装在下C:\Inetpub。在本教程中,我们将调用应用程序install的根文件夹 %APPROOT%。(不要在环境变量中加上引号。)

确保将为你的应用程序提供服务的帐户(默认情况下为“网络服务”)具有对所有脚本文件的读取权限。该命令:

cacls "%APPROOT%" /S:"D:PAI(A;OICI;FA;;;BA)(A;OICIIO;FA;;;CO)(A;OICI;0x1200a9;;;NS)(A;OICI;FA;;;SY)"

将为你的应用程序目录提供以下权限:

  • BUILTIN \ Administrators:完全控制此文件夹,子文件夹和文件
  • 创建者所有者:完全控制子文件夹和文件
  • NT AUTHORITY \ NETWORK SERVICE:对此文件夹,子文件夹和文件的读取权限
  • NT AUTHORITY \ SYSTEM:对此文件夹,子文件夹和文件的完全控制
  • 添加任何必要的本地配置(我的应用程序使用版本控制系统忽略的local.cnf文件),例如数据库URL。
  • 确保你的应用程序中包含一个Web.config文件%APPROOT%-有关文件格式的信息,请参见以下部分。

步骤6:为你的应用程序创建一个virtualenv

C:\Python33\Scripts\virtualenv.exe --system-site-packages "%APPROOT%\env"

(选择名称,env除非你的应用程序已经使用该目录。)

步骤7:将应用程序所需的软件包安装到virtualenv

cd "%APPROOT%"
env\Scripts\activate
pip install -r Packages

(我的项目将需求规范保存在名为的文件中Packages。)

步骤8:为你的应用程序创建网站或虚拟目录

使用inetmgr.msc(开始 -> 运行…,然后inetmgr在编辑框中输入并按Enter)启动Internet信息服务(IIS)管理器。确保将你创建的节点(网站或虚拟目录)的本地路径设置为Flask应用程序的根文件夹。 wfastcgi.py使用本地路径来标识Flask应用程序以处理请求。

授予节点读取和脚本(运行脚本)权限。

步骤9:设定 fcgiext.ini

该文件与fcgiext.dll步骤1中安装的目录位于同一目录(默认为%SYSTEMROOT%\system32\inetsrv)。

在配置此文件时,你需要几个参数:

  • {site id}:从窗口左侧的树中选择“网站”时,你可以在Internet信息服务(IIS)管理器的详细信息(右侧)窗格中找到的数字网站ID 。
  • {application name}:其中的部分名称,fcgiext.ini用于提供FastCGI(ISAPI)处理程序的参数。你选择此值-选择代表你的应用程序的内容。
  • {app to app}:对于虚拟目录,是网站内要处理的虚拟目录的URL路径。
  • {approot}:应用程序根目录的路径。

使用这些参数可以:

  • 将FastCGI请求映射到处理部分:

  • 对于整个网站,请添加到该部分。*:{site id}={application name}[Types]

  • 对于虚拟目录,请添加到该部分。*:/lm/w3svc/{site id}/root/{path to app}={application name}[Types]
    添加带有此应用程序参数的处理部分()(完整参考):[{application name}]

  • ExePath={approot}\env\python.exe

  • Arguments=C:\Inetpub\wwwroot\wfastcgi.py(或wfastcgi.py安装适配器脚本的任何地方)
  • EnvironmentVars=ENV_VAR1:value,ENV_VAR2:value,etc.(有关报价规则,请参见完整参考)。这是设置WSGI_LOG环境变量的好地方-确保为站点提供服务的帐户(默认情况下为“网络服务”)具有对该文件的写权限,并且(如果该文件不存在)具有向其添加文件的权限。包含的目录。

步骤10:为目标URL配置FastCGI处理

使用Internet信息服务(IIS)管理器,从Flask应用程序要服务的节点(网站或虚拟目录)的上下文(右键单击)菜单中选择“属性…”,并:

  • 在“主目录”选项卡(网站)或“虚拟目录”选项卡(虚拟目录)中,单击“配置…”按钮。

  • 在“通配符应用程序映射”部分中,使用“插入…”按钮添加通配符映射:

  • 可执行文件是在步骤1中安装的FastCGI扩展DLL。其默认位置是%SYSTEMROOT%\system32\inetsrv\fcgiext.dll

  • 确保未选中 “验证该文件是否存在” 。Flask应用程序执行自己的路由,这些路由不一定与磁盘上的文件有任何关系。
    Web.config
    这个文件是(在此设置)读取wfastcgi.py,不是由IIS。
<?xml version="1.0" encoding="UTF-8"?>

<configuration>
    <applicationSettings>
        <add key=“PYTHONPATH” value=“”/>
        <add key=“WSGI_HANDLER” value=“module.application”/>
    </applicationSettings>
</configuration>
  • <add>元素添加环境变量(os.environ在Python中)。

  • WSGI_HANDLER必须指定-它告诉wfastcgi.py如何定位WSGI应用程序对象。如果该值以“()”结尾,wfastcgi.py则将调用命名对象,并期望它返回WSGI应用程序对象。

  • PYTHONPATH是经过特殊处理的- 对的值wfastcgi.py执行(环境)变量扩展(使用Windows标准%VAR%表示法)PYTHONPATH,然后将结果分割为分号,并将条目追加到sys.path调用WSGI应用程序之前。因为wfastcgi.py在导入包含WSGI应用程序对象的模块之前将当前目录更改为指定为Web站点或虚拟目录的本地路径的路径,所以在PYTHONPATH中包含空字符串将导致搜索将Flask应用程序目录作为开始点。你还可以在fcgiext.ini中设置PYTHONPATH (在这种情况下,sys.path解释器将其包含进来,然后再由wfastcgi.py)将其包含进来。

  • WSGI_RESTART_FILE_REGEX给出一个Python正则表达式,用于过滤应触发FastCGI处理程序进程重启的路径的文件更改通知。设置为在源文件或配置文件更改时触发。我用(?i).*\.(py|cnf|config)$

  • WSGI_LOG可能在此处设置,但我认为最好在设置fcgiext.ini

对于IIS 7

从IIS 7开始,FastCGI的某些事情发生了巨大变化。从该版本开始,FastCGI直接通过IIS进行支持,并且未通过扩展程序进行配置(即步骤1.4是不必要的,fcgiext.ini并且不控制IIS 7+的FastCGI行为,因此不需要创建/编辑它)。相反,请确保在“ 控制面板”>“程序和功能”>“打开或关闭Windows功能”下的“ Internet信息服务”下启用了CGI。

Web.config

IIS 7是第一个从Web.config文件中读取与FastCGI相关的配置设置的IIS 。你的Web.config文件将需要在<configuration>元素内包含元素,该<system.webServer>元素包含的<handlers>元素包含具有属性的元素:

  • path: *
  • verb: *
  • modules: FastCgiModule
  • resourceType: Unspecified
  • requireAccess: Script
  • scriptProcessor: the tricky one

scriptProcessor属性

<add>元素的此属性必须包含.exe你要使用的Python解释器文件的完整路径(Scripts Python virtualenv子文件夹中的|路径),后跟a ,然后是wfastcgi.py你正在使用的文件的完整路径。由于这些路径取决于运行应用程序的计算机的设置,因此你可能需要在部署过程中设置此属性。

IIS服务器范围的设置

  • 在中inetmgr,单击树中的服务器节点,然后从中央窗格中选择“ FastCGI设置”。将列出可执行文件/参数对的列表。
  • 为你python.exewfastcgi.py你正在使用的完整路径添加一个条目。两者都应以相同的方式显示在/元素中Web.config
  • 确保PYTHONPATH在新的FastCGI应用程序条目中设置环境变量,以包括应用程序代码库的根。有关添加一个空的建议PYTHONPATH在进入<applicationSettings>你的Web.config可能并不适用于这个版本的IIS。
2020-04-06