157 lines
6.8 KiB
Markdown
157 lines
6.8 KiB
Markdown
## Detailed Steps
|
|
|
|
### Environment Setup
|
|
|
|
The following scripts will setup the environment by installing Docker, Docker-Compose and download required docker images.
|
|
|
|
```sh
|
|
$ make setup # setup environment
|
|
```
|
|
|
|
If you want to setup the environment manually, then have a look at [manually setup](docs/setup.md).
|
|
|
|
### Generate crypto-config and channel-artifacts
|
|
|
|
```bash
|
|
$ 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](docs/config_generation.md).
|
|
|
|
### Bootup Fabric Network
|
|
|
|
Start a 4 peer (belonging to 2 organizations) fabric network.
|
|
|
|
```sh
|
|
$ 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.
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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
|
|
|
|
```bash
|
|
$ 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](docs/configtxlator.md).
|
|
|
|
### Stop the network
|
|
|
|
```bash
|
|
$ make stop # stop the fabric network
|
|
```
|
|
|
|
### Clean environment
|
|
|
|
Clean all related containers and images.
|
|
|
|
```bash
|
|
$ make clean # clean the environment
|
|
```
|
|
|
|
|
|
### Enable Event Listener
|
|
|
|
See [Event Listener](docs/event_listener.md).
|
|
|
|
### More to learn
|
|
|
|
Topics | Description
|
|
-- | --
|
|
[Detailed Explanation](./docs/detailed_steps.md) | Explain in detail how a 1-peer network start and test.
|
|
[Fetch blocks](docs/peer_cmds.md) | Fetch blocks using `peer channel fetch` cmd.
|
|
[Use Events](./docs/events.md) | Get events with block-listener
|
|
[Artifacts Generation](docs/artifacts_generation.md) | Will explain the usage of `cryptogen` and `configtxgen` to prepare the artifacts for booting the fabric network.
|
|
[couchDB](docs/couchdb_usage.md) | Use couchDB as the state DB.
|
|
[kafka](./kafka/README.md) | Use kafka as the ordering backend
|
|
[configtxlator](docs/configtxlator.md) | Use configtxlator to convert the configurations
|
|
[WIP] [Some verification tests](docs/verification_test.md) |
|
|
|
|
|