Installazione

Questa guida permette di installare e provare l'applicazione in ambiente development, nell'ultimo paragrafo viene spiegato come mettere l'applicazione in produzione con Unicorn e Nginx. Rubyfatt è un'applicazione Ruby on Rails standard, quindi si installa e configura come ogni altra applicazione Rails. Di seguito una descrizione di base.

Per iniziare si sceglie una cartella in cui installarla e vi si clona il repository:

cd ~/LA_MIA_CARTELLA
git clone [email protected]:tommyblue/Rubyfatt.git

Si entra quindi nella cartella appena clonata e si efettua il checkout all'ultimo tag stabile:

cd Rubyfatt
git checkout 1.3.0

Volendo provare l'ultima versione disponibile (HEAD) si salta il checkout.

Configurazione

Va modificat il file conf/databases.yml secondo le proprie esigenze. Se si vogliono fare soltanto delle prove basta personalizzare il blocco development, altrimenti va personalizzato il blocco production. Se non si utilizza MySQL va modificata la voce adapter e va di conseguenza inserita la corretta gemma nel file Gemfile al posto di:

gem 'mysql2'

Se, come nel caso di default, utilizzate MySQL, questi sono i passaggi necessari per creare il database e l'utente dalla console di mysql:

~$ mysql -u root -p
mysql> CREATE DATABASE `rubyfatt_development`;
mysql> GRANT ALL ON `rubyfatt_development`.* TO `my_user`@`localhost` IDENTIFIED BY 's3cr3tp4ssw0rd' WITH GRANT OPTION;
mysql> exit

Ovviamente queste istruzioni vanno personalizzate secondo le proprie necessità.

Per inserire i dati iniziali si personalizza il file db/seeds.rb con i propri dati alle righe 1-15 (corrispondenti alla creazione dell'utente). Le righe successive inseriscono alcuni dati di prova e possono essere eliminati o commentati, conviene lasciare la parte dei regimi di tassazione (dopo averla personalizzata) che comunque andrebbe creata prima di poter utilizzare l'applicazione.

Si può adesso installare le gemme necessarie utilizzando bundler. Se non fosse installato:

gem install bundler

al termine:

bundle install

A questo punto tutte le gemme necessarie sono installate e si possono far girare le migrazioni e il seed:

bundle exec rake db:migrate
bundle exec rake db:seed

Volendo si può saltare il seed e inizializzare l'applicazione via console Rails.

Creare il token segreto per firmare i cookie lanciando:

rake secret

L'hash ottenuto va inserito nel file config/initializers/secret_token.rb, scommentando la riga:

# Rubyfatt::Application.config.secret_key_base = 'PUT YOU SECRET TOKEN HERE'

A questo punto si può lanciare il server con:

~$ rails server
=> Booting WEBrick
=> Rails 3.2.12 application starting in development on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2012-08-22 10:46:20] INFO  WEBrick 1.3.1
[2012-08-22 10:46:20] INFO  ruby 1.9.3 (2012-04-20) [x86_64-darwin11.4.0]
[2012-08-22 10:46:20] INFO  WEBrick::HTTPServer#start: pid=9578 port=3000

L'applicazione è quindi disponibile all'indirizzo http://localhost:3000 e si può fare login con i dati di db_seeds.rb (quelli di default sono email "[email protected]" e password "password").

Deploy in produzione

Fin qui la guida ha permesso di utilizzare l'applicazione in modalità development. Questa modalità può comunque essere usata stabilmente lanciando l'applicazione ogni volta che se ne ha bisogno, ma se si ha un server (casalingo o in una server-farm) può risultare utile effettuare un deploy di produzione per avere l'applicazione sempre a disposizione o metterla a disposizione di più persone (Rubyfatt è infatti multiutente).