项目运行环境
阿里云(单核CPU, 1G内存, Ubuntu 14.04 x64 带宽1Mbps), 具体购买和ssh连接阿里云本文不做描述。
实用工具
首先进入阿里云服务器后先要升级下apt-get, 并下载所需软件
|
1
2
|
sudo apt-get update
sudo apt-get install vim git wget tmux
|
我还会使用zsh和oh-my-zsh来替换bash
|
1
2
3
4
|
sudo apt-get install zsh
# 终端下打以下命令
wget --no-check-certificate https://github.com/robbyrussell/oh-my-zsh/raw/master/tools/install.sh -O - | sh
|
替换bash为zsh
|
1
|
chsh -s /bin/zsh
|
重新连接阿里云就可以看到效果, 具体主题可以根据自己喜好更改主目录下的.zshrc即可
安装python相关模块
使用python的pip包管理工具
|
1
2
3
|
sudo apt-get install python-setuptools
sudo apt-get install python-pip
sudo pip install python-virtualenv
|
在主目录下创建文件夹code并把所有项目放进这个目录里
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
mkdir code
# 使用virtualenv
vritualenv venv
# 开启virtualenv
source /venv/bin/activate
# 关闭virtualenv
deactivate
# 在开启virtualenv的状态下使用pip会使用venv中的pip，也就是所有模块都会安装到venv中
# 如果想要安装全局模块就使用sudo pip
# 安装flask, 安装到venv中
pip install flask
# 两个是不同的, 安装到系统中
sudo pip install flask
|
使用Flask
现在我们已经安装了Flask, 现在我们写一个小的程序来运行一下。
这里我们在一次安装flask的相关模块,并把他们写入到requirements.txt这个文件中。
|
1
2
3
4
5
6
7
8
9
10
11
|
# 安装flask的相关模块
pip install -r requirements
# 创建一个manage.py文件, 用作管理我们的应用, 然后创建我们的一个应用。
touch manage.py
## 创建一个叫bamboo的应用
mkdir bamboo
## 创建一个应用的文件, 接下来我们要编辑这个文件了。
touch bamboo/__init__.py bamboo/app.py
|
项目目录结构是这样的
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
/root/code/
├── bamboo
│ ├── app.py
│ ├── config.py
│ ├── __init__.py
│ ├── static
│ ├── templates
│ └── views
├── gunicorn.conf
├── logs
│ ├── access.log
│ ├── error.log
│ ├── supervisord.log
│ ├── supervisor_err.log
│ └── supervisor_out.log
├── manage.py
├── requirements.txt
├── run.py
├── sweep.py
└── venv
|
编辑bamboo/app.py和bamboo/views/main.py
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
## app.py
from flask import Flask
def create_app():
app = Flask(__name__)
# do something
register_blueprints(app)
return app
# 用来注册视图的路由
def register_blueprints(app):
from bamboo.views import main, error
for i in (main, error):
app.register_blueprint(i.bp)
## main.py
from flask import render_template, Blueprint
bp = Blueprint('main', __name__)
@bp.route('/')
@bp.route('/index')
def index():
return '<h1>Hello, Bamboo!</h1>'
|
安装Gunicorn
Gunicorn是一个wsgi服务器, 我们将通过它来启动我们的web服务。
|
1
2
|
# 注意我们是通过pip来安装，所以该模块所有文件都是在venv里面
pip install gunicorn
|
可以进入目录vevn/bin下查看是否存在gunicorn命令
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
# 这里我们编辑下manage.py文件，具体文件路径请查看上文中的目录结构
## manage.py
from bamboo.app import create_app
from flask.ext.script import Manager, Server, Shell
app = create_app()
manager = Manager(app)
def make_shell_context():
# 用于shell使用
pass
manager.add_command('shell', Shell(make_context=make_shell_context))
manager.add_command('runserver', Server(
use_debugger=True,
use_reloader=True,
host='127.0.0.1',
port=5000
))
if __name__ == '__main__':
manager.run()
|
运行一下manage.py
|
1
2
3
4
5
6
|
# 不适用gunicorn运行
python manage.py runserver
# 使用gunicorn 运行
# 这里需要注意一下, 冒号前面的是文件名也就是manage.py而后面的是应用的名称。我在这里载过跟头。因为服务器需要接受一个wsgi的应用而manager = Manager(app)不是一个wsgi应用所以报错
gunicorn manage:app
|
我们创建一个gunicorn配置文件gunicorn.conf并把他放到code目录下
|
1
2
3
4
|
## gunicorn.conf
workers=3
bind='127.0.0.1:5000'
|
安装Nginx
我们通过nginx来反向代理我们的服务。
|
1
2
|
# 首先下载一个nginx
sudo apt-get install nginx
|
我们可以访问我们的域名或IP地址，如果出现Nginx的提示就表示安装成功了。
nginx安装在/etc/nginx/目录下, 我们把项目的配置文件放到/etc/nginx/sites-available/
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
server{
listen 80;
server_name xxx.xxx.xxx.xxx;
# nginx log信息, 需要创建logs目录
access_log /root/code/logs/access.log
error_log /root/code/logs/error.log
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header HOST $host;
proxy_redirect off;
if (!-f $request_filename){
proxy_pass http://127.0.0.1:5000;
break;
}
}
}
|
需要创建一个软链接到/etc/nginx/sites-enabled/
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
# 这里bamoo只是文件名你也可以取自己的项目名称
ln -s /etc/nginx/sites-available/bamboo /etc/nginx/sites-enabled/bamboo
# 然后检查nginx有没有错误
nginx -t
# 重新启动服务
service nginx restart
安装Supervisor
supervisor用来监控进程，并在进程挂掉的时候自动重启它。
# 这里需要把它安装到系统中
sudo pip install supervisor
# 生成配置文件
sudo echo_supervisord_conf > /etc/supervisord.conf
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
# 编辑/etc/supervisord.conf,并在最后一行加入一下字段
# 这样配置文件会将/etc/supervisor/conf.d下所有.conf结尾的都会导入进来
[include]
files = /etc/supervisor/conf.d/*.conf
# 在创建一个配置文件到/etc/supervisor/conf.d/bamboo.conf
[program:bamboo]
command=/root/code/venv/bin/gunicorn manage:app -c /root/code/gunicorn.conf
directory=/root/code/
user=root
autostart=true
autorestart=true
stdout_logfile=/root/code/logs/supervisor_out.log
stderr_logfile=/root/code/logs/supervisor_err.log
|
通过supervisorctl工具用来管理supervisor维护的进程
|
1
2
3
4
5
6
7
|
# reread来检测修改的配置内容, update来更新
# 这样就可以看到bamboo的process启动了
supervisorctl reread
supervisorctl update
# 也可以通过supervisorctl status 查看所有的项目进程
bamboo RUNNING pid 12928, uptime 2:13:05
|
这样我们的web服务已经启动起来了。