Instant Rails è un pacchetto completo che contiene tutti i programmi necessari per iniziare subito a sviluppare in Ruby on Rails su piattaforme Windows. Per utilizzare Instant Rails è sufficiente scaricare il file zip dal sito internet ufficiale e decomprimerlo in una cartella sul proprio computer; Instant Rails non ha un vero e proprio processo di installazione, tutti i programmi e le librerie necessarie sono contenute nella cartella decompressa ed automaticamente riconosciuti.

È possibile ad esempio decomprimere Instant Rails su una chiavetta USB e iniziare a sviluppare in Rails; collegando la chiavetta a differenti computer Windows sarà possibile avere sempre con se tutto il proprio ambiente di sviluppo.

Oltre a Ruby e Ruby on Rails, InstantRails contiene una serie di applicazioni di norma utilizzati per lo sviluppo di applicazioni Ruby on Rails; il pacchetto contiene:

• Instant Rails Manager – una comoda interfaccia grafica per il controllo dei servizi e delle applicazioni sviluppate;
• Ruby – il linguaggio di programmazione indispensabile per utilizzare Ruby on Rails;
• Ruby on Rails – framework per lo sviluppo di applicazioni Web;
• Apache – il Web Service utilizzato per rendere le applicazioni sviluppate in Rails raggiungibili via internet;
• MySQL – il database relazionale utilizzato per salvare i dati delle proprie applicazioni;
• MySQL / Ruby – il driver che permette a Ruby, e quindi anche a Ruby on Rails, di dialogare con il database MySQL;
• Mongrel – l’Application Server, ovvero “il contenitore” delle applicazioni sviluppate in Rails;
• PHP – linguaggio di script utilizzato per rendere disponibile phpMyAdmin
• phpMyAdmin – comoda interfaccia Web per l’amministrazione del database MySQL.

A titolo di esempio sono state incluse nel pacchetto sue applicazioni funzionanti: Typo, sistema evoluto di pubblicazione di Blog, e CookBook, applicazione sviluppata seguendo il tutorial di ONLamp.com.

A supporto di Ruby vengono inoltre forniti i seguenti moduli: ruby-mswin32, zlib-lib, ZLib, RubyGems, Rake, RubySrc, FXRuby, FXri, SciTE, OpenGL, GLUT, SWin, VRuby, Expat, XMLParser, Hpricot, RubyDBI, DBD/ODBC, windows-pr, win32-file-stat, win32-file, win32-clipboard, win32-dir, win32-eventlog, win32-process, win32-sapi, win32-sound, log4r, Programming Ruby, OpenSSL, Iconv, readline, PDCurses, GDBM, Installer-Patches.

Installazione di Instant Rails

Collegarsi al sito ufficiale di Instant Rails e scaricare l’ultima versione del pacchetto disponibile. Il pacchetto .zip contiene una cartella denominata InstantRails; decomprimere il file nella cartella C:, nella cartella radice del proprio disco principale. È possibile spostare la cartella anche in altre posizioni o su altri supporti di memorizzazione, come hard disk esterni o pen drive. Questo articolo prevede che la cartella sia posizionata in C:.

Evitate di decomprimere il file .zip utilizzando la funzione Cartelle Compresse di Windows; sono stati infatti segnalati strani comportamenti con file .zip di grandi dimensioni o contenente molti file. Si consiglia di utilizzare il programma Open Source 7zip oppure il programma a pagamento WinRAR.

Accedendo alla cartella decompressa sul proprio hard disk si possono individuare i componenti del pacchetto:

• apache contiene il web server apache
• conf_files racchiude al suo interno una serie di file di configurazione fra cui my.ini (file di configurazione di MySQL), php.ini (il file di configurazione di PHP) e httpd.conf (file di
  configurazione di Apache); vedremo in seguito come modificare questi file utilizzando al meglio le funzionalità messe a disposizione da Instant Rails
• help contiene alcuni file di aiuto relativi a Instant Rails
• mysql contiene tutti i file del database server inclusi i file di dati dei database creati per le applicazioni Rails
• php contiene i file necessari all’esecuzione di PHP in accoppiata con Apache
• phpmyadmin contiene il programma in PHP per la gestione del database MySQL
• rails_apps è la cartella che contiene le applicazioni di esempio incluse nel pacchetto e le future applicazioni sviluppate in Rails
• ruby contiene tutti i file necessari ad eseguire il linguaggio di programmazione Ruby e una serie di librerie collegate
• safe contiene una serie di file di configurazione alternativi a quelli contenuti nella cartella conf_file da utilizzare nel caso si riscontrino dei problemi con i programmi contenuti in Instant
  Rails
• tmp contiene i file temporanei creati da Instant Rails
• www è la cartella che conterrà gli eventuali file da servire tramite Apache

I servizi di Instant Rails

Eseguendo il file InstantRails.exe dalla cartella principale di InstantRails (C:InstantRailsInstantRails.exe) viene mostrato un messaggio che chiede se è necessario rigenerare i file di configurazione. Dal momento che è il primo avvio di Instant Rails rispondiamo Ok e lasciamo che Instant Rails si preoccupi di generare i file di configurazione automaticamente.

Viene quindi visualizzato il pannello di controllo di Instant Rails dal quale è possibile accedere ai differenti servizi e alle applicazioni Rails installate.

I due semafori verdi a fianco delle scritte Apache e MySQL indicano il corretto funzionamento dei due servizi. Visitando con il proprio browser http://localhost/ si visualizza infatti il messaggio “Replace this File! This is the default index.html file being served out of the www directory. You should replace this with something more appropriate” prodotto da Apache.

Per assicurarsi del corretto funzionamento di MySQL e di phpMyAdmin visitare con il proprio borwser http://127.0.0.1/mysql/ e controllare che venga visualizzata la pagina riportata sotto.

Aprendo il menu a tendina posto in alto a sinistra sotto la scritta Database è possibile visualizzare l’elenco dei database attualmente presenti; fra i database installati automaticamente sono presenti quelli necessari ai due programmi Rails di esempio inclusi all’interno di Instant Rails (Typo e Cookbook).

Si consiglia di salvare l’indirizzo http://127.0.0.1/mysql/ nei propri preferiti in modo da poter accedere rapidamente alla gestione del database in qualsiasi momento.

Lanciare le applicazioni Ruby on Rails di esempio

Dal pannello di controllo selezionare l’icona di Instant Rails (la I maiuscola), quindi Rails Applications e Manage Rails Applications….

Apparirà la finestra di controllo delle applicazioni Rails installate; selezionare il checkbox a fianco dell’applicazione Typo e premere sul pulsante Start with Mongrel; apparirà una finestra di terminale all’interno del quale verrà lanciato in esecuzione una istanza di Mongrel in modo da attivare l’applicazione e renderla raggiungibile tramite browser. Attendere fino a che non compare un messaggio del tipo:

** Starting Mongrel listening at 0.0.0.0:3002
** Starting Rails with production environment...
** Rails loaded.
** Loading any Rails specific GemPlugins
** Signals ready. INT => stop (no restart).
** Mongrel available at 0.0.0.0:3002
** Use CTRL-C to stop.

Copiando l’indirizzo al quale è disponibile Mongrel (in questo caso 0.0.0.0:3002) e incollandolo nella barra degli indirizzi del proprio browser sarà possibile accedere all’applicazione appena lanciata; nel nostro caso apparirà la schermata di configurazione di Typo.

In modo del tutto simile è possibile lanciare l’applicazione Cookbook distribuito nel pacchetto Instant Rails.

Installare una nuova applicazione con Instant Rails

In questo paragrafo installeremo Tracks una applicazione Open Source utilizzando l’ambiente che Instant Rails ci mette a disposizione. In particolare installeremo l’applicazione Tracks dedicata all’organizzazione e all’ottimizzazione delle proprie attività secondo la metodologia GTD.

Scaricare l’ultima versione disponibile dell’applicativo (al momento la 1.043) e salvare il file .zip sul proprio desktop.

Decomprimere il file .zip nella cartella rails_app di Instant Rails così da ottenere una cartella del tipo C:InstantRailsrails_appstracks-1.043 contenente i file dell’applicazione.

Aprire il pannello di controllo di Instant Rails e selezionare l’icona di Instant Rails (la I maiuscola), quindi Rails Applications e Manage Rails Applications… in modo da raggiungere il pannello di configurazione delle applicazioni installate all’interno di Instant Rails.

Fra le applicazioni elencate dovrebbe apparire Track seguito dal numero di versione dell’applicazione installata (ad esempio tracks-1.043); se non dovesse apparire correttamente premete il pulsante Refresh List così che Instant Rails controlli nuovamente il contenuto della cartella rails_apps ed identifichi la nuova applicazione.

Ora che il codice è al posto giusto è necessario creare il database utilizzato necessario all’applicazione seguendo i passi canonici dell’installazione di una applicazione Rails: configurazione di database.yml, configurazione di environment.rb ed esecuzione del comando di importazione delle tabelle necessarie per la creazione del database.

Come fatto per avviare Typo, selezionare l’applicazione Tracks e premere sul pulsante Start with Mongrel

Visitare con il browser l’indirizzo http://localhost:3000/signup e procedere con l’utilizzo dell’applicazione.

Per disattivare l’applicazione selezionare la finestra di prompt aperta all’avvio dell’applicativo e premere Control+C

Creare le proprie applicazioni con Instant Rails

Per creare una propria applicazione in Rails pronta per essere utilizzata tramite Instant Rails è sufficiente posizionare la cartella del progetto all’interno della cartella rails_apps di Instant Rails e lanciare il comando rails nomeapplicazione.

Le applicazioni create nella cartella speciale rails_app vengono riconosciute come applicazioni in Ruby on Rails ed è quindi possibile attivare o disattivare le singole applicazioni per mezzo dei comandi che Instant Rails mette a disposizione.

Integrazione di Instant Rails con Eclipse / RadRails

Sia che si sia proceduto all’installazione di RaisRails in modalità stand alone, sia che si sia aggiornata una installazione di Eclipse con il plugin Rad Rails, è possibile integrare Instant Rails con Rad Rails per ottenere un ambiente di sviluppo ottimale.

Eclipse, e di conseguenza RadRails, ha il concetto di workspace, ovvero della cartella base che contiene tutte le cartelle dei differenti progetti. Il concetto di cartella workspace di RadRails corrisponde perfettamente al significato della cartella rails_app di Instant Rails; quando all’avvio di Eclipse / RadRails viene richiesto di indicare la cartella del proprio workspace, selezionare la cartella rails_app.

Risorse esterne:

• Il sito ufficiale di Instant Rails, da cui scaricare l’ultima versione
• Il sito ufficiale di Ruby on Rails
• 7zip, programma Open Source per gestire i file compressi
• Beast, applicazione per la gestione di forum in Ruby on Rails
• Php My Admin, sito ufficiale del programma di gestione del database
• Typo, una delle applicazioni di esempio distribuite con Instant Rails
• Tracks, applicazione in Rails per organizzare e ottimizzare il proprio tempo secondo la metodologia GTD