Flask补充系列–将应用部署在Heroku上

之前曾经介绍过如何将Flask应用部署在自己的服务器上，对于手头并不宽裕的程序员来说，购置一台托管服务器还是一笔不小的开销。即便现在有公有云服务器可以买，不过如果你只是以学习为目的，这笔开销还是能省则省了。另外，如果你的应用中需要访问国外被河蟹掉的资源，在服务器上翻墙也是件麻烦事，所以这里我们补充一篇如何将Flask应用部署在Heroku上。

环境准备

Heroku是一个PaaS服务提供商，使用前，你需要先注册一个Heroku帐号，注册帐号是免费的。

此外你本地必须要有Python 2.7的开发环境，并且装好了Pip, Setuptools, Virtualenv等工具。对于Python开发者来说，这些都是必备的吧。此外Git客户端也是必须的，因为Heroku的代码管理用的是Git。

Heroku提供了一个非常方便的Getting Start教程，每种开发环境都有，我们可以打开Python的Getting Start，然后参照其说明创建一个Python Web应用。懒得看英文的朋友们，可以看我下面写的步骤。

在开始创建应用之前，你还需要安装Heroku的客户端工具，你可以根据你本地的操作系统选择安装包下载。这是一个命令行工具，基于Ruby实现，所以使用起来每个操作系统都一样。安装完成后，你可以打开命令行，输入下面的命令来验证安装是否成功：

1	$ heroku --version

如果安装成功，就在本地命令行里登录Heroku，执行命令：

1	$ heroku login

并输入你注册号的Heroku帐号及密码即可。

创建应用

网页创建应用

环境准备就绪了，我们开始创建一个应用。浏览器打开Heroku应用控制台，点击右上角的”+”号，并选择”Create new app”。
Create App

在创建页面中，输入你的应用名称，比如”flask-bjhee”，如果名称没有被占用，则会跳出绿色提示”flask-bjhee is available”。运行环境默认在美国，也可以选择欧洲。信息填完后，点击下方的”Create App”按钮，应用就创建完成了。
Fill App Info

接下来打开命令行，我们要初始化本地及远程代码库：

$ mkdir /home/bjhee/flask-bjhee      # 创建本地代码工作目录
$ cd /home/bjhee/flask-bjhee         # 切换到本地代码工作目录
$ git init                           # 创建本地代码库
$ heroku git:remote -a flask-bjhee   # 连接远程Heroku的flask-bjhee代码库

现在，我们就可以编写应用代码，并提交到Heroku上去了。

命令行创建应用

$ heroku create (xxx)		#省略会自动默认
$ git add .
$ git commit -m "yyy"
$ heroku git:remote -a flask-bjhee

部署应用

既然主要是在讲部署，那代码逻辑就简单些，Hello World吧。我们写一个Flask Web程序”run.py”，内容如下：

from flask import Flask
app = Flask(__name__)
 
@app.route('/')
def index():
    return 'Hello World!'
 
if __name__ == '__main__':
    app.run(host='0.0.0.0', debug=True)

然后，我们就写个”requirements.txt”文件，应用部署时Heroku远程环境会自动执行：

1	$ pip install -r requirements.txt

来安装应用依赖的库。我们的”requirements.txt”文件如下：

1 2	Flask==0.10.1 gunicorn==19.4.5

项目依赖Flask很好理解，为什么还要依赖gunicorn呢？因为我们不能靠Flask自带的Web服务器来运行Flask程序，所以gunicorn是个很好的选择。还记得如何通过Gunicorn运行Flask应用吗？对于上面的代码，我们只需执行”gunicorn run:app”即可。现在我们要告诉Heroku，应该使用这个命令来运行我们的应用。怎么做呢，就是在项目根目录里创建一个”Procfile”文件，然后写上：

1	web: gunicorn run:app --log-file -

这就告诉Heroku，启动Web时，要执行”gunicorn run:app –log-file -“。后面的”–log-file -“参数，是为了让日志只打印到标准输出stdout上，因为Heroku不提供我们写本地磁盘的功能。

再接下来，我们要写一个app.json来描述项目信息，”app.json”内容大致如下：

{
  "name": "Flask sample on Heroku",
  "description": "An example of deploying Flask web app to Heroku.",
  "image": "heroku/python",
  "repository": "https://git.heroku.com/flask-bjhee",
  "keywords": ["python", "flask" ]
}

另外根据习惯，我们应该写一个”README.md”来给用户看，”.gitignore”描述哪些文件类型不需要提交到代码库中去。好了，现在我们的目录结构如下：

flask-bjhee/
  ├ .gitignore
  ├ app.json
  ├ Procfile
  ├ README.md
  ├ requirements.txt
  └ run.py

让我们执行git提交命令，来部署到远程Heroku上去吧：

1
2
3

$ git add .
$ git commit -m "Initialize Project"
$ git push heroku master               # 提交到远程master分支

想看看效果，命令行里输入：

1	$ heroku open

就会启动浏览器，并打开地址”https://flask-bjhee.herokuapp.com/”，当然你也可以直接浏览器访问这个地址。有没有看到”Hello World!”？

本篇的示例代码可以在这里下载。

部分转自: 思诚之道

▲ 注意部署的时候有两个文件不能少,分别是Procfile和requestments.txt(名字必须完全一样,我就是拼错了一次和少了个s),失败的报错情况如图

完成后是这样的.heorku会自动根据你提供的requestments.txt安装相应的依赖库

配置数据库环境、迁移文件、表

heroku提供了自己的控制台,打开的命令为heroku run bash,之后就可以像在linux的终端下一样操作了

除了这种方法还可以指明使用heroku命令,需要做的是加上前缀heroku run,如heroku run python manage.py db init

官方介绍为:(如图

自定义域名

1	$ heroku domains:add apollo.nymrli.top

▲.注意需要认证账户,否则会出现下图结果

vertify

待认证好后,还需要用DNS解析,我用的是阿里云的万网解析,将heroku domains:add apollo.nymrli.top后heroku的值用CHAME记录解析.等个几秒后就可以用apollo.nymrli.top访问heroku上面的应用程序了

还有一个做法呢,是直接在heroku相应app的设置里面设置自定义域名,但是由于显示问题,容易复制错,导致无法被解析的问题…如果设置好CHAME解析30秒后还是无法用自定义域名打开的话,看看是不是值复制错了.

所以还是比较建议用命令heroku domains:add xxx来绑定