作为库使用
从文档中我们可以看出,Fabric 最主要的应用场景是通过 fab 命令来引用 fabfile ,然而 Fabric 的内部实现在保证它在不使用 fab
和 fabfile 的场合也非常易于使用——本文档将会详细向你介绍。
此外还有写需要时刻谨记的事情,比如:编写好 fabfile ,运行 fab
命令时是怎样创建并断开连接的。
连接服务器
前面我们已经介绍过 Fabric 是怎样连接主机的,不过仍有些知识埋藏在 运行 文档中,具体来说你可能需要快速浏览一遍 Connections 章节的文档。(虽然不必要,但我强烈建议你把整个文档都快速浏览一遍。)
如那些章节中所提到的, run
和 sudo
这样的操作在连接时都会查看同一处设置: env.host_string 。其它设置主机列表的机制都用于 fab
命令,和作为 Python 库使用没有关系。
也就是说,在 Fabric 1.3 中,如果你想要结合任务 X
和主机列表 Y
,可以使用 execute
,就像这样: execute(X, hosts=Y)
,详细介绍请访问 execute
文档——手动操作主机列表功能真的很有必要。
断开连接
fab
所做另一件重要的事是,会在会话结束的时候断开所有连接,否则 Python 程序将永远等待网络资源的释放。
在 Fabric 0.9.4 或更新版本中,你可以使用这个函数方便地实现这个功能: disconnect_all
,只需要保证程序结束的时候调用该方法(通常在 try: finally
表达式中,以防意外的错误导致无法释放连接)即可。
如果你使用的是 Fabric 0.9.3 或更早之前的版本,你可以这样做( disconnect_all
仅仅提供了更好看的输出):
from fabric.state import connections for key in connections.keys(): connections[key].close() del connections[key]
最后注意
本文档只是个草案,因此并不会详细覆盖作为 Fabric 库导入与使用 fab
命令之间的全部区别,不过上面已经列出了其中最需要注意的陷阱。在不确定如何使用时,可以参考 Fabric 源代码中 fabric/main.py
部分,fab
命令的实现主要在这里,相信会是很有用的参考。