HACKING.md 3 KB

Development

System dependencies (Ubuntu 14.04 package names)

  • build-essential
  • postgresql-server-dev-9.3

Unpacked dependecies

  • PhantomJS >= 1.9.2 (http://phantomjs.org/)

    • NOTE: Just create sym links for that, for example:
    cd /usr/local/share
wget https://bitbucket.org/ariya/phantomjs/downloads/phantomjs-1.9.7-linux-x86_64.tar.bz2
tar xjf phantomjs-1.9.7-linux-x86_64.tar.bz2
sudo ln -s /usr/local/share/phantomjs-1.9.7-linux-x86_64/bin/phantomjs /usr/local/share/phantomjs
sudo ln -s /usr/local/share/phantomjs-1.9.7-linux-x86_64/bin/phantomjs /usr/local/bin/phantomjs
sudo ln -s /usr/local/share/phantomjs-1.9.7-linux-x86_64/bin/phantomjs /usr/bin/phantomjs

Ruby version

2.3.0

You can easily install it through the Ruby Version Manager - RVM. Instructions on how to do it can be found at http://rvm.io

It is expected to work with:

  • 2.1.5 Debian 8
  • 2.0.0 CentOS 7

NOTE: If you are using the gnome-shell, or any derivate like terminator, you have to mark on your profile the option to use a "login bash".

Environment setup

  • Gem installation:

    • bundle install

  • Database creation:

    • rake db:create

  • Database initialization (the seeds script will need the kalibro configurations service running):

    • rake db:setup

  • Alternatively you can just run the setup script (it will also need the kalibro configurations service running):

    • bin/setup

How to run the test suite

rake

Services (job queues, cache servers, search engines, etc.)

  • Kalibro Processor - version 1.2.1. You can find the latest changes directly on the repository. By default Mezuro will expect it to be running on port 8082 at localhost. In order to run it as expected, run on two different terminal instances:

    RAILS_ENV=local rails s -p 8082 RAILS_ENV=local rake jobs:work

  • Kalibro Configurations - version 2.1.0. You can find the latest changes directly on the repository. By default Mezuro will expect it to be running on port 8083 at localhost. In order to run it as expected, run:

    rails s -p 8083

Deployment instructions

Deployment is made through Capistrano (https://github.com/capistrano/capistrano)

cap production deploy

In order to do this, you must have the password.

Otherwise, you can also modify the deployment file at config/deploy.rb.

First Deploy

  1. Make sure that the deployment file config/deploy.rb is correctly configured to the installation server;
  2. Also, make sure that the installation server already has rvm installed;
  3. cap deploy:setup will install the ruby correct ruby version, the gemset and all the directories tree;
  4. cap deploy:migrations deploys the code and run all the migrations