在阿里云服务器上配置CentOS+Nginx+Python+Flask环境

项目运行环境

阿里云(单核CPU, 1G内存, ubuntu 14.04 x64 带宽1Mbps), 具体购买和ssh连接阿里云本文不做描述。

实用工具

首先进入阿里云后先要升级下apt-get, 并下载所需软件

sudo apt-get update
sudo apt-get install vim git wget tmux

我还会使用zsh和oh-my-zsh来替换bash

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

chsh -s /bin/zsh

重新连接阿里云就可以看到效果, 具体主题可以根据自己喜好更改主目录下的.zshrc即可

安装python相关模块

使用python的pip包管理工具

sudo apt-get install Python-setuptools
sudo apt-get install python-pip
sudo pip install python-virtualenv

在主目录下创建文件夹code并把所有项目放进这个目录里

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这个文件中。

# 安装flask的相关模块
pip install -r requirements

# 创建一个manage.py文件, 用作管理我们的应用, 然后创建我们的一个应用。
touch manage.py

## 创建一个叫bamboo的应用
mkdir bamboo

## 创建一个应用的文件, 接下来我们要编辑这个文件了。
touch bamboo/__init__.py bamboo/app.py

项目目录结构是这样的

/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

## 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服务。

# 注意我们是通过pip来安装，所以该模块所有文件都是在venv里面
pip install gunicorn

可以进入目录vevn/bin下查看是否存在gunicorn命令

# 这里我们编辑下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

# 不适用gunicorn运行
python manage.py runserver

# 使用gunicorn 运行
# 这里需要注意一下, 冒号前面的是文件名也就是manage.py而后面的是应用的名称。我在这里载过跟头。因为服务器需要接受一个wsgi的应用而manager = Manager(app)不是一个wsgi应用所以报错
gunicorn manage:app

我们创建一个gunicorn配置文件gunicorn.conf并把他放到code目录下

## gunicorn.conf

workers=3
bind='127.0.0.1:5000'

安装Nginx

我们通过Nginx来反向代理我们的服务。

# 首先下载一个nginx
sudo apt-get install nginx

我们可以访问我们的域名或IP地址，如果出现Nginx的提示就表示安装成功了。
nginx安装在/etc/nginx/目录下,　我们把项目的配置文件放到/etc/nginx/sites-available/

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/

# 这里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

# 编辑/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维护的进程

# reread来检测修改的配置内容, update来更新
# 这样就可以看到bamboo的process启动了
supervisorctl reread
supervisorctl update 

# 也可以通过supervisorctl status 查看所有的项目进程
bamboo              RUNNING  pid 12928, uptime 2:13:05

这样我们的web服务已经启动起来了。