web/README.rdoc
author Marcel Hlopko <marcel.hlopko@gmail.com>
Fri, 28 Feb 2014 13:22:13 +0100
changeset 197 3ebfe9f36c3f
parent 33 9abd986fa635
child 293 4bc85b25b6c2
permissions -rw-r--r--
improved README.rdoc
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
     1
== README
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
     2
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     3
# Getting Started
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     4
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     5
## Installing Ruby
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
     6
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     7
Usually ruby installed with operating system is quite old (and slow), so we
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     8
will install newer version. The process is not trivial so we will use
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
     9
existing tools - ruby-install (will checkout and compile ruby for us) and
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    10
chruby (will allow us to switch between different versions of ruby).
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    11
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    12
  wget -O ruby-install-0.4.0.tar.gz https://github.com/postmodern/ruby-install/archive/v0.4.0.tar.gz
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    13
  tar -xzvf ruby-install-0.4.0.tar.gz
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    14
  cd ruby-install-0.4.0/
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    15
  sudo make install
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    16
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    17
  wget -O chruby-0.3.8.tar.gz https://github.com/postmodern/chruby/archive/v0.3.8.tar.gz
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    18
  tar -xzvf chruby-0.3.8.tar.gz
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    19
  cd chruby-0.3.8/
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    20
  sudo make install
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    21
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    22
  echo "source /usr/local/share/chruby/chruby.sh" >> ~/.bashrc
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    23
  echo "source /usr/local/share/chruby/auto.sh" >> ~/.bashrc
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    24
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    25
  ruby-install ruby 2.1.1
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    26
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    27
## Installing Rails (and other gems)
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    28
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    29
Go to the root of calipel rails app (on my machine: /home/m/Projects/other/jv-calipel/web) and execute
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    30
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    31
  gem install bundler
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    32
  bundle install
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    33
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    34
## Preparing Databases
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    35
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    36
In the web app root execute
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    37
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    38
  rake db:create:all
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    39
  rake db:migrate
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    40
  RAILS_ENV=test rake db:migrate
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    41
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    42
## Starting Local Rails Server
33
9abd986fa635 init rails project
Marcel Hlopko <marcel.hlopko@gmail.com>
parents:
diff changeset
    43
197
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    44
In the web app root execute
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    45
3ebfe9f36c3f improved README.rdoc
Marcel Hlopko <marcel.hlopko@gmail.com>
parents: 33
diff changeset
    46
  rails server