1. 需求
原有的系统是部署在IIS上，现在需要开发一些新功能，这些新功能发现用python实现很方便，于是开始构造。和老功能之间使用http通讯自然也方便。于是就找个微小框架，选择flask作为Python的Web框架。因此，最好是能将python部署到IIS上。
2. 环境
| 服务程序 | 版本 | 操作系统 |
|---|---|---|
| IIS | 10.0 | Windows10 |
| IIS | 8.0 | Windows Server 2012 |
| Python3 | 3.7.* | Windows 10， Windows Server 2012 |
| wfastcgi | 3.0.0 | - |
| Flask | 1.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.exe | C:\pythons\Python37\python.exe |
| wfastcgi.py | C:\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管理器中查看结果：
应该添加好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，似乎不起作用。一直没有成功。还是老老实实配置生产环境为全局环境吧。
