Heroku 部署说明

Heroku本为提供Ruby云环境的平台，不过现在也支持 Python ，下面将描述如何在它上面 部署 Uliweb。此应用以 simple_todo 为例，可以从 uliweb-doc/projects/uliweb 中得到。

客户端下载及登录

首先保证你已经有了 heroku 的帐号。然后去它的客户端页面下载合适的客户端，这里我 以windows客户端为例。下载并安装后，首先执行:

heroku login

根据提示输入你的邮箱和密码，然后它会自动查找本地的ssh公钥，如果找到，则会问你是 否要上传。因为我以前已经安装过 git 所以已经生成过公钥。

创建项目

首先在本地创建一个目录作为你的项目目录，如: heroku。进入这个目录，然后执行:

heroku create --stack cedar

执行如图:

image

我们可以从结果中看到已经生成了可访问的URL和git仓库地址。在后面我们可以改个名。 不过我试了，如果还没有上传过代码，好象改不了。

文本没有使用virtualenv来创建 Python 环境，所以省略了这块的处理。

编写代码

首先保证你的uliweb的版本在 0.1.1 以上，因为从 0.1.1 才支持 heroku 。在项目目录 下执行:

uliweb support heroku

这样会在当前目录下生成:

lib/
.gitignore
app.py
Procfile
requirements.txt

其中:

lib/

用来存放你想上传的一些库。不过在一般情况下，你可以通过 requirements.txt 来安装，因此不一定需要。不过在 app.py 中会将 lib 目录添加到 sys.path 中。

.gitignore

因为 heroku 使用的是 git 上传版本，所以这里提供了一个简单的 .gitignore 文件， 你可以根据需要进行修改。

app.py

启动文件。它会自动识别 os.environ['PORT'] 如果没有缺省使用 5000 端口， 同时将 IP 绑定到 0.0.0.0 上。

Procfile

Heroku 会采用 foreman 来启动应用，你可以在本地用它来启动 uliweb 项目。访问 地址可以是 http://localhost:5000

因为我更熟悉nginx+uwsgi的模式，因此使用foreman的话不知道有没有性能问题。 并且没有看到如何配置静态文件？所以在我的试验中能用开发服务器来提供服务和 静态文件的支持。

requirements.txt

pip 安装需求文件，缺省要安装:

Uliweb==0.1.1
psycopg2==2.4.5
SQLAlchemy==0.7.7

因为 heroku 采用的是 postgreSql 数据库。

然后将 simple_todo (在uliweb-doc/projects/uliweb/simple_todo下) 的代码拷贝到项目目录下。 注意，这里没有单独创建一个project的项目目录，而是直接使用项目目录。所以在这个目 录下应该直接有 apps 子目录。当前目录结构如:

image

因为 heroku 可以直接运行后端的命令，因此就可以直接运行 uliweb 的命令行工具，如 同步数据库。所以将项目目录直接做为uliweb项目是为了方便执行命令行。

接着修改 apps/settings.ini ，内容为:

[GLOBAL]
DEBUG = True

INSTALLED_APPS = [
    'uliweb.contrib.staticfiles',
    'uliweb.contrib.orm',
    'uliweb.contrib.heroku',
    'todo',
    ]

[SITE]
SITE_NAME = '任务跟踪'
EMAIL = 'limodou@gmail.com'

在Heroku是可以使用 Debug 调试的。上面在 uliweb.contrib.orm 后面安装了 uliweb.contrib.heroku 。 在 uliweb.contrib.heroku 中可以自动从 os.environ 中获得 DATABASE_URL 的信息。

上面的代码基本上写好了。然后我们直接上传。

上传代码

首先在本地创建GIT创建，把所有代码提交进去:

git init
git add .
git commit -m "message"

然后检查一下remote中是不是有heroku:

git remote

如果没有则将上面的git地址添加到remote中去:

git remote add heroku <heroku地址>

然后开始push代码:

git push heroku master

在push成功时，会根据相关的requirements.txt等信息开始后台的部署和服务启动。但是 此时很有可能数据库还未生效。前面已经说了，uliweb.contrib.heroku 会从环境变量中 获得数据库连接的串，而uliorm所使用的数据库连接和 heroku 提供的是一致的。这块都 已经由这个 app 处理了。现在的关键就是要创建数据库的实现。

创建数据库

可以先用:

heroku config

结果如图:

image

可以看到有 DATABASE_URL 的信息。如果没有，说明数据库实例没有创建，则可以执行:

heroku addons:add shared-database

应用改名

前面说了，如果觉得自建的应用名不好看，可以修改一下，使用:

heroku rename <你想改的名字>

一旦名字修改了，你的服务URL和git的地址都将发生变化。不过服务地址会自动变化，所以 不用做什么特殊处理。

数据库表的同步

代码传完了，名字也改了，数据库也建了，但是访问 simple_todo 还是有问题，因为这个 例子需要创建一个 todo 的表。heroku没有提供phpadmin，不过它可以在本地执行远端的 命令，所以很方便，下面执行:

heroku run uliweb syncdb

这里你会看到 todo 表被创建的信息。这样就可以访问你的应用了。我的例子是 http://uliweb.herokuapp.com/

调试

在heroku上可以直接查看出错页面，所以还是挺方便。同时如果想看日志，可以执行:

heroku logs

参考

参考原 Heroku 的文档有些问题并不能解决，有些是通过这篇文档来解决的。

部署Python网站到Heroku云平台