因为 GAE 在国内访问不便,所以平时有一些小应用,我都会放在 SAE 上面, 虽然 SAE 还有很多缺陷,但算是上手比较容易的一个了,最起码文档写的不错。
开发 SAE 上的应用,我一般都用 Flask,SAE 预装了 Flask,所以你可以直接用, 但我们难免会用一些没有预装的库。
如果是在以前,可能需要自己将 package 挨个 copy 到应用目录中,然后手动加载, 现在嘛,不需要那么麻烦了,SAE 有个非常不错的解决方案,见《安装依赖的第三方包》
你可以使用 saecloud 来代替 pip 安装第三方库
1
|
saecloud install -r requirements.txt |
这条命令会将第三方库安装在应用目录的 site-packages 目录下面,部署时可以将所有的依赖 打包成 zip 档案,这样上传和维护都很方便。
1
2
|
cd site-packages/ zip -r .. /site-packages .zip . |
在 index.wsgi 中将这些依赖加载进来
1
2
3
4
5
6
7
8
|
import os import sys root = os.path.dirname(__file__) # 两者取其一 sys.path.insert( 0 , os.path.join(root, 'site-packages' )) sys.path.insert( 0 , os.path.join(root, 'site-packages.zip' )) |
虽然是二者取其一,但学是推荐使用 zip 档案的方式。
有个问题是,我们需要打包的,只是 SAE 没有预装的包, 但我们本地开发还要依赖 Flask 这些预装的包, 都使用 saecloud 安装的话,这个包明显就会有冗余。
借鉴于 bower, npm 这些包管理器的依赖管理的优点, 我们显然应该将依赖库分离出来。
1
2
3
4
|
# 安装非预装依赖 pip install -r requirements.txt # 维护预装依赖 saecloud install -r requirements-dev.txt |
这样,只有 requirements.txt 中的包会被安装到应用目录下的 site-packages 文件夹中。
经过一些实践,我整理了自己用着比较顺手的源代码文件结构
Makefile
README.md
requirements-dev.txt
requirements.txt
site-packages
...
site <--- web app 目录
index.wsgi
main.py
config.yam
site-packages.zip <--- 打包的依赖库
...
我会将下面的文件加入到 .gitignore,以避免它们被提交到版本中。
/site/site-packages.zip
/site/index.wsgic
为了方便安装依赖和部署项目,我写了个 Makefile