Jruby On Rails 的安装及部署实践

Jruby On Rails 的安装及部署实践

Rails jruby ActiveRecord JDBC Tomcat
    最近安装了Jruby On Rails,发现网上虽然有很多资料可以参考,但是由于各种组件的不断更新,很多资料已经过时,容易产生误导,在这里介绍一下我个人的安装经过,供大家参考.

    首先是安装环境,不同的软件版本可能导致不同的安装结果.我使用的环境是:

JDK------------------1.6.0_06

TOMCAT--------------6.0.16

MYSQL---------------5.0.22

JRUBY---------------1,1

RAILS----------------2.0.2

WARBLER------------0.9.5

    接下来开始安装,JDK,TOMCAT,MYSQL的安装就不说了,别忘了配置JAVA_HOME环境变量.

接下来解压JRUBY,将JRUBY_HOME指向解压后的文件路径,CLASSPATH指向该路径的LIB.接下来转到JRUBY的BIN路径下,开始以下的安装;

1,安装RAILS,运行:

jruby gem install rails -r -y --no-ri --no-rdoc

目前的版本是2.0.2.

2,安装Rails框架的数据库接口和MYSQL适配器,运行:

jruby gem install activerecord-jdbc-adapter -r -y --no-ri --no-rdoc

jruby gem install activerecord-jdbcmysql-adapter -r -y --no-ri --no-rdoc

这里要说明一下,有些资料说要安装ActiveRecord-JDBC,其实ActiveRecord-JDBC和activerecord-jdbc-adapter是同一种东西,只是名字换了,版本不同,ActiveRecord-JDBC的版本是0.5,activerecord-jdbc-adapter现在是0.8.另外因为安装了activerecord-jdbcmysql-adapter,所以java语言MySQL数据库接口软件包就不用下载安装了.

以上的模块安装完毕就可以创建一个RAILS工程了,例如:jruby -S rails demo

随后修改config/database.yml，像是这样：

adapter: jdbcmysql

hostname: localhost

database: test

username: root

password:

这里再补充一点,有的资料说要修改config/environment.rb,要添加

if RUBY_PLATFORM =~ /java/

    require 'rubygems'

    RAILS_CONNECTION_ADAPTERS = %w(jdbc)

end

其实这项修改是针对RAILS2.0以前的版本的,现在的2.0.2已经不用改了.这一点在activerecord-jdbc-adapter的文档有说明.

    以上设置完毕就可以启动WEBrick运行RAILS程序了.下面再说说RAILS程序如何部署到TOMCAT中.Goldspike已经稍显陈旧了,现在我们可以使用更好的warbler.在JRUBY的BIN路径下运行:

jruby gem install warbler -r -y --no-ri --no-rdoc

这样warbler就安装好了,接下来如果在RAILS工程下打包,是可以生成.war文件的,但是放在TOMCAT下跑会有问题,原因是因为warbler没有把数据库连接的内容打到包里去.其实这也不是warbler的BUG,warbler无法知道用户连接何种数据库以及用什么方式连接,所以你需要自己配一下,修改jruby-1.1\lib\ruby\gems\1.8\gems\warbler-0.9.5\generators\warble\templates\warble.rb文件,在以下的位置:

# config.gems = ["activerecord-jdbc-adapter", "jruby-openssl"]

# config.gems << "tzinfo"

# config.gems["rails"] = "1.2.3"

添加:

%w{jdbc-mysql activerecord-jdbcmysql-adapter activerecord-jdbc-adapter}.each{|g| config.gems << g}

注意,上面的warble.rb其实并不是warbler打包的配置文件,它是一个生成配置文件的模板文件,要生成配置文件须要到RAILS工程路径下运行:

jruby -S warble config

这时你在工程路径下config文件夹会找到一个warble.rb,这才是warbler打包的配置文件.上面的添加内容你也可以不在模板文件中添加,而是直接在这里添加.这一步完成后就可以打包了,运行:

jruby -S warble war

把.war文件拷贝到TOMCAT的webapps下就可以运行了,但是会看到以下错误:

Rails Error: No :secret given to the #protect_from_forgery call. Set that or use a session store capable of generating its own keys (Cookie Session Store)

解决的对策是编辑该工程的web.xml文件,添加以下内容

<context-param>

    <param-name>jruby.session_store</param-name>

    <param-value>db</param-value>

</context-param>

以上的修改也可以在模板文件jruby-1.1\lib\ruby\gems\1.8\gems\warbler-0.9.5\web.xml.erb中进行,这样就不用每次都要修改工程的web.xml文件了.现在一切正常了.