IBM Blockchain Network Composite Journey 使用指南

IBM Blockchain Network Composite Journey 使用指南

欢迎来到IBM的区块链应用构建系列教程的首篇——《区块链网络组合旅程》。本文档将引导您了解项目的基本结构、关键文件及其用途，以便您能够快速上手并运行此区块链网络示例。

1. 项目目录结构及介绍

该项目位于GitHub，其基本目录结构大致如下（具体路径可能会有所变化）：

• 根目录:

  • 包含了主要的脚本和说明文件。
  • README.md: 您现在正阅读的项目简介和入门指导。
  • LICENSE: 许可证文件，详细规定了代码的使用条件。
  • downloadFabric.sh, startFabric.sh, createPeerAdminCard.sh, stopFabric.sh, shutdownFabric.sh: 这些脚本分别用于下载Fabric环境、启动Fabric网络、创建对等节点管理员卡、停止以及销毁Fabric环境。

• 业务逻辑相关:

  • 根据实际项目可能包括.tx、.bna文件夹或文件，用于定义业务网络。
  • my-network.bna: 业务网络归档文件，包含了参与者、资产、交易等定义。

• 测试与部署:

  • 可能包含用于测试业务网络的脚本或测试文件，如执行测试命令的示例。

请注意，具体文件和目录名称需依据仓库中的实际结构为准，上述结构提供了一个大致框架。

2. 项目的启动文件介绍

• startFabric.sh: 此脚本是启动Hyperledger Fabric网络的关键。通过执行这个脚本，您可以初始化必要的区块链网络组件，包括启动peer节点、orderer以及其他必要服务，为部署和交互做好准备。

• createPeerAdminCard.sh: 创建管理员卡片的脚本，管理员卡片是Hyperledger Composer中用来管理业务网络的身份凭证，它允许用户进行网络的部署和其他高级操作。

3. 项目的配置文件介绍

在IBM的区块链网络示例中，配置通常分散在多个脚本和定义文件中：

• ** Fabric相关的配置文件**：通常在启动网络的过程中，会有配置文件指定网络参数，如peer节点的地址、证书位置、加密算法等。这些配置可能内嵌于脚本中，或是在特定的配置文件里（例如configtx.yaml, core.yaml），但具体的命名和位置需参考最新版本的文档和脚本注释。

• Business Network Definition (model-composer.json 或 .cto 文件): 定义参与者、资产和交易的业务逻辑。对于Composer项目，这是定义业务网络的核心文件之一。

• Network Archive (BNA): 如前所述，my-network.bna是一个压缩包，包含了所有业务网络定义和依赖，它的生成涉及业务模型和逻辑的编译过程。

为确保顺利操作，务必仔细阅读每个脚本中的注释，以及官方提供的最新文档，因为具体的命令和配置细节可能会随着更新而发生变化。此外，Hyperledger Fabric和Composer的版本更新也可能影响到项目的配置方式。