Hyperledger Fabric 1.4 中文文档

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

摘要

本文档详细介绍了Hyperledger Fabric 1.4的使用方法和API文档，涵盖了Fabric的核心功能、任务定义与执行、远程命令执行、文件和目录管理以及输出管理等方面的内容。文档还提供了Fabric的环境变量 설정、密码管理、SSH配置文件使用等高级主题，并介绍了 Fabric 1.4版本中新增的功能和改进。同时，还包括了Fabric的执行模型、任务执行策略、错误处理机制以及与远程程序的集成方法。

AI总结

以下是对《Hyperledger Fabric 1.4 中文文档》的总结，语言简洁明了，突出核心观点和关键信息：

---

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

#### 1. **基本信息**
- 本文档是 Hyperledger Fabric 的中文文档，涵盖了使用方法、API 文档、变更历史和维护信息等内容。
- Fabric 的官方网站为 [http://fabfile.org/](http://fabfile.org/)，提供更详细的基本信息。

#### 2. **文档结构**
- **入门教程**: 适合新用户，概述 Fabric 的基本功能。
- **使用文档**: 扩展了概览与教程中提到的概念，涵盖了高级主题。
- **API 文档**: 自动生成的详细 API 文档，分为核心 API 和扩展 API。

#### 3. **核心功能模块**
- **环境变量与执行模型**:
- 支持并行执行（`--parallel`），1.3 新增功能。
- 支持 SSH 配置文件和策略（如 `reject_unknown_hosts`）。
- 提供多种执行策略（`defining tasks`、`defining host lists`）和失败处理机制。
- **任务定义**:
- 任务是 Fabric 的核心单元，可以通过装饰器或 `execute` 函数执行。
- 支持新式任务（继承 `Task` 类）和传统任务。
- **连接与密码管理**:
- 支持通过 SSH 连接远程主机，管理密码和连接状态。
- 提供 `fab 选项和参数`，如 `--set`（1.4 新增）和 `--roles`，用于自定义环境变量和角色。

#### 4. **与远程程序集成**
- **命令执行**:
- 支持 `run` 和 `sudo` 执行远程命令，集成本地输入和远程输出。
- **文件管理**:
- 提供 `fabric.contrib.files` 模块，支持文件追加、删除、上传等操作。
- 示例：`append` 函数可将文本添加到远程文件中，支持部分匹配（`partial=True`）。
- **输出管理**:
- 输出层级分为多个独立的层级，如 `status`、`warnings`、`running` 等。
- 支持通过 `fabric.state.output` 或上下文管理器 (`hide` 和 `show`) 控制输出。
- 1.4 版新增了 `commands` 输出别名。

#### 5. **高级主题**
- **并行执行**: 1.3 版新增，支持任务并行运行。
- **SSH 行为**: 支持已知主机校验（`reject_unknown_hosts`）和未知主机处理。
- **新功能**:
- 1.4 版：新增 `--set` 参数、`commands` 输出别名。
- 1.7 版：新增 `shell_escape` 参数。

#### 6. **API 文档**
- 提供详细的 API 参考，包括核心功能的实现和使用方法。
- 使用 `docstring` 自动生成，覆盖了 Fabric 的基础构建块。

---

以上总结了《Hyperledger Fabric 1.4 中文文档》的核心内容，涵盖了基本信息、功能模块、关键更新和高级主题，语言简洁明了，逻辑连贯，便于快速理解和参考。