Instalujemy wszystko co potrzeba...

Ten tutorial "zerowy" pokaże jak należy zainstalować MySQL'a, Ruby, Ruby on Rails i środowisko Aptana (Radrails). Nie będzie to instrukcja jak zainstalować te narzędzia, by z nich normalnie (cokolwiek by to nie znaczyło) korzystać, lecz po to, by używać ich przy studiowaniu tutoriali z tego serwisu.

Krok 1: Ściągnięcie MySQL'a

Aby używać Ruby on Rails z bazą MySQL należy mieć zainstalowaną bazę. 
Jak to zrobić? Nic prostszego. Ze strony: http://dev.mysql.com/downloads/mysql/5.0.html#Windows
pobieramy pakiet Windows (x86) - jak na poniższym rysunku:

Krok 2: Instalacja bazy MySQL

Po rozpakowaniu archiwum zip, które ściągnęliśmy, uruchamiamy plik Setup.exe. Pojawi nam się okno powitalne:


Klikamy Next i w oknie wyboru typu instalacji Setup type:

Wybieramy opcję Typical setup i klikamy Next i w kolejnym oknie Install.
Po instalacji wyświetliły mi się jeszcze okna reklamowe, klikamy Next, Next itd.
W oknie MySQL.com Sign-Up wybieramy skip sign-up, gdyż pewnie nie chcemy by przychodziła nam dodatkowa korespondencja. I tak dojdziemy do okna dialogowego jak poniżej, gdzie zaznaczamy checkboxa i klikamy Finish.

Krok 3: Konfiguracja MySQL'a

W kolejnym oknie wybieramy Standard Configuration jako tryb konfiguracji:

i w następnym oknie zaznaczamy opcję install as windows sernice oraz include bin directory in windows path:

Na koniec, jako że potrzebujemy bazy tylko do ćwiczeń odznaczamy checkboxy przy security settings oraz anonymous account:

W kolejnym oknie klikamy Execute, by rozpocząć konfigurację. I na koniec, by zamknąć kreatora konfiguracji klikamy Finish:

Krok 4: Uruchomienie bazy MySQL

Najprostszą metodą uruchomienia MySQL'a to wywołanie mysql z linii poleceń (aby włączyć linię poleceń kliknij Start -> Uruchom i w wierszu poleceń wpisujemy cmd):


Error, który się wyświetlił znaczy nic innego, tylko że mamy zainstalowanego MySQL'a. Dlaczego? Gdyby nie był zainstalowany, pojawiłby się nam komunikat:

Co jednak, gdy chcemy użyć MySQL'a? Musimy się poprawnie zalogować. Aby to zrobić wpisujemy mysql -u root. Opcja -u pozwala na podanie usera na którego się logujemy. W naszym przypadku użytkownik root nie ma hasła, więc nie musimy podawać dodatkowo -p hasło.

Aby wyjść z MySQL'a wpisujemy exit, a baza powinna nam odpowiedzieć: Bye!

Krok 5: Ściągamy środowisko Ruby!

Instalator Ruby'ego możemy ściągnąć ze strony: http://rubyforge.org/frs/?group_id=167

Najlepiej wybrać ostatnią stabilną wersję (stable):

Krok 6: Instalacja Ruby'ego

Po ściągnięciu uruchomić instalator. W pierwszych dwóch oknach klikamy Next i akceptujemy licencję I Agree. W oknie wyboru komponentów zaznaczamy enable rubygems:

W powyższym oknie nie wybraliśmy komponentów Scite oraz Freeride. To proste edytory do rubiego, ponieważ jednak zajmiemy się Railsami, możemy je pominąć.

W kolejnym oknie dialogowm należy wybrać katalog instalacyjny, zostawmy domyślny c:\ruby:

Klikamy Next i w kolejnym oknie wybieramy nazwę pozycji jaka ma się znajdować w menu Start. Potem klikamy Install, czekamy jak się wszystko zainstaluje i po zakończeniu przydałoby się sprawdzić poprawność naszej instalacji.

W tym celu, tak jak przy MySQL'u uruchamiamy linię komend (Start->Uruchom cmd) i wywołujemy komendę ruby -v. Powinna się nam wyświetlić wersja Ruby'ego. Gdy natomiast wpiszemy gem list powinny się wypisać zainstalowane pakiety.

Krok 7: Instalacja Ruby on Rails


Ponieważ w międzyczasie RadRails został wchłonięty w środowisko Aptana, jeżeli planujecie instalować środowisko Aptana, to bezpośrednio w nim można doinstalować Rails'y. Wtedy należy przejœć od razu do kroku 11.

By zainstalować Ruby on Rails z linii komend wywołujemy polecenie:
gem install rails --include-dependencies

Jeśli wszystko się bez żadnych błędów zainstalowało, możemy przejść do kroku 9.
Jeśli jednak w trakcie instalacji pokazał nam się błąd:
ERROR: While executing gem ... (SocketError)
getaddrinfo: no address associated with hostname.
najlepiej spróbować zainstalować wymagane komponenty lokalnie, bez pobierania ich z repozytorium przez instalator. Sposób postępowania znajduje się w kroku 8 i jest to spolszczenie sposobu opisanego przez Ashish Kulkarni.

Krok 8: Instalacja Ruby on Rails bez pobierania z repozytorium przez instalator

Ze strony http://rubyforge.vm.bytemark.co.uk/gems/ ściągamy następujące pliki:

a. actionmailer-1.2.3.gem
b. actionpack-1.12.3.gem
c. actionwebservice-1.1.4.gem
d. activerecord-1.14.3.gem
e. activesupport-1.3.1.gem
f. rails-1.1.4.gem

Następnie w z linii komend wchodzimy do katalogu, gdzie ściągnęliśmy nasze pliki i uruchamiamy kolejno komendy:

gem install activesupport
gem install activerecord
gem install actionwebservice
gem install actionpack
gem install actionmailer
gem install rails

To powinno pomóc.

Krok 9: Sprawdzamy poprawność instalacji Railsów

Z linii komend wchodzimy do katalogu railsów (w naszym przypadku możemy wejść przy pomocy komendy: cd c:\ruby i w katalogu ruby utworzymy testowy projekt. Wpisujemy komendę:
rails test

Następnie wchodzimy do utworzonego katalogu aplikacji:
cd test
Wygenerujemy teraz szkielet testowego kontrolera hello z metodą index. Nie ważne w tym momencie co to tak naprawdę jest, ważne że sprawdzimy dzięki temu, że działają nam Railsy.

Aby wygenerowac testowy szkielet wpisz:
ruby script/generate controller Hello index

Teraz w wybranym edytorze tekstu otwieramy plik: test/app/controllers/hello_controller.rb i edytujemy go do następującej postaci:

class HelloController < ApplicationController  def index    @msg = 'hello'  end end

Następnie w wybranym edytorze otwieramy plik test/app/views/hello/index.rhtml i edytujemy do postaci:

 <h1>Hello#index</h1>  <p><%= @msg %></p>

Pora uruchomić serwer! W tym celu w linii komend wchodzimy do katalogu test i wywołujemy polecenie: ruby script/server

Zostawiamy okno z linią poleceń otwarte i w dowolnej przeglądarce internetowej wpisujemy: http://localhost:3000/hello i powinno wyświetlić się nam okno jak poniżej:

Oznacza to, że nasz framework Ruby on Rails działa poprawnie.

Krok 10: Instalacja środowiska RadRails


Ponieważ w międzyczasie RadRails został wchłonięty w środowisko Aptana, jeżeli planujecie instalować środowisko Aptana oraz doinstalować do niego Rails'y, warto opuścić ten krok.

Na początek ściągamy spakowanego RadRails'a ze strony:
http://sourceforge.net/project/showfiles.php?group_id=155448&package_id=173164

Następnie ściągnięte archiwum rozpakowujemy i kopiujemy katalog RadRails do katalogu w którym trzymamy programy np. Program Files. Następnie możemy uruchomić środowisko RadRails z pliku: radrails.exe. Gdy aplikacja zapyta o lokalizację workspace możemy wyznaczyć katalog, w którym będziemy trzymali projekty, najlepiej zaznaczyć use this as default, by program nie pytał ponownie.

Teraz już w zasadzie możemy przystąpić do tworzenia naszej pierwszej aplikacji w Ruby on Rails z wykorzystaniem środowiska RadRails.

Krok 11: Aptana + Rails

Dla potrzeb tutoriali z tej strony można zainstalować tylko RadRails'y. Jednak jeśli ktoś zaglądał na stronę RadRails.org zobaczy nazwę Aptana. Bowiem 8 marca 2007 roku Aptana - opensourcowe środowisko IDE służącym do tworzenia stron internetowych (HTML, CSS, XML), w których duży nacisk położony jest na technologię AJAX/Java Script wchłonęło RadRails'y i obsługuje Ruby on Rails. Pakiet Aptana + Rails dla Windows możemy ściągnąć ze strony:
http://www.aptana.com/download_rails_rdt.php

Postępowanie jest analogiczne jak dla RadRails. Ściągnięte archiwum rozpakowujemy i najlepiej kopiujemy katalog Aptana do katalogu w którym trzymamy programy. Środowisko uruchamiamy plikiem Aptana.exe.

Krok 12: Dinstalowanie Rails'ów do środowiska Aptana

Zaraz po uruchomieniu środowiska otrzymamy komunikat dotyczący obszaru roboczego. Ja zdecydowałem użyć katalogu C:\aptana aby trzymać tam swoje projekty:

Potem pojawi się nam ekran powitalny, który zignorujemy :)

Aby doinstalować Ruby on Rails z menu wybierz: Pomoc -> Aktualizacje oprogramowania -> Znajdź i zainstaluj.... Następnie w oknie dialogowym wybierz Szukaj nowych składników do zainstalowania i kliknij Dalej. W oknie jak poniżej zaznacz Ruby on Rails Development Enviroment i kliknij Zakończ:

Aplikacja powinna wyszukać składniki do zainstalowania, zaznaczamy je i klikamy Dalej:

Jak zwykle w czasie instalacji musimy zaakceptować warunki umowy licencyjnej (licencja CPL):

Wyświetlone zostaną składniki, które program bęzie chciał pobrać. Klikamy Zakończ:

Pozostaje już tylko odczekać, aż Aptana pobierze wszystkie składniki i zainstaluje je:

Koniec i bomba, a kto czytał ten trąba!