Hyperledger Fabric 示例项目安装配置指南

Hyperledger Fabric 示例项目安装配置指南

fabric-samples Samples for Hyperledger Fabric 项目地址: https://gitcode.com/gh_mirrors/fa/fabric-samples

项目基础介绍及主要编程语言

Hyperledger Fabric 示例项目 是Hyperledger Fabric区块链平台的一部分，提供了一系列用于学习和实验的智能合约（Chaincode）和应用程序示例。这些示例覆盖了从基本资产转移、私有数据处理到高吞吐量设计等多个方面，帮助开发者理解和应用Fabric的核心特性。项目主要使用 Go、JavaScript 和 TypeScript 作为链码和客户端应用程序的开发语言，并利用 Docker 和 Kubernetes 进行网络部署。

关键技术和框架

本项目基于以下关键技术与框架：

• Hyperledger Fabric: 一个模块化、企业级的分布式账本平台。
• Docker: 用于构建、分发和服务容器化的应用程序。
• Docker Compose: 简化多容器应用的定义和运行。
• Kubernetes (可选): 高度可扩展的自动化容器管理服务，用于更复杂的部署场景。
• 智能合约: 使用Go、JavaScript或TypeScript编写的在区块链上执行业务逻辑的代码。
• Apache-2.0 许可证: 开源软件使用的许可证。

安装与配置步骤

准备工作

系统要求

确保你的系统满足以下条件：

• 操作系统: Linux、macOS 或 Windows。
• Git: 用于克隆项目。
• Docker: 至少18.06版本，用于构建和运行网络容器。
• Docker Compose: 用于本地快速部署测试网络。
• Go环境（如果计划开发Go链码）: 至少1.13版本。
• Node.js（如果计划开发JavaScript或TypeScript链码和应用）: 最新稳定版。

安装Git, Docker与Docker Compose

1. Git: 访问Git官网下载并安装。
2. Docker: 访问Docker官网获取适合你系统的安装包并安装。
3. Docker Compose: 可以通过Docker文档安装。

设置Go环境（仅当开发Go链码时）

• 下载并安装Go，设置GOROOT指向安装目录，将GOPATH设置为你希望的工作区路径，通常设置为${HOME}/go。
• 添加Go的bin目录到你的PATH环境变量中。

Node.js与npm（仅当开发JavaScript或TypeScript链码时）

• 从Node.js官网下载安装最新稳定版。

克隆项目

打开终端，输入以下命令克隆项目：

git clone https://github.com/hyperledger/fabric-samples.git
cd fabric-samples

安装 Fabric 的二进制文件与 Docker 映像

遵循官方文档来下载Fabric的二进制文件和必需的Docker映像。

./network/startup.sh

这个脚本会下载必要的Fabric组件和启动测试网络所需的Docker映像。

启动测试网络

为了运行示例，你需要启动测试网络。进入fabric-samples/basic-network目录并执行：

cd basic-network
./start.sh

这将会创建一个基本的网络，包括两个组织，每个组织有一个节点，以及一个排序服务节点。

测试示例应用

以“基本资产转移”为例，切换回项目根目录并找到对应的JavaScript或Go应用程序目录。比如，对于简单的JavaScript应用：

cd ../asset-transfer-basic/application-javascript
# 运行应用程序前可能需要安装依赖
npm install
node app.js

对于Go应用程序，首先确保已正确设置了Go环境，然后:

cd ../asset-transfer-basic/application-go
go run main.go

以上步骤提供了Hyperledger Fabric示例项目的基本安装与配置流程。不同的示例可能有特定的运行指令，请参考各自子目录下的说明文档。务必阅读每个示例中的README文件，了解更多细节和高级配置选项。

fabric-samples Samples for Hyperledger Fabric 项目地址: https://gitcode.com/gh_mirrors/fa/fabric-samples