mac系统中如何搭建Hyperledger composer环境

发布时间：2021-12-06 15:07:25 作者：小新
来源：亿速云阅读：166

# Mac系统中如何搭建Hyperledger Composer环境

## 前言

Hyperledger Composer是构建区块链业务网络的强大工具集，它允许开发者快速建模、测试和部署区块链解决方案。本文将详细介绍在macOS系统上搭建Hyperledger Composer开发环境的完整流程，涵盖从基础依赖安装到最终环境验证的全过程。

---

## 一、环境准备

### 1.1 系统要求
- macOS 10.14 (Mojave) 或更高版本
- 至少8GB RAM（推荐16GB）
- 至少20GB可用磁盘空间
- 稳定的网络连接

### 1.2 必要工具安装

#### 1.2.1 安装Xcode命令行工具
```bash
xcode-select --install

1.2.2 安装Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1.2.3 配置环境变量

将以下内容添加到~/.zshrc或~/.bash_profile：

export PATH=/usr/local/bin:$PATH

二、基础依赖安装

2.1 安装Node.js和npm

brew install node@14

注意：Composer需要Node.js 8.x或10.x（推荐LTS版本）

验证安装：

node -v  # 应显示v14.x.x
npm -v   # 应显示6.x.x

2.2 安装Python 2.7

brew install python@2

2.3 安装Docker

brew install --cask docker

安装完成后需启动Docker Desktop应用

验证Docker：

docker --version
docker-compose --version

2.4 安装Git

brew install git

三、Hyperledger Fabric环境搭建

3.1 下载Fabric开发镜像

mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz

3.2 启动Fabric网络

./downloadFabric.sh
./startFabric.sh
./createPeerAdminCard.sh

3.3 验证Fabric运行状态

docker ps

应看到以下容器运行： - peer0.org1.example.com - couchdb - ca.org1.example.com - orderer.example.com

四、Hyperledger Composer工具链安装

4.1 全局安装Composer CLI

npm install -g composer-cli@0.20

4.2 安装REST服务器

npm install -g composer-rest-server@0.20

4.3 安装Playground

npm install -g composer-playground@0.20

4.4 安装Yeoman生成器

npm install -g generator-hyperledger-composer@0.20

4.5 验证安装

composer --version
composer-rest-server --version

五、开发环境配置

5.1 配置VSCode（推荐）

安装VSCode
添加扩展：
- Hyperledger Composer
- JavaScript ES6/ES7语法支持

5.2 创建开发目录

mkdir ~/composer-projects && cd ~/composer-projects

5.3 初始化业务网络

yo hyperledger-composer

选择”Business Network”并按照提示操作

六、示例项目部署

6.1 下载官方示例

git clone https://github.com/hyperledger/composer-sample-networks.git
cd composer-sample-networks/packages/basic-sample-network

6.2 部署业务网络

composer archive create -t dir -n .
composer network install --card PeerAdmin@hlfv1 --archiveFile basic-sample-network@0.2.0.bna
composer network start --networkName basic-sample-network --networkVersion 0.2.0 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card

6.3 导入业务网络卡片

composer card import --file networkadmin.card

6.4 启动REST服务器

composer-rest-server

访问 http://localhost:3000/explorer

七、环境验证与测试

7.1 验证网络状态

composer network ping --card admin@basic-sample-network

7.2 启动Playground

composer-playground

访问 http://localhost:8080

7.3 执行测试

npm test

八、常见问题解决

8.1 端口冲突问题

如果遇到端口冲突（特别是3000或8080）：

lsof -i :3000
kill -9 [PID]

8.2 Docker容器启动失败

尝试重置Docker：

docker rm -f $(docker ps -aq)
docker system prune

8.3 卡片导入错误

删除旧卡片：

composer card delete -n admin@basic-sample-network

8.4 版本兼容性问题

确保所有组件版本一致（推荐使用0.20.x系列）

九、维护与升级

9.1 备份业务网络

composer network export --card admin@basic-sample-network --outFile network.backup

9.2 升级组件

npm update -g composer-cli

9.3 清理环境

./stopFabric.sh
./teardownFabric.sh

结语

通过以上步骤，您已在macOS系统上成功搭建了完整的Hyperledger Composer开发环境。现在可以开始创建自己的区块链业务网络，或基于示例项目进行二次开发。建议定期查看官方文档获取最新更新。

注意：由于Hyperledger Composer已进入维护模式，新项目建议考虑使用Fabric SDK直接开发。 “`

这篇文章共计约3400字，采用Markdown格式编写，包含： 1. 清晰的分级标题结构 2. 详细的代码块和命令行操作 3. 注意事项和常见问题解决方案 4. 版本兼容性说明 5. 维护和升级建议

您可以根据实际需要调整各部分内容的详细程度或添加更多具体示例。