Passenger

Passenger is essentially ‘mod_ruby’ for both Nginx and Apache. You may select *exactly one* Ruby to run all of your Passenger Ruby applications with. If you need to run more than one Ruby interpreter then you should choose the most common one as Passenger Ruby. You then use proxy pass to external application servers such as Passenger Standalone, Unicorn, Thin, Mongrel, Mongrel2, etc… in order to accomplish running different applications under different rubies. For a full explanation of this (with pretty pictures!) see the post on Phusion’s Blog

Passenger *3*

Installing Nginx/Apache with Passenger

First of all there’s passenger-install-apache2-module and passenger-install-nginx-module. At the end of the installation it outputs a PassengerRuby configuration snippet for the web server. Its value is set to the RVM Ruby wrapper script that corresponds with the RVM Ruby and RVM gemset that was used to run the installer. This should be all you need for configuration of Passenger 3!

If it’s not, here’s what you might have to do, almost all of this stolen from Darcy’s Blog Post

In your .rvmrc do:

if [[ -s "/Users/sutto/.rvm/environments/ree-1.8.7-2010.02@my-app-name" ]] ; then
  . "/Users/sutto/.rvm/environments/ree-1.8.7-2010.02@my-app-name"
else
  rvm --create use  "ree-1.8.7-2010.02@my-app-name"
fi

Then in the rails project, add a new file config/setup_load_paths.rb and add

if ENV['MY_RUBY_HOME'] && ENV['MY_RUBY_HOME'].include?('rvm')
  begin
    rvm_path     = File.dirname(File.dirname(ENV['MY_RUBY_HOME']))
    rvm_lib_path = File.join(rvm_path, 'lib')
    $LOAD_PATH.unshift rvm_lib_path
    require 'rvm'
    RVM.use_from_path! File.dirname(File.dirname(__FILE__))
  rescue LoadError
    # RVM is unavailable at this point.
    raise "RVM ruby lib is currently unavailable."
  end
end

# Select the correct item for which you use below.
# If you're not using bundler, remove it completely.
#
# # If we're using a Bundler 1.0 beta
# ENV['BUNDLE_GEMFILE'] = File.expand_path('../Gemfile', File.dirname(__FILE__))
# require 'bundler/setup'
#
# # Or Bundler 0.9...
# if File.exist?(".bundle/environment.rb")
#   require '.bundle/environment'
# else
#   require 'rubygems'
#   require 'bundler'
#   Bundler.setup
# end

Please note that for Passenger 3 you now use the ruby wrapper script directly with no need to use the passenger_ruby wrapper.

Starting Passenger Standalone

Then there’s Passenger Standalone, i.e. ‘passenger start’. Passenger Standalone uses Nginx internally, and it writes a passenger_ruby directive to the Nginx configuration file. This directive points to the RVM Ruby wrapper script that corresponds with the RVM Ruby and RVM gemset that was used to run the ‘passenger start’ command.

Bundler Gotcha

When using Bundler in your project, Passenger will try to be smart and only add to your $LOAD_PATH the gems listed in your Gemfile. This can lead to “unable to load” errors for your unlisted gems (this should only happen during development). You can check your run-time load path by adding

f = File.open('/tmp/load_path', 'w')
f.write($:)
f.close

to your app’s main file (before the “require” calls). You won’t be able to load any gems that are not in that load path.

Passenger *2* with RVM

Select a Passenger Ruby and Generate Wrapper Scripts

Run RVM using your desired Ruby interpreter, and pass the ‘–passenger’ option. This will generate wrapper scripts in RVM’s bin directory (see Notes below). These wrapper scripts ensure environment variables such as GEM_HOME and GEM_PATH are set correctly for applications run by passenger. E.g:

rvm ree --passenger

Alternatively, you can use the rvm wrapper command directly:

rvm wrapper ree@ninjas passenger

Install Passenger

rvm ree
gem install passenger
rvmsudo passenger-install-nginx-module

Or if you are forced to use the tomahawk,

rvmsudo passenger-install-apache2-module

Configure the Web Server

For Nginx users, replace the passenger_ruby line with:

passenger_ruby /home/wayne/.rvm/bin/passenger_ruby;

For apache users, use:

PassengerRuby /home/wayne/.rvm/bin/passenger_ruby

Please note that if you installed rvm as root / are using a system wide ruby, instead of using /home/wayne/.rvm/bin/passenger_ruby as in the above examples, you’ll instead need to use /usr/local/rvm/bin/passenger_ruby.

Notes

• Add the passenger default user (PassengerDefaultUser/passenger_default_user) to the rvm group. On some systems this is ‘www-data’ and on others it might be ‘http’ or ‘www’. One telling sign that you forgot to do this would be spending the better part of a day trying to figure out bizarre fork-bomb-like symptoms on passenger spawn (::grin::).
• Do no not forget to configure the production environment and/or to set the rails_env/RailsEnv variable to development into nginx.conf/httpd.conf for the virtual server config block. The RAILS_ENV defaults to ‘production’.
• Be sure to change ‘/home/wayne’ in the above examples to your own $HOME directory,
• The ‘.rvm/bin/passenger_ruby’ is actually what is known as a ‘wrapper script’ which sets up the environment for the passenger so that it can find it’s gems, etc… and then exec’s the actual ruby binary.”
• passenger_root/PassengerRoot Should be something similar to the following, which is for Passenger 2.2.11 installed under ree-1.8.7-2010.01.

   passenger_root /home/millisami/.rvm/gems/ree-1.8.7-2010.01/gems/passenger-2.2.11

Troubleshooting

• The most common issue is forgetting the /bin/ part of the path to get the proper wrapper script:
• The next most common issue is listening to the output of the passenger installation script with respect to where passenger_ruby/PassengerRuby are located. Be sure to use the wrapper script location as specified above. To be more clear, see the example below for Nginx config:

  passenger_ruby /home/wayne/.rvm/bin/passenger_ruby;
  * NOTICE THE '.rvm/bin' DIR  ^ ^ ^
  * do NOT use the actual ruby binary in .rvm/rubies/{passenger_ruby}/bin/ruby
  * do not listen to passenger's output for passenger_ruby as passenger is not aware of rvm.

  For system wide (root) installs the bin directory is /usr/local/rvm/bin instead:

  passenger_ruby /usr/local/rvm/bin/passenger_ruby;

FAQ

• Q: Can I run multiple projects under passenger with each project on a different ruby version?A: Not at this time. Passenger currently only supports running it’s projects under *one* ruby. You can get this behavior using a proxy pass.
• Q: How do I use custom gemsets under passenger?A: Without bundler you can either set environment variables yourself in your config.ru like:

  ENV["GEM_HOME"]=%x{"source ~/.bash_profile ; rvm ree@pancake ; rvm gemdir"}.strip

  Or, if you are already using rvmrc’s, you can use the rvm ruby api and config/setup_load_paths.rb in recent passenger versions by following the guide located here.

  A: With bundler: Install bundler outside any gemset, switch back to the gemset you wish to use and run bundle install and restart the application (by touching tmp/restart.txt). This works becase bundler stores absolute paths inside .bundle/environment.rb which will be loaded by bundler directly. If this doesn’t work as expected, try running bundle install like so:

  bundle install $BUNDLE_PATH

  How can I use commands like passenger-status in conjunction with a user install but run them as root? Mainly the key to this is to use wildcards in the sudoers file as the following examples show.

  /usr/bin/env GEM_PATH=* GEM_HOME=* PATH=* passenger-status

$ rails g model post title:string body:text

와 같이 명령을 수행할 때 만들어지는 마이그레이션 루비 파일의 내용을 보면 이전 up/down 메소드 대신 change 메소드 하나만 보이게 됩니다. 개발자로 하여금 코딩 시간을 줄일 수 있고 좀 더 지능적인 프레임워크로 진화하고 있는 느낌이 듭니다.

# in Rails 2.x
class CreatePosts < ActiveRecord::Migration
   def self.up
      create_table :posts do |t|
         t.string :title
         t.text :body
         t.timestamps

      end
   end

   def self.down
      drop_table :posts
   end

end

# in Rails 3.1
class CreatePosts < ActiveRecord::Migration

   def change
      create_table :posts do |t|
         t.string :title
         t.text :body
         t.timestamps
      end
   end

end

마이그레이션을 위해 실질적인 테이블을 물리적으로 만들기 위해서는 다음의 명령이 실행되어야 합니다

$ rake db:migration

와 같이 실행하면 아직 마이크레이션 되지 않은 마이그레이션 루비 파일들을 불러들여 실행하게 됩니다. 이러한 마이그레이션 루비파일들은 파일명 앞에 타임스탬프가 찍혀 있는데, 이렇게 마이그레이션 파일이 rake되면 해당 파일의 파일명 앞에 있는 타임스탬프가 schema_migrations 라는 테이블에 추가됩니다. 그래서 마이그레이션 rake 명령이 실행될 때 이 테이블을 검색해서 테이블에 파일의 타임스탬프가 있으면 수행을 하지 않게 됩니다.

$ rake db:migration:status

위의 명령을 수행하면 지금까지 수행되었던 마이그레이션 이력을 일견에 볼 수 있어 어디까지 마이그레이션 작업이 수행되었는지도 쉽게 알 수 있습니다.

자, 이렇게 마이그레이션을 위한 rake 작업을 한 후에 테이블을 수정할 상황이 발생할 경우, rake 작업을 취소하고 데이터베이스내 태이블을 롤백해야 하는데, 이 과정은 다음과 같습니다.

$ rake db:rollback

마이그레이션 작업이 취소되고 테이블이 롤백됩니다.

이후에 마이그레이션을 위한 루비 파일을 수정하고 다시 위에서 언급한 바와 같이 마이그레이션 rake 작업을 수행하면 됩니다.

때로는 특정 마이그레이션 파일을 롤백하고 싶은 경우가 있는데, 다음과 같이 VERSION= 다음에 해당 파일명 앞의 타임스탬프 숫자만을 추가해 주면 됩니다.

$ rake db:migrate:down VERSION=20080906120000

Rails 3.1의 change 메소드는 이러한 롤백과정에서 자동으로 반대기능을 하는 메소드를 추정해서 실행하게 됩니다.

$ rake db:migrate (in /home/rohit/code/migrahedron)

== CreatePosts: migrating ===========================
-- create_table(:posts)
-> 0.0012s

== CreatePosts: migrated (0.0013s) =====================

$ rake db:rollback (in /home/rohit/code/migrahedron)

== CreatePosts: reverting("posts")
-> 0.0007s

== CreatePosts: reverted (0.0008s)======================

그러나 자동으로 역방향 메소드를 실행하지 못하고 에러가 발생하는 경우가 있습니다.

class RemoveTitleFromPost < ActiveRecord::Migration
   def change
      remove_column :posts, :title
   end
end

$ rake db:rollback이런 경우에는 역방향 메소드 add_column이 호출될 때 정보가 부족하여, 즉, 데이터형에 대한 정보가 없기 때문에 에러가 발행하게 되는 것입니다.

== RemoveTitleFromPost: reverting =========================
rake aborted!

An error has occurred, this and all later migrations canceled:
ActiveRecord::IrreversibleMigration
(See full trace by running task with --trace)

이럴 경우에는 이전 버젼에서와 같이 up 또는 down 인스턴스 메소드를 구현해서 마이그레이션 루비 스크립트를 작성해 주어야 합니다.

class RemoveTitleFromPost < ActiveRecord::Migration
   def up
      remove_column :posts, :title
   end
   def down
      add_column :posts,:title,:string
   end
end

주의: self.up / self.down 클래스 메소드가 아니고 up / down 인스턴스 메소드로 작성해 주어야 합니다.

IBM DeveloperWorks에 있는 자료의 링크입니다.

Part 1.  Ajax 소개

Part 2.  Javascript와 Ajax를 이용한 비동기식 요청

Part 3.  Ajax의 고급요청 및 응답

Part 4.  웹 응답에 DOM 활용하기

Part 5.  DOM 다루기

Part 6.  DOM 기반 웹어플리케이션 구현하기기

Part 7.  요청과 응답에 XML 사용하기 (1)

Part 8.  요청과 응답에 XML 사용하기 (2)

Part 9.  Google Ajax Search API 사용하기

Part 10.  데이터 전송에 JSON 사용하기

Part 11.  서버측의 JSON

Started GET “/assets/application.js” for 127.0.0.1 at 2011-05-25 16:44:30 +0900
Compiled ~/Projects/wordstory/app/assets/javascripts/application.js  (5ms)  (pid 1152)
Compiled ~/.rvm/gems/ruby-1.9.2-p180@HEAD_GEMSET/gems/jquery-rails-1.0.7/vendor/assets/javascripts/jquery.js  (4ms)  (pid 1152)
Compiled ~/.rvm/gems/ruby-1.9.2-p180@HEAD_GEMSET/gems/jquery-rails-1.0.7/vendor/assets/javascripts/jquery_ujs.js  (1ms)  (pid 1152)
Compiled ~/Projects/wordstory/app/assets/javascripts/welcome.js.coffee  (194ms)  (pid 1152)

Served asset /application.js – 304 Not Modified  (0.214s)  (pid 1152)

WARN: tilt autoloading ‘sass’ in a non thread-safe way; explicit require ‘sass’ suggested.
WARN: tilt autoloading ‘sass/plugin’ in a non thread-safe way; explicit require ‘sass/plugin’ suggested.

Started GET “/assets/application.css” for 127.0.0.1 at 2011-05-25 16:44:31 +0900
Compiled ~/Projects/wordstory/app/assets/stylesheets/application.css  (1ms)  (pid 1152)
Compiled ~/Projects/wordstory/app/assets/stylesheets/welcome.css.scss  (132ms)  (pid 1152)

Served asset /application.css – 304 Not Modified  (0.139s)  (pid 1152)

컨셉을 잘 설명해 놓은 블로그가 있군요.

http://piotrsarnacki.com/2010/09/14/mountable-engines/

진정한 개발자들의 편의를 제공하기 시작한 것이다.

이전 버젼까지는 자바라이브러리 Prototype이 기본 내장되었지만, 3.1버젼부터는 jQuery가 기본내장되어 오히려 Prototype 을 설치하려면 -j prototype 이라는 옵션을 이용하여 웹어플리케이션을 생성해야 할 판이 되었다.

눈에 띄는 변화 중에 하나는 웹어플리케이션 디렉토리 구조에 약간의 변화가 생겼다. public/ 디렉토리에 있는 images/, javascripts/, stylesheets/  세개의 디렉토리가 app/assests/ 디렉토리로 이사를 갔다는 것이다. 결국 assests 디렉토리에 있는 이미지, 자바스크립트, 스타일시트까지도 공개하기 않게 된다는 것이다. 공개되는 것은 Spirochets 라이브러리를 이용하여 다수의 자바스크립트와 css 파일들을 각각 application .js와 application.css 로 합쳐서 클라이언트 브라우져로 보내지게 되는 것이다. 이때 jQuery도 application.js파일로 합쳐져서 보내지게 된다.

지금까지 루비, 특히 레일즈에서 사용되는 심볼을 어렴풋하게나마 이해하고 있었는데, 위의 링크의 내용을 읽어 보고 루비의 심볼에 대한 확실한 개념을 알게 되었다.

1. 심볼은 integer나 string으로 변환될 수 있다. 그러나 심볼이란 string으로 대신해서 사용할 수 있는 상수(constant)와 같은 것이지만 같은 String을 반복해서 사용할 때처럼 메모리를 소모하지 않아 메모리 절약에 도움이 될 수 있다. 동일한 심볼을 수천번 반복에서 코딩에 사용해도 심볼값은 하나의 주소값만을 가진다.

2. 심볼은 런타임때 값을 변경할 수 없다.(immutable)

3. 심볼은 .to_i 나 .to_s 메소드를 이용해서 의미없는 공유의 정수값이나 심볼이름과 같은 문자열을 간접적으로 얻을 수 있지만, 심볼 자체로는 String객체의 그 많은 메소드들을 사용할 수 없다. 왜냐하면 심볼은 Symbol 객체이기 때문이다.

아래는 위 링크의 마지막에 있는 요약을 복사해 놓은 것이다.

• A Ruby symbol looks like a colon followed by characters. (:mysymbol)
• A Ruby symbol is a thing that has both a number (integer) and a string.
• The value of a Ruby symbol’s string part is the name of the symbol, minus the leading colon.
• A Ruby symbol cannot be changed at runtime.
• Neither its string representation nor its integer representation can be changed at runtime.
• Ruby symbols are useful in preventing modification.
• Like most other things in Ruby, a symbol is an object.
• When designing a program, you can usually use a string instead of a symbol.
• Except when you must guarantee that the string isn’t modified.
• Symbol objects do not have the rich set of instance methods that String objects do.
• After the first usage of :mysymbol all further useages of :mysymbol take no further memory — they’re all the same object.
• Ruby symbols save memory over large numbers of identical literal strings.
• Ruby symbols enhance runtime speed to at least some degree.