summaryrefslogtreecommitdiff
path: root/doc/source/contributor/running-in-development.rst
blob: 4645b48ed2f26640c691f44dc9216cfec51ef58e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
.. _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 ...