Gordo fulfills the role of inhaling config files and supplying components to the pipeline of:
Documentation is available on Read the Docs
gordo-helm - you can use gordo helm chart from this repository to deploy gordo infrastructure to your Kubernetes cluster.
pip install --upgrade gordo
With additional extras:
pip install gordo[postgres,mlflow]
Bleeding edge:
pip install git+https://github.com/equinor/gordo.git
This section will explain how to start development of Gordo.
Create and activate a virtual environment first. As a default option, it can be venv module.
Install pip-tools
pip install --upgrade pip
pip install --upgrade pip-tools
Install requirements
pip install -r requirements/full_requirements.txt
pip install -r requirements/test_requirements.txt
Install package:
python3 setup.py install
Note: you have to install pip-tools
version higher then 6
for requirements to have same multi-line output format.
To update some package in full_requirements.txt
:
requirements.in
file;pip-compile --upgrade --output-file=full_requirements.txt mlflow_requirements.in postgres_requirements.in requirements.in
See our example notebooks for how to develop with gordo
locally.
List of commands to run tests can be found here. Running of tests takes some time, so it's faster to run tests in parallel:
pytest -n auto -m 'not dockertest' --ignore benchmarks
Run docker-related tests:
pytest -m 'dockertest'
NOTE: To run tests it's required for your system to has (note: commands might differ from your OS):
- Running docker daemon.
- Available 5432 port for
postgres
container.NOTE: this example is for Pycharm IDE to use
breakpoints
in the code of the tests.
On the configuration setup for test running add toAdditional arguments:
inpytest
section following string:--ignore benchmarks --cov-report= --no-cov
This command will run the local documentation server:
> cd docs/
> make watch
We welcome contributions to this project! To get started, please follow these steps:
git clone https://github.com/your-account/your-project.git
git checkout -b your-feature-or-bugfix-branch
git commit -m "Add a new feature" -a
git push origin your-feature-or-bugfix-branch
We'll review your changes and work with you to get them merged into the main branch of the project.