Skip to content

Latest commit

 

History

History
67 lines (45 loc) · 2.04 KB

deployment-development.md

File metadata and controls

67 lines (45 loc) · 2.04 KB
Raw

Deploying browserperfdash for development or testing

This document contains instructions about how to quickly start running browserperfdash for development or testing with SQLite and the built-in HTTP server.

For production deployments, instead is recommended deploying with PostgreSQL and with an Apache or Nginx fronted. For that following the guide deployment-production.md instead.

Install dependendencies and fetch the code

  1. Install Debian package dependendencies

Currently, this project works with python3.7 only. To install the appropriate python3.7 packages and dependencies, you need to first add the "deadsnakes" PPA

$ sudo apt-get install python3.7 python3.7-pip python3.7-dev python3.7-distutils virtualenvwrapper
$ sudo apt-get install postgresql python-psycopg2
  1. Get the files

You can clone it directly from https://github.com/Igalia/browserperfdash

git clone https://github.com/Igalia/browserperfdash

Setup the python virtual environment and install pip requirements

  1. First, source the python virtual env tooling
source /usr/share/virtualenvwrapper/virtualenvwrapper.sh

Notes:

  • if installed via pip, the wrapper is usually at /usr/local/bin/virtualenvwrapper.sh
  • if you usually work with python virtual envs, it may be a good idea to add the above source command to your shell startup file (.bashrc or .zshrc) to have it automatically ready
  1. Lets create a virtual environment dashboard for our project
mkvirtualenv -p /usr/bin/python3.7 dashboard
workon dashboard
  1. Install pip requirements on the virtual environment

All the requirements are mentioned in the file requirements.txt.

cd /path/to/git/checkout/browserperfdash
pip install -r requirements.txt

Setup the database with PostgreSQL and the app config

See postgres-setup.md.

Run built-in HTTP server

python manage.py runserver