Skip to main content

安装

布料最好通过 pip (强烈推荐)或 easy_install (旧的,但仍然可以正常工作)安装。:

$ pip install fabric

您还可以选择使用操作系统的程序包管理器;该包通常称为 fabricpython-fabric。例如。:

$ sudo apt-get install fabric

想要安装开发版本的高级用户可以使用 pip 来获取最新的主分支(以及Paramiko依赖的dev版本):

$ pip install -e git+https://github.com/paramiko/paramiko/#egg=paramiko
$ pip install -e git+https://github.com/fabric/fabric/#egg=fabric

警告

Fabric的开发安装,无论它们是否涉及源检出或直接 pip 安装,都需要事先安装Paramiko的开发版本,否则Fabric的安装可能会失败。

依赖

为了使Fabric安装成功,您将需要四个主要软件:

  • Python编程语言;

  • setuptools 包装/安装库;

  • Python Paramiko SSH库;

  • 和Paramiko的依赖,PyCrypto密码库。

并且,如果使用 并行执行模式

如果你使用Paramiko 1.12或以上,你还需要一个额外的依赖Paramiko:

请阅读有关这些的重要细节 - 有几个陷阱。

蟒蛇

Fabric需要 蟒蛇 版本2.5 - 2.7。有关其他Python版本的一些注意事项和注意事项:

  • 我们不打算支持 Python 2.4,因为它的年龄和Python 2.5中的有用工具的数量,如上下文管理器和新模块。也就是说,2.5特定功能的实际数量不是太大,我们将链接到但不支持第三方2.4兼容的分支。 (现在没有这样的叉存在,对我们的知识。)

  • 织物尚未在 Python 3.x 上测试,因此可能与该开发线不兼容。然而,我们试图至少有些前瞻性(例如使用 print() 而不是 print),并且一旦我们的依赖关系,将来肯定会移植到3.x。

setuptools

默认情况下,Setuptools 自带一些Python安装;如果你没有,你需要抓住它。在这种情况下,它通常包装为 python-setuptoolspy25-setuptools 或类似的。 Fabric可能会在将来放弃其setuptools依赖性,或包括对 Distribute 项目的替代支持,但是现在安装需要setuptools。

multiprocessing

一个可选的依赖,multiprocessing 库包含在Python的2.6版本和更高版本的标准库中。如果你使用Python 2.5并想使用Fabric的 并行执行功能,你需要手动安装它;推荐路由,像往常一样,是通过 pip。详情请参阅 多处理PyPI页面

警告

早期版本的Python 2.6(在我们的测试中,2.6.0到2.6.2)附带一个有错误的 multiprocessing 模块,它似乎导致Fabric在涉及大量并发主机的会话结束时挂起。如果遇到此问题,请使用 env.pool_size / -z 来限制并发量,或升级到Python> = 2.6.3。

Python 2.5不受影响,因为它需要PyAC版本的 multiprocessing,它比Python <2.6.3版本更新。

开发依赖

如果你有兴趣在Fabric上做开发工作(甚至只是运行测试套件),你可能还需要安装一些或所有以下包:

有关准确的测试/开发要求(包括版本号)的最新列表,请参阅源分发中包含的 requirements.txt 文件。此文件旨在与 pip 一起使用,例如。 pip install -r requirements.txt

下载

要获取Fabric源代码的tar.gz或zip存档,您可以访问 Fabric的PyPI页面,除了作为 pipeasy-install 的入口点之外,还提供手动下载。

源代码检查

Fabric开发人员使用 Git DVCS管理项目的源代码。要通过Git而不是下载官方版本来部署Fabric,您有以下选项:

注解

如果您通过源代码控制获取了Fabric源代码,并计划在将来更新您的检出,我们强烈建议使用 python setup.py develop - 它将使用符号链接而不是文件副本,确保导入库或使用命令-line工具将始终引用您的结帐。

有关织物开发的方法和信息,包括哪些分支可能感兴趣,以及如何帮助,请参阅 发展 页面。

ActivePython和PyPM

已安装了ActiveState的 ActivePython 分发版的Windows用户可能发现,Fabric最好与 其包管理器,PyPM 一起安装。下面是通过 pypm 安装Fabric的示例输出:

C:\> pypm install fabric
The following packages will be installed into "%APPDATA%\Python" (2.7):
 paramiko-1.7.8 pycrypto-2.4 fabric-1.3.0
Get: [pypm-free.activestate.com] fabric 1.3.0
Get: [pypm-free.activestate.com] paramiko 1.7.8
Get: [pypm-free.activestate.com] pycrypto 2.4
Installing paramiko-1.7.8
Installing pycrypto-2.4
Installing fabric-1.3.0
Fixing script %APPDATA%\Python\Scripts\fab-script.py
C:\>