如何部署 Ruby 应用

Flynn 支持多种 Ruby 解释器来实现对 Ruby，Rack，Rails 等类型应用的支持，如：MRI， JRuby，Rubinius。

Flynn 使用 Heroku Ruby 构建包来实现 Ruby 应用的检测，编译和发布。

应用检测

Flynn 通过检测根目录下的Gemfile文件来确定这是 Ruby 应用。通过 Bundler(一个 Ruby 的软件包管理工具)来检测，下载，安装应用所依赖的软件包。

软件依赖

Gems

Gemfile文件的主要用途是用来管理软件包的依赖关系。下面是Gemfile文件的一个示例，其中部署的 Ruby 应用依赖 rack：

  1. source "https://rubygems.org"
  3. gem "rack"

在应用中附上上述 Gemfile后，应该运行bundle install来安装所需的软件包，这样会保存所有软件包内容和版本的快照到本地的Gemfile.lock文件。

在 Flynn 中部署 Ruby 应用时，必须通过 Gemfile.lock文件来确定哪些依赖的软件包需要安装。如果没有这个文件，部署将会失败。

关于Gemfile文件格式的详细信息，请参见：Gemfile 页面。

具体环境

可能有些 gems 只会在本地开发的时候用到，当部署到生产系统里时不需要。 这可以在Flynn 调用 bundle install时，使用—withoutdevelopment：test参数，这样在部署时就会跳过Gemfile里的development和test组的内容。

例如，你可能在本地开发时用到debugger和rspc，但在真正部署时很少需要，你可以将其放到上述组中：

  1. group :development do
  2.   gem "debugger"
  3. end
  5. group :test do
  6.   gem "rspec"
  7. end

针对上面的配置，下面是 Flynn 将会运行的完整命令：

  1. bundle install \
  2.   --without development:test \
  3.   --path vendor/bundle \
  4.   --binstubs vendor/bundle/bin \
  5.   -j4 \
  6.   --deployment \
  7.   --no-clean

关于bundle install的详细信息，请参见 bundle 安装页。

Ruby 解释器

如果应用需要特定的 Ruby 解释器，可以在Gemfile里指定。

使用 MRI v2.1.2：

  1. ruby "2.1.2"

使用 JRuby 1.7.16 ，带 Ruby 2.0 支持：

  1. ruby "2.0.0", engine: "jruby", engine_version: "1.7.16"

使用 Rubinius 2.2.10，带 Ruby 2.1 支持：

  1. ruby "2.1.0", engine: "rbx", engine_version: "2.2.10"

原生扩展库

应用构建及运行时所在的容器包含了一些预安装的本地库，可用于编译 Ruby 应用的原生扩展，例如：

应用类型

在应用根目录下的 Procfile 里声明应用的类型，格式：TYPE:COMMAND。如果没有Procfile，Flynn 会指定一个默认的应用类型(参见下文开发框架检测获取更多信息)。

下面是一些常见的应用类型：

web

web类型的应用会包含 HTTP 路由和通信的端口设置，通常会启动一个 HTTP 服务器，常见的配置：

Thin

  1. web: bundle exec thin start -p $PORT -e $RACK_ENV

Unicorn

  1. web: bundle exec -p $PORT -c config/unicorn.rb

Puma

  1. web: bundle exec puma -C config/puma.rb

注意：如果使用 Puma，确认在config/puma.rb里配置了ENV[PORT]端口变量。

worker

worker类型的应用通常是在后台运行的进程，用来处理队列任务，例如： Resque

  1.  worker: QUEUE=* bundle exec rake resque:work

Sidekiq

  1.  worker: bundle exec sidekiq

Delayed::Job

  1.  worker: bundle exec delayed_job start

clock

clock类型的应用，通常用来按特定的周期执行定时（cron-like）任务。

Clockwork软件包提供了一个好用的 DSL ，可以按如下声明其应用类型：

  1. clock: bundle exec clockwork lib/clock.rb

其中lib/clock.rb里包含 Clockwork 声明。

本地测试

如果想在本地测试应用的类型，需要安装Foreman，同时在根目录下的.env文件里设置必要的环境变量（例如：PORT=5000），启动 Foreman：

  1. $ foreman start
  2. 14:25:33 web.1    | started with pid 42868
  3. 14:25:33 worker.1 | started with pid 42869
  4. 14:25:33 clock.1  | started with pid 42870
  5. 14:25:34 web.1    | == Sinatra/1.4.5 has taken the stage on 5000 for development with backup from Thin
  6. 14:25:34 web.1    | Thin web server (v1.6.3 codename Protein Powder)
  7. 14:25:34 web.1    | Maximum connections set to 1024
  8. 14:25:34 web.1    | Listening on localhost:5000, CTRL+C to stop
  9. 14:25:34 clock.1  | I, [2014-10-24T14:25:34.729860 #42870]  INFO -- : Starting clock for 1 events: [ frequent.job ]
  10. 14:25:34 clock.1  | I, [2014-10-24T14:25:34.729999 #42870]  INFO -- : Triggering 'frequent.job'
  11. 14:25:34 clock.1  | Running frequent.job
  12. ...

开发框架检测

不同的 Ruby 开发框架会有不同的配置，Flynn 可以检测在用的框架，并按需配置。

下面是 Flynn 检测常见框架的规则，并设置默认的应用类型（当Procfile文件没有声明应用类型时）：

Ruby

应用根目录下的Gemfile表明这是一个 Ruby 应用。配置默认应用类型：

  1. rake: bundle exec rake
  2. console: bundle exec irb

Rack

在Gemfile.lock里包含rack包，表明这是一个 Rack 应用。

配置默认应用类型：

  1. web: bundle exec rackup config.ru -p $PORT
  2. rake: bundle exec rake
  3. console: bundle exec irb

Rails 2

在Gemfile.lock里包含rails，版本大于等于2.0.0，并且小于 3.0.0，表明这是一个 Rail 2 应用。 配置默认应用类型：

  1. web: bundle exec ruby script/server -p $PORT
  2. worker: bundle exec rake jobs:work
  3. rake: bundle exec rake
  4. console: bundle exec script/console

Rails 3

在Gemfile.lock里包含rails，版本大于等于3.0.0，并且小于 4.0.0，表明这是一个 Rail 3 应用。 配置默认应用类型：

  1. web: bundle exec rails server -p $PORT
  2. worker: bundle exec rake jobs:work
  3. rake: bundle exec rake
  4. console: bundle exec rails console

Rails 4

在Gemfile.lock里包含rails，版本大于等于4.0.0，并且小于 5.0.0，表明这是一个 Rail 4 应用。 配置默认应用类型：

  1. web: bin/rails server -p $PORT -e $RAILS_ENV
  2. worker: bundle exec rake jobs:work
  3. rake: bundle exec rake
  4. console: bin/rails console

Assets

Flynn 会在应用编译的最后阶段运行自定义的assets:precompile任务。

如果 Flynn 检测到 Rails 3 或 4 的应用，但Gemfile里没有包含rails_12factor，系统会自动安装rails3_serve_static_assets并且配置config.serve_static_assets = true。这样你的应用才能在public目录里，对外发布这些资源。

执行任务

如果需要运行 Rake 任务，或者在应用里打开 Rails 终端，使用Flynn run。例如：

  1. $ flynn run rake db:migrate
  2. $ flynn run rails console

关于flynn run的详细信息，请参见命令行文档。

原文: http://doc.oschina.net/flynn?t=54101