railsin asennus

❗ Asennuksessa kestää erityisesti laitoksen koneilla pitkään ❗

❗ HUOM sudoa ei tule käyttää Rbenv:iä tai muita ruby version managereja käyttäessä (poislukien kirjastojen asentaminen)❗ Asennus tehdään käyttäjän omaan kotihakemistoon.

Varaa asennukseen kunnolla aikaa ja tee se mieluiten joskus kun levypalvelinten käyttö on muutoin vähäistä. Älä jätä asennusta ohjauksen alkuun jos haluat tehdä muutakin kuin pyöritellä peukaloita.

--

Asennamme tässä Rubyn version 2.3.0 ja Railsin version 4.2.0 viimeaikoina suosioon noussella rbenv-versiomanagerilla https://github.com/sstephenson/rbenv

Voit halutessasi käyttää myös RVM:ää https://rvm.io/rvm/install eli rbenvin hieman vanhempaa lähisukulaista.

Älä kuitenkaan missään tapauksessa asenna Rubyä/Railsia Linuxin pakettinhallintajärjestelmän kautta!

Huom: seuraavassa on ohjeet ainoastaan Linuxille ja OSX:lle.

Ruby on Rails -sovelluskehityksen työkaluja ei ole kovin helppo asentaa Windows-ympäristöön. Kurssilla ei tarjota mitään tukea tai apua Windows-asennuksen tekemiseen. Windows-käyttäjille on tarjolla Virtual Box -image, johon on esiasennettu Linux sekä Rails-kehitysympäristö.

Jos haluat välttämättä käyttää Windowsia ja et suostu virtuaaliympäristön käyttöön, tapahtuu kurssille osallistuminen omalla vastuulla.

rbenv Linuxille

Allaolevat on testattu laitoksen koneissa ja Ubuntun uusimman LTS version kanssa. Seuraavassa luvussa ohjeet OSX:lle. Windowsiin asentaminen ainoastaan omalla vastuulla!

Huom: koneella tulee olla muutamia kirjastoja, joiden asennus onnistuu Ubuntussa komennolla sudo apt-get install build-essential zlib1g-dev libpq-dev git sqlite3 libsqlite3-dev. Laitoksen koneilla kirjastot ovat valmiina.

Huom2: fuksiläppärille ja ehkä muillekin koneille on asennettava kirjasto libffi-dev seuraavasti:

sudo apt-get install libffi-dev

Seuraa sivun https://github.com/sstephenson/rbenv#installation kohtaa Installation, Basic GitHub Checkout.

• HUOM: kohdissa 2 ja 3 joudut (ainakin) laitoksen koneissa muuttamaan tiedostoa .bashrc
• HUOM: muista asentaa myös ruby-build (yllä linkatun ohjeen 5. kohta eli https://github.com/sstephenson/ruby-build#readme) ohjeen "Installing as an rbenv plugin" mukaan

Voit myös haluessasi suorittaa rbenvin, ruby 2.3.0 ja railsin asennuksen copy-pasteamalla allaolevan koodin terminaaliin:

git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"' >> ~/.bash_profile
echo 'export PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc
git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
rbenv install 2.3.0
rbenv global 2.3.0
 
echo 'gem: --no-ri --no-rdoc' >> ~/.gemrc
gem install rdoc
gem install bundler
gem install rake 
rbenv rehash
gem install rails
rbenv rehash

rbenv OSXlle

Rbenvin asennus onnistuu helpoiten homebrew:in avulla. Ohjeet homebrewin asennukseen löydät osoitteesta http://brew.sh/

Homebrewin asennuksen jälkeen

brew update
brew install rbenv
brew install ruby-build

Lisää myös rivit

export PATH="$HOME/.rbenv/bin:$PATH"  
eval "$(rbenv init -)"

.bashrc tiedostoon kotihakemistoosi. Voit mahdollisesti joutua luomaan sen. .-alkuiset tiedostot eivät oletuksena näy Finderissä. Sama ohje löytyy rbenvin asennusohjeesta: https://github.com/sstephenson/rbenv#homebrew-on-mac-os-x

Huomautus edelliseen: Jos et tiedä tarkalleen mitä .bashrc tekee tai mitä sen pitäisi tehdä ks: http://superuser.com/questions/244964/mac-os-x-bashrc-not-working . Katso erityisesti toinen ja kolmas postaus. Eli jos seuraavassa kohdassa valitset (vain) terminaalin uudelleenkäynnistyksen, niin asennus etenee suunnitellusti jos huolehdit että kotihakemistossa on tiedosto .bash_profile, joka sisältää ainakin yllä mainitut rivit export... ja eva... . Mutta jos valitsetkin seuraavassa kohdassa terminaalin uudelleenkäynnistyksen sijaan komennon source .bashrc, niin kotihakemistossasi tuleekin olla tiedosto .bashrc aiemmin mainittuine riveineen. Suositeltavaa on kuitenkin laittaa kotihakemistoon tiedosto .bash_profile jne. ja käynnistää terminaali uudestaan, koska tällöin mm. rails:in komennot toimivat jatkossa mukisematta ja asiat menevät niin kuin ohjeissa.

Käynnistä tässä vaiheessa terminaali uudelleen tai aja source .bashrc

Rubyn ja Railsin asennus

Tämän jälkeen asennetaan ja määrittellään käytettävä Ruby:n versio komennoilla

rbenv install 2.2.0
rbenv global 2.2.0

Komento asentaa Rubyn version 2.2.0, joka on Ruby uusin versio. Voit tarkistaa asennettavissa olevat versiot komennolla rbenv install --list

Varmista että komennon which ruby tulos on suunilleen seuraava:

/Users/kayttajatunnus/.rbenv/shims/ruby

Asennetaan sitten Rails antamalla komentoriviltä seuraavat komennot (vastaa mahdollisiin Overwrite the executable? -kyselyihin Y):

echo 'gem: --no-ri --no-rdoc' >> ~/.gemrc
gem install rdoc
gem install bundler
gem install rake 
rbenv rehash
gem install rails
rbenv rehash

HUOM: Jos saat seuraavan virheen käynnistäessäsi palvelinta: bin/rails:6: warning: already initialized constant APP_PATH /home/user/myProject/bin/rails:6: warning: previous definition of APP_PATH was here

Tulee sinun lisätä projektin Gemfileen seuraava rivi: gem 'rb-readline'

ja ajaa:

bundle install

VirtualBox

Virtual Box https://www.virtualbox.org/ on mm. Windowsilla toimiva ilmainen virtualisointiympäristö, joka mahdollistaa esim. Linuxin suorittamisen Windows-koneen sovelluksena.

Täältä löydät VirtualBox-imagen, jonne on asennettu valmiiksi Ubuntu Linux, Rails-kehitysympäristö sekä RubyMine. Virtuaalikoneella on admin-oikeudet omaava käyttäjätunnus wadror salasana wadror.

Jos haluat virtuaalikoneen käyttöösi, asenna ensin VirtualBox, lataa virtuaalikoneimagen sisältävä zip-paketti ja pura se.

Huomaa, että pystyt kirjautumaan virtuaalikoneeseen esim. puttyllä tai Remote Desktopilla Windows-koneeltasi. Muuta virtuaalikoneensi asetuksista verkon tyypiksi bridged. Linux-virtuaalikoneen ip-osoite selviää kun kirjoitat terminaalissa komennon ifconfig. Voit myös avata virtuaalikoneella pyörivän Rails-sovelluksen Windows-koneesta käsin kirjoittamalla selaimeen osoitteeksi koneenIPosoite:3000/breweries