Developer Guide¶
Quickstart Guides¶
Additional Developer prerequisites¶
Sphinx tool¶
Sphinx is a tool that makes it easy to create intelligent and beautiful documentation.
This tool is needed to build Hyperledger Bevel documentation from docs
folder.
- Sphinx version used 2.1.1
Sphinx installation: Follow the link to install sphinx documentation tool.
All Hyperledger Bevel documentation and Sphinx Configuration files (conf.py
) are located in docs/source folder.
To build the documentation, execute the following command from docs directory:
make html
# or for Windows
.\Make.bat html
Molecule¶
Molecule is designed to aid in the development and testing of Ansible roles. In Bevel, Molecule is used to check for common coding standards, yaml errors and unit testing Ansible code/roles.
- Molecule version used 2.22
Requirements
- Docker Engine
- Python3 (and pip configured with python3)
Molecule installation
Please refer to the Virtual environment documentation for installation best
practices. If not using a virtual environment, please consider passing the
widely recommended ‘–user’ flag when invoking pip
.
$ pip install --user 'molecule[docker]'
The existing test scenarios are found in the molecule folder under configuration of each platform e.g. platforms/shared/configuration/molecule folder.