fabric-samples/test-network-k8s/README.md

Kubernetes Test Network

This project re-establishes the Hyperledger test-network as a cloud native application.

Objectives:

• Provide a simple, one click activity for running the Fabric test network.
• Provide a reference guide for deploying production-style networks on Kubernetes.
• Provide a cloud ready platform for developing chaincode, Gateway, and blockchain apps.
• Provide a Kube supplement to the Fabric CA Operations and Deployment guides.
• Support a transition to Chaincode as a Service.
• Support a transition from the Internal, Docker daemon to External Chaincode builders.
• Run on any Kube.

Fabric, Ahoy!

Prerequisites

• kubectl
• Docker
• K8s: kind or Rancher / k3s
• jq
• envsubst (brew install gettext on OSX)

Quickstart

Create a KIND Kubernetes:

./network kind

For environments running Rancher k3s:

export TEST_NETWORK_CLUSTER_RUNTIME=k3s

./network cluster-init 

Launch the network, create a channel, and deploy the basic-asset-transfer smart contract:

./network up
./network channel create

./network chaincode deploy asset-transfer-basic basic_1.0 $PWD/../asset-transfer-basic/chaincode-java

Invoke and query chaincode:

./network chaincode invoke asset-transfer-basic '{"Args":["CreateAsset","1","blue","35","tom","1000"]}' 
./network chaincode query  asset-transfer-basic '{"Args":["ReadAsset","1"]}'

Access the blockchain with a REST API:

./network rest-easy

Tear down the test network:

./network down 

Tear down the cluster:

./network unkind

Detailed Guides

• Working with Kubernetes
• Certificate Authorities
• Launching the Test Network
• Working with Channels
• Working with Chaincode
• Working with Applications

DNS Resolution on OSX

Fabric's OSX binaries have been statically linked with the golang go DNS resolver. In some environments, this causes a brief but noticeable delay when issuing peer commands against the test network.

Workarounds to improve DNS resolution time on OSX:

• Reduce the system resolver timeout from the default 5s by adding to /etc/resolv.conf:

options: timeout 2

• Add manual DNS overrides for virtual hosts by adding to /etc/hosts:

127.0.0.1 org0-ca.vcap.me
127.0.0.1 org1-ca.vcap.me
127.0.0.1 org2-ca.vcap.me
127.0.0.1 org0-orderer1.vcap.me
127.0.0.1 org0-orderer2.vcap.me
127.0.0.1 org0-orderer3.vcap.me
127.0.0.1 org1-peer1.vcap.me
127.0.0.1 org1-peer2.vcap.me
127.0.0.1 org2-peer1.vcap.me
127.0.0.1 org2-peer2.vcap.me

• Compile the fabric binaries on a Mac and copy build/bin/* outputs to test-network-k8s/bin. Mac native builds are linked against the netdns=cgo DNS resolver, and are not subject to the timeouts associated with the Golang DNS resolver.