Skip to main content

安装

布料最好通过 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：

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

蟒蛇

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上做开发工作（甚至只是运行测试套件），你可能还需要安装一些或所有以下包：

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

下载

要获取Fabric源代码的tar.gz或zip存档，您可以访问 Fabric的PyPI页面，除了作为 pip 和 easy-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:\>