docker-compose-files/hyperledger_fabric/1.0.2

Hyperledger fabric 1.0.2

Here we show steps on how to setup a fabric 1.0.2 network on Linux (e.g., Ubuntu/Debian), and then use it to run chaincode tests.

If you're not familiar with Docker and Blockchain technology yet, feel free to have a look at 2 books (in CN):

• Docker Practice
• Blockchain Guide

Pass-through

The following command will run the entire process (start a fabric network, create channel, test chaincode and stop it.) pass-through.

$ make setup # install docker/compose, and pull required images
$ make all

tldr :)

make all actually call following command sequentially.

• make start
• make init
• make test_cc
• make stop

Otherwise, if u wanna know more or run the command manually, then go on reading the following part.

Environment Setup

The following scripts will setup the environment by installing Docker, Docker-Compose and download required docker images.

$ make setup # setup environment

If you want to setup the environment manually, then have a look at manually setup.

Bootup Fabric Network

Start a 4 peer (belonging to 2 organizations) fabric network.

$ make start  # Start a fabric network

The script actually uses docker-compose to boot up the fabric network with several containers.

There will be 7 running containers, include 4 peers, 1 cli, 1 ca and 1 orderer.

$ make ps
CONTAINER ID        IMAGE                        COMMAND                  CREATED             STATUS              PORTS                                                                                 NAMES
1dc3f2557bdc        hyperledger/fabric-tools              "bash -c 'while tr..."   25 minutes ago       Up 25 minutes                                                                                                            fabric-cli
5e5f37a0ed3c        hyperledger/fabric-peer               "peer node start"        25 minutes ago       Up 25 minutes       7050/tcp, 7054-7059/tcp, 0.0.0.0:8051->7051/tcp, 0.0.0.0:8052->7052/tcp, 0.0.0.0:8053->7053/tcp      peer1.org1.example.com
6cce94da6392        hyperledger/fabric-peer               "peer node start"        25 minutes ago       Up 25 minutes       7050/tcp, 7054-7059/tcp, 0.0.0.0:9051->7051/tcp, 0.0.0.0:9052->7052/tcp, 0.0.0.0:9053->7053/tcp      peer0.org2.example.com
e36c5e8d56c5        hyperledger/fabric-peer               "peer node start"        25 minutes ago       Up 25 minutes       7050/tcp, 7054-7059/tcp, 0.0.0.0:7051-7053->7051-7053/tcp                                            peer0.org1.example.com
1fdd3d2b6527        hyperledger/fabric-orderer            "orderer start"          25 minutes ago       Up 25 minutes       0.0.0.0:7050->7050/tcp                                                                               orderer.example.com
8af323340651        hyperledger/fabric-ca                 "fabric-ca-server ..."   25 minutes ago       Up 25 minutes       0.0.0.0:7054->7054/tcp                                                                               fabric-ca
e41d8bca7fe5        hyperledger/fabric-peer               "peer node start"        25 minutes ago       Up 25 minutes       7050/tcp, 7054-7059/tcp, 0.0.0.0:10051->7051/tcp, 0.0.0.0:10052->7052/tcp, 0.0.0.0:10053->7053/tcp   peer1.org2.example.com

Initialize Fabric network

$ make init  # Start a fabric network

The command actually calls the ./scripts/initialize.sh script in the fabric-cli container to:

• create a new application channel businesschannel
• join all peers into the channel
• install and instantiate chaincode example02 for testing

This script only needs to be executed once.

You should see result like the following if the initialization is successful.

==============================================
==========initialize businesschannel==========
==============================================

Channel name : businesschannel
Creating channel...

...

===================== All GOOD, initialization completed ===================== 

And there will be new chaincode container generated in the system, looks like

$ make ps
CONTAINER ID        IMAGE                                 COMMAND                  CREATED              STATUS              PORTS                                                                                                NAMES
9971c9fd1971        dev-peer1.org2.example.com-mycc-1.0   "chaincode -peer.a..."   54 seconds ago       Up 53 seconds                                                                                                            dev-peer1.org2.example.com-mycc-1.0
e3092961b81b        dev-peer1.org1.example.com-mycc-1.0   "chaincode -peer.a..."   About a minute ago   Up About a minute                                                                                                        dev-peer1.org1.example.com-mycc-1.0
57d3555f56e5        dev-peer0.org2.example.com-mycc-1.0   "chaincode -peer.a..."   About a minute ago   Up About a minute                                                                                                        dev-peer0.org2.example.com-mycc-1.0
c9974dbc21d9        dev-peer0.org1.example.com-mycc-1.0   "chaincode -peer.a..."   23 minutes ago       Up 23 minutes                                                                                                            dev-peer0.org1.example.com-mycc-1.0

Test Chaincode

$ make test_cc # test invoke and query with chaincode

More details, see chaincode test.

Stop the network

$ make stop # stop the fabric network

Clean environment

Clean all related containers and images.

$ make clean # clean the environment

More to learn

Topics	Description
Detailed Explanation	Explain in detail how a 1-peer network start and test.
Fetch blocks	Fetch blocks using peer channel fetch cmd.
Use Events	Get events with block-listener
Artifacts Generation	Will explain the usage of cryptogen and configtxgen to prepare the artifacts for booting the fabric network.
couchDB	Use couchDB as the state DB.
kafka	Use kafka as the ordering backend
configtxlator	Use configtxlator to convert the configurations
[WIP] Some verification tests

Acknowledgement

• Hyperledger Fabric project.
• Hyperledger Fabric Getting Started.