安装方法

应用环境介绍

• 支持 Linux 系统，本程序默认为 Ubuntu 14.04 - 16.04 系统。
• 默认的python， 2.7.6 - 2.7.11+。
• Ubuntu 系统默认安装的nginx。
• 默认使用系统自带的 sqlite 数据库。

文件组织架构

pyblog/
    app/
    config.py
    manage.py

前提条件

确保系统已经安装 virtuaenv。以下命令在 ubuntu 17.10 中测试成功。

sudo apt-get update && sudo apt-get upgrade
sudo apt-get install python3-pip
sudo pip3 install virtualenv

安装 nginx

$ sudo add-apt-repository ppa:nginx/stable
$ sudo apt-get update && sudo apt-get upgrade
$ sudo apt-get install build-essential python python-dev # 在 v2.0 新版本中无需该命令
$ sudo apt-get install nginx

运行 nginx

$ sudo /etc/init.d/nginx start

Nginx是一个提供静态文件访问的web服务，然而，它不能直接执行托管Python应用程序，而uWSGI解决了这个问题。让我们先安装uWSGI，稍候再配置Nginx和uWSGI之间的交互。

安装 uWSGI

sudo pip install uwsgi

安装 flask 的虚拟环境

$ cd /var/www
$ sudo apt-get install python-virtualenv
$ sudo mkdir pyblog #可以自定义目录的命名
$ sudo chown os373:os373 -R pyblog/ # os373 为系统的当前示例用户
$ git clone git@github.com:eastossifrage/pyblog.git
$ cd pyblog 
$ virtualenv flask
$ source flask/bin/activate
(flask)$
(flask)$ pip install -r requirements.txt

配置 nginx

首先删除掉Nginx的默认配置文件：

sudo rm /etc/nginx/sites-enabled/default

设置nginx用户组

修改nginx配置/etc/nginx/nginx.conf的启动用户

第1行 user os373  #最好是系统的当前用户

新建 nginx 配置文件 /var/www/pyblog/pyblog_nginx.conf：

server {
        listen 80;
        server_name os373.cn; # 自己的网站域名
        charset utf-8;
        client_max_body_size 75M;

        location / {
                try_files $uri @pyblog;
        }
        location @pyblog {
                include uwsgi_params;
                uwsgi_pass unix:/var/www/pyblog/pyblog_uwsgi.sock;
        }
}

将刚建立的配置文件使用符号链接到Nginx配置文件文件夹中

sudo ln -s /var/www/pyblog/pyblog_nginx.conf /etc/nginx/conf.d/

配置 uWSGI

设置目录的用户权限

最好和 nginx 的进程用户一致，此处同为当前用户 os373。

sudo mkdir /var/log/uwsgi
sudo chown -R os373:os373 /var/www/pyblog/
sudo chown -R os373:os373 /var/log/uwsgi/

uWSGI配置文件

创建一个新的uWSGI配置文件/var/www/pyblog/pyblog_uwsgi.ini

[uwsgi]
base = /var/www/pyblog
app = manage
module = %(app)

home = %(base)/flask
pythonpath = %(base)
socket = /var/www/pyblog/%n.sock
master = true
processes = 8
workers = 2
chmod-socket = 644
callable = app
logto = /var/log/uwsgi/%n.log

执行uWSGI，用新创建的配置文件作为参数：

uwsgi --uid os373 --gid os373 --ini /var/www/pybolg/pyblog_uwsgi.ini

后台启动 uwsgi

我们的工作现在基本完成了，唯一剩下的事情是配置uWSGI在后台运行，这是uWSGI Emperor的职责。

1 - uWSGI Emperor (在 ubuntu14.04上实验成功)

创建一个初始配置来运行emperor - sudo vi /etc/init/uwsgi.conf：

description "uWSGI"
start on runlevel [2345]
stop on runlevel [06]
respawn
 
env UWSGI=/usr/local/bin/uwsgi
env LOGTO=/var/log/uwsgi/emperor.log
 
exec $UWSGI --master --emperor /etc/uwsgi/vassals --die-on-term --uid os373 --gid os373 --logto $LOGTO

最后一行运行uWSGI守护进程并让它到/etc/uwsgi/vassals文件夹查找配置文件。创建这个文件夹，在其中建立一个到链到我们刚创建配置文件的符号链接。

sudo mkdir /etc/uwsgi && sudo mkdir /etc/uwsgi/vassals
sudo ln -s /var/www/pyblog/pyblog_uwsgi.ini /etc/uwsgi/vassals

2 - 添加 uWSGI Emperor 服务到 systemd (在 ubuntu16.04上实验成功)

这里有一个知识点，就是ubuntu 16.04 使用了systemd来管理启动项 首先，创建 sudo vi /etc/systemd/system/uwsgi.service 文件，内容如下：

[Unit]
Description=uWSGI Emperor
After=syslog.target

[Service]
ExecStart=/usr/local/bin/uwsgi --master --emperor /etc/uwsgi/vassals --uid os373 --gid os373 --logto /var/log/uwsgi/emperor.log
Restart=always
KillSignal=SIGQUIT
Type=notify
NotifyAccess=all

[Install]
WantedBy=multi-user.target

配置文件/etc/uwsgi/vassals。创建这个文件夹，在其中建立一个到链到我们刚创建配置文件的符号链接。

sudo mkdir /etc/uwsgi && sudo mkdir /etc/uwsgi/vassals
sudo ln -s /var/www/pyblog/pyblog_uwsgi.ini /etc/uwsgi/vassals

现在，flask应用就应该配置完成了。

配置flask应用数据库

(flask)$ python manage.py db init
(flask)$ python manage.py db migrate -m "initial migration"
(flask)$ python manage.py db upgrade

#### 创建插件数据库数据

v2.0 版本已删除插件功能，请自行安装相关插件。

重新启动服务

1 - ubuntu 14.04 系统启动方式

sudo service nginx restart
sudo service uwsgi restart

2 - ubuntu 16.04 系统启动方式

sudo systemctl restart nginx.service 
sudo systemctl restart uwsgi.service

你可以查看/var/log/uwsgi/文件夹下的access.log和error.log内容，并根据提示来判断程序是否正常运行。