kolla/doc/source/contributor/running-in-development.rst
Radosław Piliszek d9efe9cac6 Improve docs
Part of changes discussed during Kolla Kalls.
These make our documentation easier to digest.

Changes in conf.py are to avoid warnings from sphinx.

Change-Id: I76ab6786b271963252278fcf12f1a28cab520fdb
2021-03-17 10:14:51 +00:00

30 lines
815 B
ReStructuredText

.. _running-in-development:
==================================
Running Kolla Build in development
==================================
The recommended way to run in development
-----------------------------------------
The preferred way to run kolla-build for development is using ``tox``.
Run the following from inside the repository:
.. code-block:: console
tox -e venv -- kolla-build ...
The alternative way to run in development
-----------------------------------------
Sometimes, developers prefer to manage their venvs themselves. This is also
possible. Remember to install in editable mode (``-e``). Run the following from
inside the repository:
.. code-block:: console
python3 -m venv ~/path/to/venv
source ~/path/to/venv/bin/activate
python3 -m pip install -e .
kolla-build ...