History

Baohua Yang 472c7e7b62 Add local var		2024-05-01 16:46:03 -07:00
..
docs	Fix docs and scripts	2017-12-07 13:55:24 +08:00
fabric-ca	Use fabric ca for fabric 1.3	2018-10-26 03:41:17 -07:00
latest	Use fabric v2.4.0 as latest	2022-01-18 14:00:08 -08:00
test	Add local var	2024-05-01 16:46:03 -07:00
v0.6.0	Add fabric 1.0.5	2017-12-07 10:54:06 +08:00
v1.0.0	Add fabric 1.0.5	2017-12-07 10:54:06 +08:00
v1.0.6	Fix typo	2021-05-03 14:24:01 -07:00
v1.1.0	Fix typo	2021-05-03 14:24:01 -07:00
v1.2.0	Fix typo	2021-05-03 14:24:01 -07:00
v1.3.0	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.0	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.2	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.3	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.4	Add node sdk and java sdk containers	2021-08-18 14:21:05 -07:00
v1.4.5	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.6	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.7	Disable mounting raft volume	2022-03-23 14:37:30 -07:00
v1.4.8	Fix typo	2021-05-03 14:24:01 -07:00
v1.4.9	Fix typo	2021-05-03 14:24:01 -07:00
v2.0.0	Update dependencies	2022-08-12 11:52:10 -07:00
v2.1.0	Update dependencies	2022-08-12 11:52:10 -07:00
v2.2.0	Fix typo	2021-05-03 14:24:01 -07:00
v2.2.1	Clean up code	2021-09-09 22:00:32 -07:00
v2.2.4	Allow mounting osn data to local	2022-07-11 15:57:35 -07:00
v2.2.8	Add fabric v2.2.8	2022-08-12 11:46:47 -07:00
v2.3.0	Fix typo	2021-05-03 14:24:01 -07:00
v2.3.3	Add channel update script	2021-10-22 13:47:48 -07:00
v2.4.0	Add fabric v2.4.0	2022-01-18 13:49:57 -08:00
v2.5.0	Add v2.5.0	2023-04-14 10:58:11 -07:00
README.md	Add v2.5.0	2023-04-14 10:58:11 -07:00

README.md

Hyperledger Fabric Playground

This project provides several useful Docker-Compose script to help quickly bootup a Hyperledger Fabric network, and do simple testing with deploy, invoke and query transactions.

Currently we support Hyperledger Fabric all releases from v0.6.0, 1.x to latest 2.x.

If you're not familiar with Docker and Blockchain, can have a look at these books (in CN):

Supported Fabric Releases

Fabric Release	Description
Fabric Latest	latest fabric code, unstable.
Fabric v2.5.0	fabric 2.5.0 release.
Fabric v2.4.0	fabric 2.4.0 release.
Fabric v2.3.3	fabric 2.3.3 release.
Fabric v2.3.0	fabric 2.3.0 release.
Fabric v2.2.8	fabric 2.2.8 LTS release.
Fabric v2.2.4	fabric 2.2.4 LTS release.
Fabric v2.2.1	fabric 2.2.1 LTS release.
Fabric v2.2.0	fabric 2.2.0 LTS release.
Fabric v2.1.0	fabric 2.1.0 release.
Fabric v2.0.0	fabric 2.0.0 release.
Fabric v1.4.9	fabric 1.4.9 LTS release.
Fabric v1.4.8	fabric 1.4.8 LTS release.
Fabric v1.4.7	fabric 1.4.7 LTS release.
Fabric v1.4.6	fabric 1.4.6 LTS release.
Fabric v1.4.5	fabric 1.4.5 LTS release.
Fabric v1.4.4	fabric 1.4.4 LTS release.
Fabric v1.4.3	fabric 1.4.3 release.
Fabric v1.4.2	fabric 1.4.2 release.
Fabric v1.4.0	fabric 1.4.0 release.
Fabric v1.3.0	fabric 1.3.0 release.
Fabric v1.2.0	fabric 1.2.0 release.
Fabric v1.1.0	fabric 1.1.0 release.
Fabric v1.0.6	fabric v1.0.6 release.
Fabric v1.0.0	fabric v1.0.0 release.
Fabric v0.6.0	fabric v0.6.0 release (too old, not recommend to use).

Getting Started

TLDR

$ export RELEASE=v2.5.0

$ cd ${RELEASE}; make setup test

More details are as below.

Pick up a fabric version

Enter the subdir of specific version and setup, e.g.,

$ cd ${RELEASE} # select a fabric version
$ make setup download # Install docker/compose, and pull required images

Quick Test

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

$ make test  # Test with default fabric RAFT mode

Prometheus dashboard listens at http://localhost:9090 to track the network statistics.

Test with more modes

In v2.x, only raft is supported.

In v1.4.x, solo and kafka are also supported.

$ HLF_MODE=raft make test # Bootup a fabric network with solo mode

Detailed Steps

See detailed steps

Specify Version Numbers

.env: docker images tags, used by those docker-compose files;
scripts/variable.sh: docker images tags and project versions, used by scripts;

Acknowledgement

Hyperledger Fabric project.