Deployer for Hyperledger Fabric networks onto Kubernetes
Project description
# nephos
Library to deploy Hyperledger Fabric projects to a Kubernetes cloud
[Prerequisites](#prerequisites)
- [Installation](#installation)
[Pip](#pip)
- [Git repository](#git-repository)
[Virtual environment](#virtual-environment)
[Requirements](#requirements)
- [Testing](#testing)
[Unit tests](#unit-tests)
[Usage](#usage)
## Prerequisites
This library requires an existing Kubernetes cluster.
For best results, use a real cluster (e.g. on a cloud like AWS, GCP, Azure, IBM Cloud, etc.). However, you may also use [Minikube](https://kubernetes.io/docs/setup/minikube/).
Either way, you will need to have the following tools installed:
[python 3.7.0](https://www.python.org/downloads/release/python-370/) or above
[kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
## Installation
### Pip
You can install nephos from PyPI by running:
pip install nephos
### Git repository
You can also download the git repository with:
And work locally by installing the following:
#### Virtual environment
This library currently only supports Python 3:
python3 -m venv ./venv
source ./venv/bin/activate
#### Requirements
All requirments are held in the requirements.txt file
pip install -r requirements.txt
## Testing
### Unit tests
Once you have all requirments installed, all the unit tests should pass:
PYTHONPATH=. pytest –cov=. –cov-report term-missing
## Usage
To use nephos, run the deploy.py executable CLI script.
For instance, you can see available commands/options by running:
./nephos/deploy.py –help
To install a full end-to-end fabric network, you can run:
./nephos/deploy.py -f ./PATH_TO_YOUR_SETTINGS/file.yaml fabric
You can also upgrade a network:
./nephos/deploy.py –upgrade -f ./PATH_TO_YOUR_SETTINGS/file.yaml fabric
> Example of development/production networks will be provided in future
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nephos-0.1.8-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6098f97409b3b8d73f4b1b541aa8c171140774ecff1bb1abfe350919f53134c3 |
|
MD5 | b910c4ae8d3afc706d3f2c3e4a73ccc2 |
|
BLAKE2b-256 | 55d4c87b050ba06449a8a84aa6fd7c957ce7844da99c748a558b0fc4232cda2c |