This page describes how to setup and use a working Python development environment that can be used in developing masakari on Ubuntu. These instructions assume you’re already familiar with git.
Following these instructions will allow you to build the documentation and run the masakari unit tests.
Note
For how to contribute to Masakari, refer: http://docs.openstack.org/infra/manual/developers.html
Masakari uses the Gerrit code review system, refer: http://docs.openstack.org/infra/manual/developers.html#development-workflow
There are two ways to create a development environment: using DevStack, or explicitly installing and cloning just what you need.
To enable Masakari in DevStack, perform the following steps:
export DEVSTACK_DIR=~/devstack
git clone https://opendev.org/openstack/devstack.git $DEVSTACK_DIR
Enable the plugin by adding the following section to $DEVSTACK_DIR/local.conf
[[local|localrc]]
enable_plugin masakari https://opendev.org/openstack/masakari
Optionally, a git refspec (branch or tag or commit) may be provided as follows:
[[local|localrc]]
enable_plugin masakari https://opendev.org/openstack/masakari <refspec>
cd $DEVSTACK_DIR
./stack.sh
DevStack installs a complete OpenStack environment. Alternatively, to clone and install Masakari explicitly refer: Install and configure for Ubuntu
For a full documentation build, issue the following command from the masakari directory
tox -e docs
That will create a Python virtual environment, install the needed Python prerequisites in that environment, and build all the documentation in that environment.
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.