Hyperledger Fabric 1.4 中文文档

• 语言: 中文（简体）
• 格式: .epub
• 来源: fabric-chs.readthedocs.io

摘要

文档详细介绍了Hyperledger Fabric 1.4的连接缓存管理、任务执行机制、断开连接操作、并行执行功能以及密码管理策略。内容涵盖了连接缓存的使用与维护、任务执行的详细流程、断开连接的注意事项、并行执行的实现方式以及密码缓存的两级管理机制。文档还提到了多个新功能，如多次连接尝试、跳过不可用主机、命令超时设置等，并提供了相关的API文档和使用示例。

AI总结

《Hyperledger Fabric 1.4 中文文档》总结：

1. **连接缓存与管理**
- Fabric 的连接缓存不会主动关闭连接，而是由调用方负责管理。
- `fab` 工具会在退出前自动关闭所有打开的连接，而库用户需要手动调用 `disconnect all` 关闭连接。

2. **断注与连接管理**
- `disconnect all` 可能会在未来移到更公开的位置，目前仍在优化中。
- Fabric 支持多次尝试连接到远程服务器，失败后会根据 `env.skip_bad_hosts` 配置选择跳过无法连接的主机并继续执行。

3. **密码管理**
- Fabric 提供了一个两层密码缓存机制，用于记住登录和 sudo 密码，避免重复输入，适用于多个系统共享密码的情况。

4. **新功能**
- **1.4 版本**：
- `execute` 函数支持任务执行，返回每个主机的执行结果字典。
- 新增 `env.command_timeout` 配置，控制远程命令的超时时间。
- 支持 `--skip-unknown-tasks` 和 `--skip-bad-hosts` 命令行选项。
- **1.3 版本**：
- 新增返回值映射功能。
- `requires_parallel` 装饰器用于检查任务是否需要并行执行。
- **1.1 版本**：
- `execute` 函数支持传递任务参数，包括位置参数和关键字参数。

5. **与远程程序集成**
- Fabric 的 `run` 和 `sudo` 支持将本地输入发送到远程程序，类似于 SSH。
- 处理输出时，Fabric 支持合并 stdout 和 stderr，且通过字节缓冲实现更高效的交互。

6. **文档结构与 API**
- Fabric 提供详尽的 API 文档，涵盖核心 API（如 `run` 和 `sudo`）和其他扩展功能。
- 用户可以通过 `fabfile` 定义任务，并通过命令行参数或环境变量进行配置。

总结：
Fabric 1.4 提供了强大的连接管理、任务执行和远程程序集成能力，支持灵活的配置和扩展。文档详细介绍了新功能、环境变量和 API 使用方法，适合开发者快速上手和深入使用。