Repository archived on 2024-02-05.

This repository is not maintained anymore. The last Substra version using this repository is Susbtra 0.34.0. Please refer to the documentation to see compatible versions.

HLF k8s

HLF-k8s is a network of Hyperledger Fabric orderers and peers forming a permissioned blockchain.

It is part of the Substra project.

Prerequisites

• kubernetes v1.19
• kubectl v1.19
• helm v3

Local install

Use skaffold v1.20+.

To start hlf-k8s, run:

skaffold run

This will deploy hlf-k8s with:

• 1 orderer MyOrderer
• 2 organizations: MyOrg1 and MyOrg2

Running a specific version

To deploy locally a specific version of hlf-k8s, the recommended way is the following:

SUBSTRA_HLF_VERSION=0.0.16
git checkout $SUBSTRA_HLF_VERSION
skaffold deploy --images substra/fabric-tools:$SUBSTRA_HLF_VERSION --images substra/fabric-peer:$SUBSTRA_HLF_VERSION

Install a custom chaincode

By default, the skaffold run command will start a network using the default orchestrator-chaincode image.

To use a custom chaincode locally, you need to build and replace the chaincodes.image fields to use your local image of orchestrator-chaincode.

You can check how to do it in the helm chart documentation in the Test hlf-k8s with your own chaincode section

Production install / Changelog

Please refer to the helm chart documentation.

License

This project is developed under the Apache License, Version 2.0 (Apache-2.0), located in the LICENSE file.