README - Kalibro Gatekeeper¶ ↑

<img src=“https://codeclimate.com/github/mezuro/kalibro_gatekeeper.png” /> <img src=“https://travis-ci.org/mezuro/kalibro_gatekeeper.png?branch=master” alt=“Build Status” />

Mezuro is a source code tracking platform based on Noosfero social networking platform with Mezuro Plugin actived to access Kalibro Web Service.

Development¶ ↑

• System dependencies (Ubuntu package names)

  • build-essential

  • curl

• Ruby version

  2.1.2

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

  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”.

• Configuration

  bundle install
  

• Database creation

  rake db:setup
  

• How to run the test suite

  rake
  

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

  Kalibro Web Service 1.0 r6 You can find a script to install it on Ubuntu at gist.github.com/m45t3r/0c4ad3b5700c6364abf1/f77701622ddc1d54d84757cc9ab59811e0ad6124 (if you’re brave gist.github.com/rafamanzo/6179925/ shows a unstable script with JBoss instead of Tomcat)

• Deployment instructions

  Deployment is made through Capistano (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.

Install¶ ↑

• 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

Contributing¶ ↑

Please, have a look the wiki pages about development workflow and code standards:

• github.com/mezuro/mezuro/wiki/Development-workflow

• github.com/mezuro/mezuro/wiki/Standards

License¶ ↑

Copyright © 2013-2014 The Author developers.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <www.gnu.org/licenses/>.

Authors¶ ↑

Please see the humans.txt (at the ‘public` folder) file with the authors

Acknowledgments¶ ↑

The authors have been supported by organizations:

University of São Paulo (USP) FLOSS Competence Center ccsl.ime.usp.br