6.8 KiB
Detailed Steps
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.
Generate crypto-config and channel-artifacts
$ make gen_config
The cmd actually calls scripts/gen_config.sh to generate the crypto-config and channel-artifacts.
More details can be found at Config Generation.
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
f6686986fe18 hyperledger/fabric-tools:x86_64-1.0.4 "bash -c 'cd /tmp;..." 6 seconds ago Up 14 seconds fabric-cli
c7f274bf60bc yeasy/hyperledger-fabric-peer:1.0.4 "peer node start" 6 seconds ago Up 11 seconds 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
c6c5f69f2d53 yeasy/hyperledger-fabric-peer:1.0.4 "peer node start" 6 seconds ago Up 12 seconds 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
3cad0c519e6f yeasy/hyperledger-fabric-peer:1.0.4 "peer node start" 6 seconds ago Up 13 seconds 7050/tcp, 7054-7059/tcp, 0.0.0.0:7051-7053->7051-7053/tcp peer0.org1.example.com
8b371209f6b8 yeasy/hyperledger-fabric-peer:1.0.4 "peer node start" 6 seconds ago Up 11 seconds 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
ba1f00a9c83c hyperledger/fabric-orderer:x86_64-1.0.4 "orderer start" 6 seconds ago Up 14 seconds 0.0.0.0:7050->7050/tcp orderer.example.com
Create Application Channel
$ make test_channel_create
The command actually calls the scripts/test_channel_create.sh script in the fabric-cli container, to create a new application channel with default name of businesschannel.
Join Peers into Application Channel
$ make test_channel_join
The command actually calls the scripts/test_channel_join.sh script in the fabric-cli container, to join all peers into the channel.
Intall Chaincode to All Peers
$ make test_cc_install
The command actually calls the scripts/test_cc_install.sh script in the fabric-cli container, to install chaincode example02 for testing.
Instantiate Chaincode in the Application Channel
$ make test_cc_instantiate
The command actually calls the scripts/test_cc_instantiate.sh script in the fabric-cli container, to instantiate chaincode example02.
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_invoke_query
The command actually calls the scripts/test_cc_invoke_query.sh script in the fabric-cli container, to test chaincode example02 with invoke and query.
Test System Chaincode
$ make test_lscc # test LSCC
$ make test_qscc # test QSCC
The command actually calls the scripts/test_lscc.sh and scripts/test_qscc.sh script in the fabric-cli container, to test LSCC and QSCC.
Test Fetch Blocks
$ make test_fetch_blocks # test fetch blocks
The command actually calls the scripts/test_fetch_blocks.sh script in the fabric-cli container, to test fetching blocks from channels.
Test Configtxlator
$ make test_configtxlator
The command actually calls the scripts/test_configtxlator.sh script in the fabric-cli container, to test configtxlator to change the channel configuration.
More details can be found at Configtxlator.
Stop the network
$ make stop # stop the fabric network
Clean environment
Clean all related containers and images.
$ make clean # clean the environment
Enable Event Listener
See Event Listener.
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 |