Fabric network builder

Setup

You must have fabric checked out at $GOPATH/src/github.com/hyperledger/fabric and the branch luthersystems/master must be present (typically fetched from the remote git@github.com:luthersystems/fabric.git).

Build the luthersystems/fabric-network-builder container.

make

Mount your project directory under an identical path in the fabric-network-builder container and invoke the container with option --chown in order to have fabric-network-builder set the file owner/group correctly. In order for the container to run docker (compose) commands /var/run/docker.sock also needs to be mounted (for up, down, and install).

PROJECT_PATH=$(pwd)
docker run --rm -it \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v "$PROJECT_PATH:$PROJECT_PATH" \
    -w "$PROJECT_PATH" \
    luthersystems/fabric-network-builder \
    --chown $(id -u $USER):$(id -g $USER) \
    COMMAND [OPTIONS]

This pattern is best wrapped in a custom script. This project provides such a script as fabric-network-builder.sh. The wrapper script may be installed by refrencing it with a symlink inside the machine's PATH.

ln -s $(pwd)/fabric-network-builder.sh /usr/local/bin/fabric-network-builder

Usage examples here assume this setup and will invoke the docker container using the command fabric-network-builder.

Example

Generate artifacts network artifacts (mainly crypto-config)

fabric-network-builder generate

Launch the docker(-compose) network and join the default channel "luther" with all peers.

fabric-network-builder up

fabric-network-builder expects chaincode source to be placed in the chaincodes/ directory as a CAR file when installing. Copy CAR files from the chaintools build/ directory

CHAINCODE_PATH=/path/to/cc/app
CAR=com.luthersystems.chaincode.substrate01-0.0.1-SNAPSHOT.car
cp $CHAINCODE_PATH/build/$CAR ./chaincodes/
fabric-network-builder install substrate01 v0.0.1-SNAPSHOT $CAR

Initialize the chaincode using the fabric-client.yaml configuration file produced by fabric-network-builder to configure fabric-sdk-go.

shiroclient --config=/path/to/shiroclient.yaml \
    --fabric.client-config=fabric-client.yaml \
    init /path/to/substrate/phylum.zy

NOTE: See shiroclient for information about proper the contents of shiroclient.yaml

Terminate the docker network and destroy all containers when running the containers is no longer necessary.

fabric-network-builder down

Get fabric repos and checkout the v1.0.0 release. Note that the Github URLs provided are using SSH. Replace git@ with https:// if using https.

git clone git@github.com:hyperledger/fabric.git $GOPATH/src/github.com/hyperledger/fabric
git clone git@github.com:hyperledger/fabric-ca.git $GOPATH/src/github.com/hyperledger/fabric-ca
cd $GOPATH/src/github.com/hyperledger/fabric
git checkout v1.0.0
cd $GOPATH/src/github.com/hyperledger/fabric-ca
git checkout v1.0.0

Build fabric images and utilities.

cd $GOPATH/src/github.com/hyperledger/fabric
make docker
make release-all
export PATH="$PATH:$GOPATH/src/github.com/hyperledger/fabric/release/$(go env GOOS)-$(go env GOARCH)/bin"

Build the fabric-ca image.

cd $GOPATH/src/github.com/hyperledger/fabric-ca
make docker

Running chaincode

NOTE: These instructions are deprecated and no longer directly apply

Network setup

Run byfn.sh to generate network artifacts and bring the network up.

./byfn.sh -m generate
./byfn.sh -m up

Chaincode installation

To install chaincode CAR packages copy the files to the chaincode directory and run byfn.sh to install the chaincode.

cp /path/to/chaincode.car ./chaincode/chaincode.car
./byfn.sh -m install -C mycc -V v1.0 -P chaincode.car

Instead of running byfn.sh the script can be installed by entering the "cli" container.

docker exec -it cli bash ./scripts/install.sh mychannel mycc v1.0 chaincode.car

Network teardown

When finished using the network use byfn.sh to stop/remove containers and delete channel artifacts.

byfn.sh -m down

Full example

Destroy any existing network and generate a new one

./byfn.sh -m down -f
./byfn.sh -m generate -f
./byfn.sh -m up -f

Install the prop chaincode.

# optional step if the chaincode has been altered and rebuilt
cp $GOPATH/src/github.com/luthersystems/ProjectProp/Blockchain/prop-chaincodes/prop01/app/build/com.luthersystems.chaincode.prop01-0.0.18-SNAPSHOT.car chaincode/

./byfn.sh -m install -f -C prop01 -V v0.0.18-SNAPSHOT -P com.luthersystems.chaincode.prop01-0.0.18-SNAPSHOT.car

Instantiate the chaincode.

NOTE: This requires prop01 cli to be installed which reads prop01.yml for configuration.

prop01 Instantiate '{"metadata":{"timestamp":"2017-08-17T01:05:22Z"}}'

Create a location for volume mounts

mkdir -p dockertmp/msp
mkdir -p dockertmp/enroll_user
chmod -R 777 dockertmp

Bring up the application network

chmod -R a+r crypto-config
docker-compose -f docker-compose-prop.yaml up

Tear down the application network

docker-compose -f docker-compose-prop.yaml down
sudo rm -r dockertmp/*/*