Installation onto host machine¶
How to install BuildGrid directly onto your machine.
BuildGrid server currently only supports Linux. macOS and Windows platforms are not supported.
BuildGrid only supports
python3 >= 3.6 but has no system requirements.
Main Python dependencies, automatically handled during installation, include:
Install from sources¶
setuptools support. We recommend installing it in a dedicated
virtual environment. In order to do so in an environment named
placed in the source tree, run:
git clone https://gitlab.com/BuildGrid/buildgrid.git cd buildgrid python3 -m venv env env/bin/python -m pip install --upgrade setuptools pip wheel env/bin/python -m pip install --editable .
Once created, the virtual environment can be activated by sourcing the
env/bin/activate script. In an activated terminal session, simply run
deactivate to later deactivate it.
Once completed, you can check that installation succeed by locally starting the BuildGrid server with default configuration. Simply run:
env/bin/bgd server start data/config/default.conf -vvv
setup.py script defines extra targets,
redis. They declare required dependency for, respectively,
authentication and authorization management, generating documentation, running
unit-tests and different storage implementations. They can be use as helpers for
setting up a development environment. To use them run:
env/bin/python -m pip install --editable ".[auth,docs,tests]"