Pyblog —— 喜欢Markdown，爱上Pyblog!
Pyblog 是一个简单易用的在线 Markdown 博客系统，它使用 Python 的 flask 架构，理论上支持所有 flask-sqlalchemy 所能支持的数据库。博客的内容全部是 Markdown 格式，你只需要将写好的 Markdown文件的内容提交即可。Just so!
使用用法
应用环境介绍
- 支持 Linux 系统，本程序默认为 Ubuntu 14.04 - 16.04 系统。
- 默认的python， 2.7.6 - 2.7.11+。
- Ubuntu 系统默认安装的nginx。
- 默认使用系统自带的 sqlite 数据库。
文件组织架构
pyblog/
app/
config.py
manage.py
前提条件
sudo apt-get update && sudo apt-get upgrade
sudo apt-get install python-setuptools
sudo easy_install pip
sudo pip 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
$ 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
重新启动服务
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内容，并根据提示来判断程序是否正常运行。