如何部署 Ruby 应用

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

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

    软件依赖

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

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

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

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

    具体环境

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

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

    1. group :development do
    2.   gem "debugger"
    3. end
    5.   gem "rspec"
    6. 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"

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

    • libssl-dev
    • libmysqlclient-dev
    • libxml2-dev
    • libxslt-dev
      库文件的完整列表，参见：。

    应用类型

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

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

    web

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

    Thin

    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类型的应用通常是在后台运行的进程，用来处理队列任务，例如： 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）任务。

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

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

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

    开发框架检测

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

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

    Ruby

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

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

    在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

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

    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

    关于flynn run的详细信息，请参见。