Cello Ansible Worker Node
Cello supports to deploy hyperledger fabric onto multiple physical or virtual servers using ansible, and achieve:
- Provision virtual servers to participate in fabric network
- Install necessary hyperledger dependent libraries and packages
- Setup kubernetes 1.7.0 or overlay network so that containers can communicate cross multiple docker hosts
- Install registrator and dns services so that containers can be referenced by name
- Build hyperledger fabric artifacts (optional)
- Run hyperledger fabric tests (optional)
- Generate fabric network certificates, genesis block, transaction blocks
- Push new or tagged fabric images onto all docker hosts
- Deploy fabric network
- Join peers to channels, instantiate chaincode
Requirements for ansible controller
- Install Ansible
- [Ubuntu 16.04 machines] (https://cloud-images.ubuntu.com/releases/16.04/)
- Install cloud platform dependent packages such as OpenStack shade or AWS boto
- Ansible 184.108.40.206 or above
Here is an example on how to make a clean ubuntu system as your ansible controller If you have other system as your Ansible controller, you can do similar steps to setup the environment, the command may not be exact the same but the steps you need to do should be identical.
sudo apt-get update sudo apt-get install python-dev python-pip libssl-dev libffi-dev -y sudo pip install --upgrade pip sudo pip install 'ansible>=220.127.116.11' git clone https://gerrit.hyperledger.org/r/cello
All the following work assumed that you are in cello/src/agent/ansible directory
Supported ansible versions are 18.104.22.168 or greater.
Deploy hyperledger fabric onto different environment
1. make changes to vars/vb.yml according to your VirtualBox environment 2. export password="your password to vb env" 3. To stand up the fabric network:: ansible-playbook -e "mode=apply" vb.yml 4. To tear down the fabric network:: ansible-playbook -e "mode=destroy" vb.yml
On OpenStack cloud::
1. make changes to vars/os.yml according to your OpenStack cloud 2. export password="your password of your OpenStack cloud account" 3. To stand up the fabric network:: ansible-playbook -e "mode=apply" os.yml 4. To tear down the fabric network:: ansible-playbook -e "mode=destroy" os.yml
On AWS cloud::
1. make changes to vars/aws.yml according to your aws cloud 2. export AWS_SECRET_KEY="your secret key of your aws account" 3. To stand up the fabric network:: ansible-playbook -e "mode=apply" aws.yml 4. To tear down the fabric network:: ansible-playbook -e "mode=destroy" aws.yml
Run fabric network on a single ubuntu server
Please follow instructions in document ansible worker usage to setup fabric network on one clean ubuntu 16.04 server.
Please refer to ansible worker how to.
This work is licensed under a Creative Commons Attribution 4.0 International License.