使用 Fabric 部署

在下文开始之前，有几点需要明确：

Fabric 1.0 需要要被安装到本地。本教程假设使用的是最新版本的 Fabric 。
在下面的例子中，我们假设远程服务器使用 mod_wsgi 。当然，你可以使用你自己喜欢的服务器，但是在示例中我们选择 Apache + mod_wsgi ，因为它们设置方便，且在没有 root 权限情况下可以方便的重载应用。

fabfile 是控制 Fabric 的东西，其文件名为 fabfile.py ，由 fab 命令执行。在这个文件中定义的所有函数都会被视作 fab 子命令。这些命令将会在一个或多个主机上运行。这些主机可以在 fabfile 中定义，也可以在命令行中定义。本例将在 fabfile 中定义主机。

下面是第一个例子，比较基础。它可以把当前的源代码上传至服务器，并安装到一个预先存在的 virtual 环境中:

运行 Fabfile

那么如何运行 fabfile 呢？答案是使用 fab 命令。要在远程服务器上部署当前版本的代码可以使用这个命令:

$ fab pack deploy

但是这个命令需要远程服务器上已经创建了 :file:/var/www/yourapplication 文件夹，且 :file:/var/www/yourapplication/env 是一个 virtual 环境。更进一步，服务器上还没有创建配置文件和 .wsgi 文件。那么，我们如何在一个新的服务器上创建一个基础环境呢？

设置一个新服务器大致有以下几个步骤：

在 :file:/var/www 创建目录结构:


$ cd /var/www/yourapplication
$ virtualenv --distribute env

上传一个新的 application.wsgi 文件和应用配置文件（如 application.cfg ）到服务器上。

现在的问题是：和 application.cfg 文件从哪里来？

WSGI 文件必须导入应用，并且还必须设置一个环境变量用于告诉应用到哪里去搜索配置。示例:

应用本身必须像下面这样初始化自己才会根据环境变量搜索配置:

app = Flask(__name__)
app.config.from_object('yourapplication.default_config')
app.config.from_envvar('YOURAPPLICATION_CONFIG')

这个方法在一节已作了详细的介绍。

配置文件

一个流行的方法是在一个独立的版本控制仓库为不同的服务器保存不同的配置文件，然后在所有服务器进行检出。然后在需要的地方使用配置文件的符号链接（例如： :file:/var/www/yourapplication ）。

不管如何，我们这里只有一到两台服务器，因此我们可以预先手动上传配置文件。

现在我们可以进行第一次部署了。我已经设置好了服务器，因此服务器上应当已经有了 virtual 环境和已激活的 apache 配置。现在我们可以打包应用并部署它了:

Fabric 现在会连接所有服务器并运行 fabfile 中的所有命令。首先它会打包应用得到一个 tar 压缩包。然后会执行分发，把源代码上传到所有服务器并安装。感谢文件，所需要的依赖库会自动安装到 virtual 环境。

下一步

在前文的基础上，还有更多的方法可以全部署工作更加轻松：

创建一个初始化新服务器的 bootstrap 命令。它可以初始化一个新的 virtual 环境、正确设置 apache 等等。
把配置文件放入一个独立的版本库中，把活动配置的符号链接放在适当的地方。
还可以把应用代码放在一个版本库中，在服务器上检出最新版本后安装。这样你可以方便的回滚到老版本。

使用 Fabric 是一件有趣的事情。你会发现在电脑上打出 fab deploy 是非常神奇的。你可以看到你的应用被部署到一个又一个服务器上。