Skip to content

Latest commit

 

History

History
109 lines (78 loc) · 3.14 KB

CONTRIBUTING.md

File metadata and controls

109 lines (78 loc) · 3.14 KB
Raw

Development Environment Setup

You can quickly set up a dev env with virtualenv and Docker Compose.

First, create a virtualenv for Python2.7, activate it. Then install temBoard and run it with:

$ pip install -e .
$ temboard -c temboard.dev.conf --debug

temBoard is now waiting for PostgreSQL. Launch services:

$ docker-compose up

Go to https://127.0.0.1:8888/ to access temBoard runing with your code! An agent is already set up to manage the PostgreSQL cluster of the UI.

In case you are working on the agent at the same time, here are some more instructions otherwise you can jump to the next section.

Assuming that temboard-agent code is cloned along with temboard, create a docker-compose.override.yaml file with the following content:

version: '2'

services:
  agent:
    environment:
      TEMBOARD_SSL_CA: /usr/local/src/temboard-agent/share/temboard-agent_ca_certs_CHANGEME.pem
      TEMBOARD_SSL_CERT: /usr/local/src/temboard-agent/share/temboard-agent_CHANGEME.pem
      TEMBOARD_SSL_KEY: /usr/local/src/temboard-agent/share/temboard-agent_CHANGEME.key
    volumes:
      - ../temboard-agent/:/usr/local/src/temboard-agent/
    command: tail -f /dev/null

You can then run the $ docker-compose up command again.

Then in an other terminal, run the following commands:

$ docker-compose exec agent bash # enters the agent machine
# pip install -e /usr/local/src/temboard-agent/ # installs temboard-agent in dev mode
# sudo -u postgres temboard-agent

The last thing to do is to register the instance so that you don't have to do it manually in the interface. In an other terminal, use the following commands:

$ docker-compose exec agent bash # enters the agent machine
# sudo -u postgres temboard-agent-register --host $TEMBOARD_REGISTER_HOST --port $TEMBOARD_REGISTER_PORT --groups default $TEMBOARD_UI_URL

CSS

temBoard UI mainly relies on Bootstrap. The CSS files are compiled with SASS.

In case you want to contribute on the styles, first install the nodeJS dev dependencies:

npm install

Then you can either build a dist version of the css:

grunt sass:dist

Or build a dev version which will get updated each time you make a change in any of the .scss files:

grunt watch

Coding style

A .editorconfig file is included at the root of the repository configuring whitespace and charset handling in various programming language. The EditorConfig site links to plugins for various editors. See .editorconfig for a description of the conventions. Please stick to this conventions.

Python syntax must conform to flake8. Our CI checks new code with flake8.

Contribution Workflow

Fork the project, commit in a branch and open a new GithUb PR on https://github.com/dalibo/temboard.

Releasing

To release a new version:

  • Choose the next version according to PEP 440 <https://www.python.org/dev/peps/pep-0440/#version-scheme>_ .
  • Update setup.py, without committing.
  • Generate and push commit and tag with make release.
  • Push Python egg to PyPI using make upload.
  • Update docker image with make -C docker/ clean build push