安装¶
布料最好通过 pip (强烈推荐)或 easy_install (旧的,但仍然可以正常工作)安装。:
$ pip install fabric
您还可以选择使用操作系统的程序包管理器;该包通常称为 fabric
或 python-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:
ecdsa 库
请阅读有关这些的重要细节 - 有几个陷阱。
蟒蛇¶
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-setuptools
,py25-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源代码的tar.gz或zip存档,您可以访问 Fabric的PyPI页面,除了作为 pip
和 easy-install
的入口点之外,还提供手动下载。
源代码检查¶
Fabric开发人员使用 Git DVCS管理项目的源代码。要通过Git而不是下载官方版本来部署Fabric,您有以下选项:
直接从 Fabric组织的Github上的存储库,
git://github.com/fabric/fabric.git
克隆规范存储库通过创建一个Github帐户,访问 织物/织物 并单击“fork”按钮自己的Github存储库的分支。
注解
如果您通过源代码控制获取了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:\>