Установка Ruby

2007-01-06 0 ∞

Установка Ruby
Установка Rails (ручная)
Создание Rails приложения
Генерация приложения
Запуск приложения (веб-сервер)

Установка Ruby

Идем сюда (One-Click Installer — Windows) и скачиваем ruby184-20.exe (27.28 MB).

Запускаем ruby184-20.exe — ruby установился (в папку c:/ruby по умолчанию).

Проверяем в командной строке:

C:>ruby -v
 ruby 1.8.4 (2006-07-24) [i386-mswin32]

Если интерпретатор ruby не был найден, возможно, надо закрыть текущую сессию FAR и открыть заново (чтобы "сработали" переменные окружения).

После установки интерпретатора ruby необходимо установить пакет Rails, который собственно и является основой Ruby on Rails.

Для установки Ruby компонентов используется утилита gem. Тут можно воспользоваться двумя способами - автоматическим и ручным. В автоматическом режиме необходимо просто выполнить команду

gem install rails --include-dependencies

Менеджер пакетов gem автоматически скачает все необходимые компоненты, и установит их. Однако это не всегда удобно, и невозможно при наличии прокси сервера.

В этом случае удобнее воспользоваться ручным сособом.

Установка Rails (ручная)

Ручная, т.е. никаких фоновых подключений к серверу, все устанавливается с локально скаченных файлов.

Для установки Ruby компонентов используется утилита gem. И соответственно для этой утилиты нужны файлы с расширением .gem.

Когда файл some_file0.0.0.gem какого-либо модуля скачан, то, чтобы его установить, надо запустить gem:

gem install some_file0.0.0.gem

Rails — это фреймворк, который объединяет несколько компонентов, поэтому каждый из них надо отдельно скачать и установить (при ручной установке, при автоматической они все скачиваются/устанавливаются автоматически).

Согласно этой странице (раздел Manual installation), получаются следующие шаги (порядок важен!), стрелкой указан файл который скачивается, ниже — строка для установки (версии указаны для Rails 1.0):

* Activesupport -> activesupport-1.3.1.gem 

 gem install activesupport-1.3.1.gem

 * Actionpack-> actionpack-1.12.5.gem 

 gem install actionpack-1.12.5.gem

 * Actionmailer -> actionmailer-1.2.5.gem 

 gem install actionmailer-1.2.5.gem

 * Activerecord -> activerecord-1.14.4.gem 

 gem install activerecord-1.14.4.gem

 * Actionwebservice -> actionwebservice-1.1.6.gem 

 gem install actionwebservice-1.1.6.gem

 * Rake -> rake-0.7.1.gem 

 gem install rake-0.7.1.gem

 * Rails-> rails-1.1.6.gem 

 gem install rails-1.1.6.gem

Суммарный объем всех gem'ов — 1 269Kb

Замечание: версии, конечно, могут измениться в будущем.

Проверяем, что Rails установлен, в командной строке:

C:>rails
 Usage: c:/ruby/bin/rails /path/to/your/app [options]
 Options:
 --ruby [c:/ruby/bin/ruby] Path to the Ruby binary of your choice.
 --without-gems Don't use the Rails gems for your app.
 WARNING: see note below.
 ...

установился.

Создание Rails приложения

Rails приложение - это веб приложение, которое решает какую-либо задачу. Каждое приложение распологается в своей папке (с определенной структурой), также каждому приложению соответсвует база данных в MySQL (точнее, 3 бызы, каждая соответсвует режиму работы приложения — development, test, production).

Генерация приложения

Создаем Rails приложение, для этого надо запустить rails, указав папку (имя приложения), например:

rails ToDo

создаст папку ToDo, в которой будет размещено Rails приложение "ToDo".

Вот как это выглядит:

C:rails>rails ToDo
 create 
 create app/apis
 create app/controllers
 create app/helpers
 create app/models
 create app/views/layouts
 create config/environments
 create components
 create db
 create doc
 create lib
 create lib/tasks
 create log
 create public/images
 create public/javascripts
 create public/stylesheets
 create script/performance
 create script/process
 create test/fixtures
 create test/functional
 create test/mocks/development
 create test/mocks/test
 create test/unit
 create vendor
 create vendor/plugins
 create Rakefile
 create README
 create CHANGELOG
 create app/controllers/application.rb
 create app/helpers/application_helper.rb
 create test/test_helper.rb
 create config/database.yml
 create config/routes.rb
 create public/.htaccess
 create config/boot.rb
 create config/environment.rb
 create config/environments/production.rb
 create config/environments/development.rb
 create config/environments/test.rb
 create script/breakpointer
 create script/console
 create script/destroy
 create script/generate
 create script/performance/benchmarker
 create script/performance/profiler
 create script/process/reaper
 create script/process/spawner
 create script/process/spinner
 create script/runner
 create script/server
 create public/dispatch.rb
 create public/dispatch.cgi
 create public/dispatch.fcgi
 create public/404.html
 create public/500.html
 create public/index.html
 create public/favicon.ico
 create public/robots.txt
 create public/javascripts/prototype.js
 create public/javascripts/scriptaculous.js
 create public/javascripts/effects.js
 create public/javascripts/dragdrop.js
 create public/javascripts/controls.js
 create public/javascripts/slider.js
 create doc/README_FOR_APP
 create log/server.log
 create log/production.log
 create log/development.log
 create log/test.log

Т.е. была создана папка ToDo и относительно нее файловая структура:

ToDo/
 app/
 components/
 config/
 db/
 doc/
 lib/
 log/
 public/
 script/
 test/
 vendor/
 CHANGELOG
 Rakefile
 README

данная структура идентична для всех Rails приложений.

Само приложение размещается в папке app, далее:

components
-
config
-
db
структура БД для приложения
doc
-
lib
-
log
-
public
доступные для веб клиента файлы (images, javascripts, stylesheets)
script
размещаются скрипты для генерации классов модели/контроллеры, скрипт веб-сервера (удобно для режима разработки)
test
-
vendor
-

Запуск приложения (веб-сервер)

Уже можно запустить это приложение, для этого, находясь в ToDo папке, набираем:

ruby script/server

запускается WEBrick веб-сервер на порту 3000 (по умолчаню):

C:railsToDo>ruby script/server
 => Rails application started on http://0.0.0.0:3000
 => Ctrl-C to shutdown server; call with --help for options
 [2005-10-24 18:49:49] INFO WEBrick 1.3.1
 [2005-10-24 18:49:49] INFO ruby 1.8.2 (2004-12-25) [i386-mswin32]
 [2005-10-24 18:49:49] INFO WEBrick::HTTPServer#start: pid=4004 port=3000

Теперь запускаем Firefox, и указываем в качестве url: http://localhost:3000/, и мы увидим начальную страницу.

Теперь уже можно приступать к разработке Rails приложения (настройку Apache/FCGI оставим на потом).

Также для настройки порта можно использовать ключик -p порт при запуске:

ruby script/server -p 3001

приложение будет запущено на 3001 порту. Можно сделать наблюдение: на машине может быть запущено несколько Rails приложений: каждое на своем порту.

Также сервер запускается с utf8 кодировкой по умолчанию, если требуется другая, используем ключик -c кодировка:

ruby script/server -c windows-1251

какие есть еще "ключики" для веб-сервера, можно увидеть, запустив следующую команду:

ruby script/server --help