docker-compose-files/hyperledger_fabric
AndyAlpha fcaa7dac4c
Update base.yaml
笔误
2020-09-15 17:24:03 +08: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 default osn config path 2020-07-28 21:50:54 -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 Minor fix 2018-06-07 14:34:24 +08:00
v1.1.0 Add cscc test 2018-11-09 15:46:31 +08:00
v1.2.0 Add v1.3.0 2018-10-11 13:53:01 +08:00
v1.3.0 Enable new chaincode lifecycle 2019-04-22 14:19:18 +08:00
v1.4.0 Fix log spec 2019-12-11 13:35:05 -08:00
v1.4.2 Fix kafka mode 2020-04-28 19:59:58 -07:00
v1.4.3 Remove unused files 2019-11-18 19:48:10 -08:00
v1.4.4 Update base.yaml 2020-09-15 17:24:03 +08:00
v1.4.5 Add HLF v1.4.5 2020-02-21 11:57:01 -08:00
v1.4.6 Add HLF v1.4.6 2020-02-27 14:48:23 -08:00
v1.4.7 Add discover sample 2020-06-03 10:14:40 -07:00
v1.4.8 Add HLF v1.4.8 2020-08-31 13:55:11 -07:00
v2.0.0 Test latest 2.0 images 2020-02-21 16:19:14 -08:00
v2.1.0 Fix #132: Re-gen files 2020-05-01 23:10:25 -07:00
v2.2.0 Add hlf v2.2 2020-07-17 13:28:31 -07:00
README.md Add HLF v1.4.8 2020-08-31 13:55: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.2.0 stable fabric 2.2.0 release.
Fabric v2.1.0 stable fabric 2.1.0 release.
Fabric v2.0.0 stable fabric 2.0.0 release.
Fabric v1.4.8 stable fabric 1.4.8 LTS release.
Fabric v1.4.7 stable fabric 1.4.7 LTS release.
Fabric v1.4.6 stable fabric 1.4.6 LTS release.
Fabric v1.4.5 stable fabric 1.4.5 LTS release.
Fabric v1.4.4 stable fabric 1.4.4 LTS release.
Fabric v1.4.3 stable fabric 1.4.3 release.
Fabric v1.4.2 stable fabric 1.4.2 release.
Fabric v1.4.0 stable fabric 1.4.0 release.
Fabric v1.3.0 stable fabric 1.3.0 release.
Fabric v1.2.0 stable fabric 1.2.0 release.
Fabric v1.1.0 stable 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.2.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=solo make test # Bootup a fabric network with solo mode
$ HLF_MODE=couchdb make test # Enable couchdb support, web UI is at `http://localhost:5984/_utils`
$ HLF_MODE=event make test  # Enable eventhub listener
$ HLF_MODE=kafka make test # Bootup a fabric network with kafka mode
$ HLF_MODE=be make test  # Start a blockchain-explorer to view network info

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