python Flask 打包发布到IIS步骤

本人发布一次成功,下面列出详细步骤,供大家参考 

条件:

win2012,

IIS7,

python 3.8.1 

wfastcgi 3.0.0

falsk 1.1.1

基本原理

通过配置桥接,将IIS的请求利用wfastcgi功能,启动flask框架开发的程序来做响应。其中,关键一点就是IIS中配置的网站需要一个fastcgi的配置,指定python.exe作为cgi程序,指定wfastcgi.py作为脚本执行。

即配置web.config完成这个桥接设定。

wfastcgi 3.0.0

原文如下:
https://pypi.org/project/wfastcgi/

部署IIS的说明

https://docs.microsoft.com/zh-cn/visualstudio/python/configure-web-apps-for-iis-windows?view=vs-2017


具体步骤:

1. 服务器上安装python,建议不要安装到默认目录,且勾选all users选项。 否则可能会因为执行权限不够导致失败。

python分32,64位版本,这个应与你的开发端一致。我安装在了c:\website\python38目录下。

2.安装所有python依赖包。

  我这里采用的是开发端:pip freeze > requirements.txt  生成requirements.txt文件 。服务器端pip -r requirements.txt安装。

服务器端 pip install wfastcgi  安装wfastcgi. 这里会发现python/scripts目录下多了几个wfastcgi开头的文件 ,其中就有wfastcgi-enable. 

服务端IIS安装好,安装时选上fastcgi,cgi两个扩展包。

向IIS注册wfastcgi功能

根据wfastcgi 3.0.0中的说明,需要启用功能。其实实际就是IIS中增加一个fastCgi的设置。
使用管理员权限的cmd执行:

 

wfastcgi-enable

 

执行结果截图


可以看到执行之后,已经提示了IIS的配置结果。并且给出了配置参数:
C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py
说明:
can now be used as a FastCGI script processor这个是重点理解的地方。
也就是说,可以添加一个新网站,这个网站如果要使用wfastcgi连接flask应用,可以利用上述参数进行配置且使用IIS中fastCGI已经配置好的脚本解释器。
在IIS管理器中查看结果:

查看IIS配置结果


应该添加好fastCGI程序,如果没有则后续无法执行:

fastCGI配置


这里不再需要配置什么所谓的参数,环境等等。因为是全局的,后续应该在网站中配置。

 

4.3.3. 添加网站

IIS管理器上添加一个新网站(如果是默认站点,那么可以跳过)。
我添加了一个flaskr的网站,虚拟目录指向C:\py\flask-tutorial,端口号指定为:8001

大部分百度出来的文章,这里就开始讲怎么新建一个web.config,最好使用IIS管理器帮我们新建一个,自己不需要动手。免得出错。

处理映射程序


添加一个映射程序模块:

网站→处理程序映射→添加模块映射


配置模块:

添加模块映射


可执行文件配置中的内容,就是4.3.2中的提示的参数内容:C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py
配置请求限制为 *

配置请求限制


确定后,系统会配置一个web.config放入项目目录下。什么?您 那没有,没关系。一会把网站发布上来执行一次后,再看就会有了。至少我这里是这样。

 

配置项目

即对web.config做详细处理。这里可以手工,也可以在IIS管理器中配置。
这里还是直接编辑文件来的方便,且不容易出错。

 

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
       <!-- handlers在4.3.2步骤中配置好,IIS管理器生成,不要手工修改 -->
        <handlers>
            <add name="flaskr" path="*" verb="*" modules="FastCgiModule" scriptProcessor="C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py" resourceType="Unspecified" />
        </handlers>
    </system.webServer>
    <!-- appSettings节点需要手工添加 -->
    <appSettings>
        <!-- 2个必须要有的参数: 
        @WSGI_HANDLER:fastCGI获得请求后调用的flask应用入口。
        @PYTHONPATH: 执行整个应用的项目目录
        -->
        <add key="WSGI_HANDLER" value="flaskr.create_app()" />
        <add key="PYTHONPATH" value="C:\py\flask-tutorial" />
        <!-- 可选参数, 我这里就配置一个日志文件,其他应该参考 https://pypi.org/project/wfastcgi/ -->
        <add key="WSGI_LOG" value="C:\xlog\flaskr_web.log" />
    </appSettings>
</configuration>

WSGI_HANDLER参数说明

这里是严重被误导的地方。浪费我太多时间。
很多文档或百度出来的示例,都是***.app。其实是错误的。最后,根据wfastcgi 3.0.0中的说明,才明白这个参数的概念:执行程序的入口。
由于大部分flask的示例都是单文件,且简单如下:

 

app = Flask(__name__)

因此,这里只要配置__name__.app即可,其实就是执行某个py文件中的app变量,而这个app变量为Flask()函数的返回值而已。

我这里使用了模块的方式,在__init__.py中有一个函数来创建app。因此配置的值就是:flaskr.create_app(),不需要任何的管理或启动py文件,即可使用。用模块方式,其实更方便。

将基于Flask框架的Web应用部署到IIS上

xiaoou22关注赞赏支持

将基于Flask框架的Web应用部署到IIS上

xiaoou22关注

2019.02.11 21:13:39字数 1,781阅读 1,363

1. 需求

原有的系统是部署在IIS上,现在需要开发一些新功能,这些新功能发现用python实现很方便,于是开始构造。和老功能之间使用http通讯自然也方便。于是就找个微小框架,选择flask作为Python的Web框架。因此,最好是能将python部署到IIS上。

2. 环境

服务程序版本操作系统
IIS10.0Windows10
IIS8.0Windows Server 2012
Python33.7.*Windows 10, Windows Server 2012
wfastcgi3.0.0-
Flask1.0-

3. 技术原理引用

根据百度来的文章,基本都不可靠。还是需要自己从技术原文研究一下。

3.1. 基本原理

通过配置桥接,将IIS的请求利用wfastcgi功能,启动flask框架开发的程序来做响应。其中,关键一点就是IIS中配置的网站需要一个fastcgi的配置,指定python.exe作为cgi程序,指定wfastcgi.py作为脚本执行。

即配置web.config完成这个桥接设定。

wfastcgi 3.0.0

原文如下:
https://pypi.org/project/wfastcgi/

部署IIS的说明

https://docs.microsoft.com/zh-cn/visualstudio/python/configure-web-apps-for-iis-windows?view=vs-2017

3.2. 重点

因为IIS是微软产品,所以必须去微软的文档中找资料。fastcgi桥接脚本,其实也是微软自己开发的。python的web如此流行,当下微软应该有对应的方法来处理。

4. 实战

4.1. 安装Python3

经过反复测试,如果windows上安全Python3,一定要安装自定义目录,且勾选all users选项。
一开始测试时候,一口气next下去,无论如何都不好用,总是报错fastcgi错误或者500,后来重新安装Python,并指定开放的目录才解决。应该是fastcgi的配置需要执行权限导致的。

下载地址:
https://www.python.org/downloads/release/python-372/
找一个可执行的文件下载。部署端的32bit或64位版本应该和你开发端一致。经过测试,发现部分package是有不兼容的情况。

我这里就安装到C:\pythons\Python37下,方便处理,也可以避免windows10的文件权限问题。默认是安装到users的appData目录的,很麻烦。

4.2. 安装组件

4.2.1. 在线服务器

开发后的版本本身可以制作setup.py,这里应该参考:https://dormousehole.readthedocs.io/en/latest/tutorial/install.html
将依赖包都放入:

install_requires=[
    'flask',
    'pandas',
],

然后形成自己的whl,复制到服务器上后,在安装自己的whl

pip install flaskr.whl

pip程序会根据requires配置再安装对应的组件。

4.2.2. 离线部署

离线很麻烦。需要将venv中的包都下载好whl,然后依次pip。其他方式都不太可靠。
当然也可以制作requirement然后一次性离线安装。但是这个需要注意每个包的次序,否则还是会安装失败。具体以后再专门记录一下。

4.3. 配置

安装部署之后,应该形成一个执行目录。这里,我用了flask的案例即一个小blog的应用flaskr。
教程原文:https://dormousehole.readthedocs.io/en/latest/tutorial/index.html

这个教程的应用是形成一个Web工厂,而不是其他百度来的文章中一个简单的helloword,这个更实际。因为这个案例中没有启动应用的app.py。

百度上也好,其他微软文档也好,都集中在web.config的内容解释上,这个其实很误导部署操作。这里还是利用可视化界面进行配置。(所以很喜欢centOS等的原因就是部署可以根据研发执行脚本,windows还是可视化操作更好)

4.3.1. 目录环境

内容目录
python.exeC:\pythons\Python37\python.exe
wfastcgi.pyC:\pythons\Python37\Lib\site-packages\wfastcgi.py
flaskr项目C:\py\flask-tutorial

项目的内部目录结构

C:\py\flask-tutorial
├── flaskr/
│   ├── __init__.py
│   ├── db.py
│   ├── schema.sql
│   ├── auth.py
│   ├── blog.py
│   ├── templates/
│   │   ├── base.html
│   │   ├── auth/
│   │   │   ├── login.html
│   │   │   └── register.html
│   │   └── blog/
│   │       ├── create.html
│   │       ├── index.html
│   │       └── update.html
│   └── static/
│       └── style.css

这个项目目录中没有任何py文件,项目直接为flaskr包

4.3.2. 向IIS注册wfastcgi功能

根据wfastcgi 3.0.0中的说明,需要启用功能。其实实际就是IIS中增加一个fastCgi的设置。
使用管理员权限的cmd执行:

wfastcgi-enable

 

执行结果截图


可以看到执行之后,已经提示了IIS的配置结果。并且给出了配置参数:
C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py
说明:
can now be used as a FastCGI script processor这个是重点理解的地方。
也就是说,可以添加一个新网站,这个网站如果要使用wfastcgi连接flask应用,可以利用上述参数进行配置且使用IIS中fastCGI已经配置好的脚本解释器。
在IIS管理器中查看结果:

查看IIS配置结果


应该添加好fastCGI程序,如果没有则后续无法执行:

fastCGI配置


这里不再需要配置什么所谓的参数,环境等等。因为是全局的,后续应该在网站中配置。

 

4.3.3. 添加网站

IIS管理器上添加一个新网站(如果是默认站点,那么可以跳过)。
我添加了一个flaskr的网站,虚拟目录指向C:\py\flask-tutorial,端口号指定为:8001

大部分百度出来的文章,这里就开始讲怎么新建一个web.config,最好使用IIS管理器帮我们新建一个,自己不需要动手。免得出错。

处理映射程序


添加一个映射程序模块:

网站→处理程序映射→添加模块映射


配置模块:

添加模块映射


可执行文件配置中的内容,就是4.3.2中的提示的参数内容:C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py
配置请求限制为 *

配置请求限制


确定后,系统会配置一个web.config放入项目目录下。

 

4.3.4. 配置项目

即对web.config做详细处理。这里可以手工,也可以在IIS管理器中配置。
这里还是直接编辑文件来的方便,且不容易出错。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
       <!-- handlers在4.3.2步骤中配置好,IIS管理器生成,不要手工修改 -->
        <handlers>
            <add name="flaskr" path="*" verb="*" modules="FastCgiModule" scriptProcessor="C:\pythons\Python37\python.exe|C:\pythons\Python37\Lib\site-packages\wfastcgi.py" resourceType="Unspecified" />
        </handlers>
    </system.webServer>
    <!-- appSettings节点需要手工添加 -->
    <appSettings>
        <!-- 2个必须要有的参数: 
        @WSGI_HANDLER:fastCGI获得请求后调用的flask应用入口。
        @PYTHONPATH: 执行整个应用的项目目录
        -->
        <add key="WSGI_HANDLER" value="flaskr.create_app()" />
        <add key="PYTHONPATH" value="C:\py\flask-tutorial" />
        <!-- 可选参数, 我这里就配置一个日志文件,其他应该参考 https://pypi.org/project/wfastcgi/ -->
        <add key="WSGI_LOG" value="C:\xlog\flaskr_web.log" />
    </appSettings>
</configuration>

WSGI_HANDLER参数说明

这里是严重被误导的地方。浪费我太多时间。
很多文档或百度出来的示例,都是***.app。其实是错误的。最后,根据wfastcgi 3.0.0中的说明,才明白这个参数的概念:执行程序的入口。
由于大部分flask的示例都是单文件,且简单如下:

app = Flask(__name__)

因此,这里只要配置__name__.app即可,其实就是执行某个py文件中的app变量,而这个app变量为Flask()函数的返回值而已。

我这里使用了模块的方式,在__init__.py中有一个函数来创建app。因此配置的值就是:flaskr.create_app(),不需要任何的管理或启动py文件,即可使用。用模块方式,其实更方便。

5. 总结

百度出来的各种文章,很失败,很误导,很浪费时间
也没有一些人说的windows+IIS部署flask有多麻烦。关键是大家都没有搞清楚wfastcgi 3.0.0中的说明。阅读原文并理解概念很重要。英文不好,也可以参考Visual Studio的帮助文档

被误导的几个方面:

  • webinstall工具 -- 离线部署不可能用
  • cgi安装,这个其实正常IIS配置都需要的
  • url重定向,这个根本不需要。2个微软文档都没有提到,我也没有配置,即部署成功
  • web.config,只要wfastcgi-enable之后即可配置,任何乱配,乱设定环境参数都是无用功。网站的web.config只需要配置参数,根据说明书走即可。
  • 静态文件:经过测试,似乎没有必要专门配置的。

将项目开发中的venv内容部署后,wfastcgi直接配置为venv,似乎不起作用。一直没有成功。还是老老实实配置生产环境为全局环境吧。

 

参考:https://www.jianshu.com/p/8b6b263144ba

©️2020 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页