python部署手记：django, gunicorn, virtualenv, circus, nginx

发表于   |   分类于

手记，以免下次配置再入坑。有些细节未做详细描述，如果有问题，可以评论或私信我。

初次尝试搭python服务器，强撸python3，花样作死。过程中出现各种错误，不停google，搜到的时间大部分在2012年－2014年。让我不禁怀疑，真的没人用py搭服务器嘛？怎么比ruby还少。。。

相关技术点：django, gunicorn, virtualenv, circus, nginx

陆续花了一个月时间，先是折腾flask，完了折腾django，再到部署。感觉身体被掏空。说好的人生苦短，要用python呢。相比之下PHP部署简单多了（主要是傻瓜式的一键安装，很多vps都提供PHP预装环境）。

deploy.png

至少打开了10倍于上图的tabs。简直丧心病狂。

下面记录在部署django中的一些细节。以免以后再google来回折腾。

服务器： 阿里云 ubuntu

创建新用户

在root下创建新的user

1
2
3
4
5
6
➜  ~ useradd -d /home/stay4it -s /bin/bash -m stay4it
➜  ~ passwd stay4it
➜  ~ usermod -a -G admin stay4it
➜  ~ vi /etc/sudoers
		#在root权限下添加stay4it权限
		stay4it ALL=(ALL:ALL) ALL

exit 尝试用新用户登陆。登陆后会发现你所在的根目录为/home/stay4it

python环境

python3.5.2还是python2.7.6？自行安装

要是当初不执着于python3，也就不会出那么多幺蛾子了。

virtualenv (可选)

为每个python app创建一个独立开发环境。（如果确定只用python3|python2，大可不必安装）

1
2
stay4it@:~$ pip3 install virtualenv
stay4it@:~$ pip3 install virtualenvwrapper

编辑 .bashrc
vi .bashrc

1
2
3
export WORKON_HOME=/home/stay4it/.virtualenvs
VIRTUALENVWRAPPER_PYTHON='/usr/bin/python3'
source /usr/local/bin/virtualenvwrapper.sh

source .bashrc

创建一个开发环境

1
2
3
stay4it@:~$ mkvirtualenv stay4it
stay4it@:~$ workon stay4it
				 deactivate

创建出来的虚拟环境在 /home/stay4it/.virtualenvs/stay4it

git 导入项目

安装git

1
2
3
4
mkdir test
git init
git remote add origin https://git.oschina.net/stay4it/test-deploy.git
git pull

测试run server

1
2
3
4
5
6
7
8
workon stay4it
	pip3 install -r requirements.txt
	python3 manage.py migrate
	python3 manage.py runserver 8081
```	
能跑起来就算成功
	
## gunicorn

stay4it@:~$ workon stay4it
pip3 install gunicorn
cd project/
vi gunicorn.conf

1
2
修改gunicorn.conf

##指定workers的数目，使用多少个进程来处理请求
workers = 3

##绑定本地端口
bind = ‘127.0.0.1:8081’

1
2

gunicorn testdeploy.wsgi -c gunicorn.conf

1
2
3
4
5
6
7
8
9
10
能跑起来也算成功
	
## circus 监控端口，自动重启
如果用python2，可以用supervisor，circus是supervisor在python3上的替代品。
退出virtualenv(deactivate)
pip3 install circus
vi /etc/circus.ini

[circus]
check_delay = 5
endpoint = tcp://127.0.0.1:5555
pubsub_endpoint = tcp://127.0.0.1:5556
statsd = true

[watcher:test]
working_dir = /home/stay4it/test/
cmd = gunicorn
args = testdeploy.wsgi -c gunicorn.conf
uid = stay4it
numprocesses = 3
send_hup = true
autostart = true
stdout_stream.class = FileStream
stdout_stream.filename = /home/projects/log/test-deploy.log
stdout_stream.max_bytes = 10485760
stdout_stream.backup_count = 4

使用virtualenv独立开发环境

copy_env = True
virtualenv = /home/stay4it/.virtualenvs/stay4it/

1
2
3
4
5
6
7
8
9
10
11
12
13
14
`sudo service circus start|stop`
通过启动circus服务，可以自动去跑circus.ini里的watcher。当这个watcher未启动时，自动启动。**cmd+args实际上还是用gunicorn来起服务的**。
## nginx 反向代理
`sudo apt-get install nginx`
`sudo service nginx start|stop|restart`
向nginx中添加project代理
`sudo vi /etc/nginx/sites-available/default`

server {
listen 80;
server_name test.stay4it.com;
root /home/stay4it/test/;
error_log /home/stay4it/logs/access.log;
location / {
proxy_pass http://localhost:8081;
}

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
sudo service nginx start
## 本机自动部署 fabric
ssh到服务器不是那么友好，可以用fabric来完成自动部署。
退出virtualenv(deactivate)
python3版本
`pip3 install fabric3`
在本机project根目录添加fabfile.py， 你可以把这个py文件当作一个脚本，这样就不用在ssh到服务器去部署。本机直接跑fab就可以部署了。

-- coding:utf-8 --

from fabric.api import *

服务器登录用户名:

env.user = ‘stay4it’

服务器地址，可以有多个，依次部署:

env.hosts = [‘ip’, ]

env.passwords = {
‘root@[hostname]’: ‘’,
}

不用密码也可以用ssh登录

env.key_filename = ‘~/.ssh/id_rsa’

_REMOTE_BASE_DIR = ‘/home/stay4it/test’

def deploy():
with cd(_REMOTE_BASE_DIR), prefix(“source /home/stay4it/.virtualenvs/stay4it/bin/activate”):
run(‘git pull’)
run(‘pip3 install -r requirements.txt’)
run(‘python3 manage.py migrate’)

# run('gunicorn testdeploy.wsgi -c gunicorn.conf')
run('sudo service circus restart')
# run('sudo service nginx restart')

1
2

fab deploy
```

后续

可以再添加ssh rsa，这样就不用总是用密码登录。

看起来蛮简单的，真正配起来问题多多。身边如果有个python大神就好了（求介绍）。自己折腾太耗时了。

期间很多技术选型都被误导了，很多python2的库在python3上都木有。很多部署都有个人偏好。比如不要django选flask，不要circus选supervisor。同事还给我推荐了ansible，capistranorb。累积的学习成本超高。也不知道当时到底哪个筋搭错了，非用python搭服务器。PHP才是最好的语言啊。

难者不会，会者不难。所有的轻车熟路都是刮蹭来的～

声明:本文为Stay原创,未经允许请勿转载 有心课堂(stay4it.com) 传递给你的不仅仅是技术～