我的书签
添加书签
移除书签部署
我们这里以项目 flask-todo-app 为例，介绍如何将其部署到生产环境，主要有以下几个步骤：
- 创建项目的运行环境
- 使用 Gunicorn 启动 flask 程序
- 使用 supervisor 管理服务器进程
- 使用 Nginx 做反向代理
创建项目的运行环境
- 创建 Python 虚拟环境，以便隔离不同的项目
- 安装项目依赖包
1. $ pip install virtualenvwrapper
2. $ source /usr/local/bin/virtualenvwrapper.sh
3. $ mkvirtualenv flask-todo-env # 创建完后，会自动进入到该虚拟环境，以后可以使用 workon 命令
4. $
5. (flask-todo-env)$ git clone https://github.com/ethan-funny/flask-todo-app
6. (flask-todo-env)$ cd flask-todo-app
7. (flask-todo-env)$ pip install -r requirements.txt
使用 Gunicorn 启动 flask 程序
我们在本地调试的时候经常使用命令 python manage.py runserver 或者 python app.py 等启动 Flask 自带的服务器，但是，Flask 自带的服务器性能无法满足生产环境的要求，因此这里我们采用 Gunicorn 做 wsgi (Web Server Gateway Interface，Web 服务器网关接口) 容器，假设我们以 root 用户身份进行部署：
1. (flask-todo-env)$ pip install gunicorn
2. (flask-todo-env)$ /home/root/.virtualenvs/flask-todo-env/bin/gunicorn -w 4 -b 127.0.0.1:7345 application.app:create_app()
上面的命令中，-w 参数指定了 worker 的数量，-b 参数绑定了地址（包含访问端口）。
需要注意的是，由于我们这里将 Gunicorn 绑定在本机 127.0.0.1，因此它仅仅监听来自服务器自身的连接，也就是我们无法从外网访问该服务。在这种情况下，我们通常使用一个反向代理来作为外网和 Gunicorn 服务器的中介，而这也是推荐的做法，接下来也会介绍如何使用 nginx 做反向代理。不过，有时为了调试方便，我们可能需要从外网发送请求给 Gunicorn，这时我们可以让 Gunicorn 绑定 0.0.0.0，这样它就会监听来自外网的所有请求。
使用 supervisor 管理服务器进程
在上面，我们手动使用命令启动了 flask 程序，当程序挂掉的时候，我们又要再启动一次。另外，当我们想关闭程序的时候，我们需要找到 pid 进程号并 kill 掉。这里，我们采用一种更好的方式来管理服务器进程，我们将 supervisor 安装全局环境下，而不是在当前的虚拟环境：
1. $ pip install supervisor
2. $ echo_supervisord_conf > supervisor.conf # 生成 supervisor 默认配置文件
3. $ vi supervisor.conf # 修改 supervisor 配置文件，添加 gunicorn 进程管理
在 supervisor.conf 添加以下内容：
1. [program:flask-todo-env]
2. directory=/home/root/flask-todo-app
3. command=/home/root/.virtualenvs/%(program_name)s/bin/gunicorn
4. -w 4
5. -b 127.0.0.1:7345
6. --max-requests 2000
7. --log-level debug
8. --error-logfile=-
9. --name %(program_name)s
10. "application.app:create_app()"
12. environment=PATH="/home/root/.virtualenvs/%(program_name)s/bin"
13. numprocs=1
14. user=deploy
15. autostart=true
16. autorestart=true
17. redirect_stderr=true
18. redirect_stdout=true
19. stdout_logfile=/home/root/%(program_name)s-out.log
20. stdout_logfile_maxbytes=100MB
21. stdout_logfile_backups=10
22. stderr_logfile=/home/root/%(program_name)s-err.log
23. stderr_logfile_maxbytes=100MB
24. stderr_logfile_backups=10
supervisor 的常用命令如下：
1. supervisord -c supervisor.conf 通过配置文件启动 supervisor
2. supervisorctl -c supervisor.conf status 查看 supervisor 的状态
3. supervisorctl -c supervisor.conf reload 重新载入 配置文件
4. supervisorctl -c supervisor.conf start [all]|[appname] 启动指定/所有 supervisor 管理的程序进程
5. supervisorctl -c supervisor.conf stop [all]|[appname] 关闭指定/所有 supervisor 管理的程序进程
6. supervisorctl -c supervisor.conf restart [all]|[appname] 重启指定/所有 supervisor 管理的程序进程
使用 Nginx 做反向代理
将 Nginx 作为反向代理可以处理公共的 HTTP 请求，发送给 Gunicorn 并将响应带回给发送请求的客户端。在 ubuntu 上可以使用 sudo apt-get install nginx 安装 nginx，其他系统也类似。
要想配置 Nginx 作为运行在 127.0.0.1:7345 的 Gunicorn 的反向代理，我们可以在 /etc/nginx/sites-enabled 下给应用创建一个文件，不妨称之为 flask-todo-app.com，nginx 的类似配置如下：
1. # Handle requests to exploreflask.com on port 80
2. server {
3. listen 80;
4. server_name flask-todo-app.com;
6. # Handle all locations
7. location / {
8. # Pass the request to Gunicorn
9. proxy_pass http://127.0.0.1:7345;
11. # Set some HTTP headers so that our app knows where the request really came from
12. proxy_set_header Host $host;
13. proxy_set_header X-Real-IP $remote_addr;
14. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
15. }
16. }
常用的 nginx 使用命令如下：
1. $ sudo service nginx start
2. $ sudo service nginx stop
3. $ sudo service nginx restart
可以看到，我们上面的部署方式，都是手动部署的，如果有多台服务器要部署上面的程序，那就会是一个恶梦，有一个自动化部署的神器 Fabric 可以帮助我们解决这个问题，感兴趣的读者可以了解一下。
