# kun812-fabric-tools

**Repository Path**: jeromekent/kun812-fabric-tools

## Basic Information

- **Project Name**: kun812-fabric-tools
- **Description**: 因为在windows环境下配置fabric很麻烦，MSP和初始交易不好生成。所以自己建了一个docker镜像，把常用的配置工具放了进去，方便配置，然后写了脚本方便启动
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 0
- **Created**: 2023-03-08
- **Last Updated**: 2023-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 使用说明

因为在windows环境下配置fabric很麻烦，MSP和初始交易不好生成。所以自己建了一个docker镜像，把常用的配置工具放了进去，方便配置。之后顺便写了脚本方便启动，但没写挂载智能合约的脚本。

#### 首先拉取工具镜像

```shell
docker pull kun812/fabric-tools:1.1
```

这里的示例为申请四个组织、一个通道，每个组织有两个节点，两个普通用户，一个Admin用户。要修改为自己的网络结构需做部分调整。

#### 准备工作

需要提前配置好docker，在windows环境需要下好git（Windows环境下所有命令要在git bash下运行）

如果不需要快速启动网络，就不用下载fabric镜像，需要搭建网络的话执行以下程序，拉取fabric镜像（也可以拉取其他版本）

```
docker pull hyperledger/fabric-peer:1.2.0 && 
docker pull hyperledger/fabric-orderer:1.2.0 && 
docker pull hyperledger/fabric-ca:1.2.0 && 
docker pull hyperledger/fabric-tools:1.2.0 && 
docker pull hyperledger/fabric-ccenv:1.2.0 && 
docker pull hyperledger/fabric-baseimage:0.4.10 && 
docker pull hyperledger/fabric-baseos:0.4.10 && 
docker pull hyperledger/fabric-couchdb:0.4.10 &&
docker tag hyperledger/fabric-peer:1.2.0 hyperledger/fabric-peer && 
docker tag hyperledger/fabric-orderer:1.2.0 hyperledger/fabric-orderer && 
docker tag hyperledger/fabric-ca:1.2.0 hyperledger/fabric-ca && 
docker tag hyperledger/fabric-tools:1.2.0 hyperledger/fabric-tools && 
docker tag hyperledger/fabric-ccenv:1.2.0 hyperledger/fabric-ccenv && 
docker tag hyperledger/fabric-baseimage:0.4.10  hyperledger/fabric-baseimage && 
docker tag hyperledger/fabric-baseos:0.4.10 hyperledger/fabric-baseos && 
docker tag hyperledger/fabric-couchdb:0.4.10 hyperledger/fabric-couchdb 
```

#### 操作步骤

首先删除channel-artifacts、crypto-config这两个文件夹下的文件，但不要删除这两个文件夹。

运行命令,生成msp和初始块。运行成功后，在channel-artifacts、crypto-config下会有新的文件。

```shell
./startcrpto.sh
```

在crypto-config文件夹下找到crypto-config\peerOrganizations\org1.XXXXXX.com\ca这个文件夹下的结尾为_sk的文件将文件名替换调到docker-compose.yml的FABRIC_CA_SERVER_CA_KEYFILE这一属性的最后一部分。

运行命令,启动网络。运行成功后，docker中会有新的容器生成。

```shell
./start.sh
```

具体的操作步骤只有这些，如果需要搭建自己的网络，需要做一些修改。

#### 如何搭建自定义配置的网络

搭建自己的网络最主要的就是修改configtx.yaml 、 crypto-config.yaml  这两个文件。crypto-config.yaml 文档可以类比之前写的，无非是复制粘贴和替换；configtx.yaml这一部分其实建议查看[官方文档](https://hyperledger-fabric.readthedocs.io/zh_CN/latest/create_channel/create_channel_config.html)进行修改。这里注意这两个文件组织的数量和名称得对应。

我这里主要阐明使用这里的脚本要做什么修改。

情况一：在crypto-config.yaml 中修改了组织的节点信息、用户信息，docker-compos.yml中修改

情况二：在configtx.yaml和  crypto-config.yaml中修改了组织信息，startcrpto.sh、start.sh、docker-compos.yml文件中都需要做修改

情况三：要修改了通道名称，在startcrpto.sh文件中做修改

情况四：增加了通道，在startcrpto.sh、start.sh文件中做修改

修改的内容我放在了脚本的注释中

#### 文件结构

![文件结构](./img/20230308151053.png)