Skip to content
This repository
Newer
Older
100644 43 lines (25 sloc) 2.146 kb
94465000 »
2011-09-20 initial readme
1 # Ruby Language Pack
2
3 The Ruby Language Pack requires a `Gemfile` and `Gemfile.lock` file to be recognized as a ruby app. It will then proceed to run `bundle install` after setting up the appropriate environment for [ruby](http://ruby-lang.org) and [bundler](http://gembundler.com).
4
5 ## Bundler
6
7 For non-windows `Gemfile.lock` files, the `--deployment` flag will be used. The `vendor/bundle` directory is cached between builds to allow for faster `bundle install` times. `bundle clean` is used to ensure no stale gems are stored between builds.
8
9 ## Rails
10
11 A [rails_log_stdout](http://github.com/ddollar/rails_log_stdout) is installed by default so Rails' logger will log to STDOUT and picked up by Heroku's [logplex](http://github.com/heroku/logplex).
12
13 ## Rails 3
14
15 To enable static assets being served on the dyno, [rails3_serve_static_assets](http://github.com/pedro/rails3_serve_static_assets) is installed by default. If the [execjs gem](http://github.com/sstephenson/execjs) is detected then [node](http://github.com/joyent/node) will be vendored. The `assets:precompile` rake task will get run if no `public/manifest.yml` is detected. See [this article](http://devcenter.heroku.com/articles/rails31_heroku_cedar) on how rails 3.1 works on cedar.
16
17 ## Auto Injecting Plugins
18
19 Any vendored plugin can be stopped from being installed by creating the directory it's installed to in the slug. For instance, to prevent rails_log_stdout plugin from being injected, add `vendor/plugins/rails_log_stdout/.gitkeep` to your git repo.
b3d26885 »
2011-09-22 add flow to readme
20
21 ## Ruby Language Pack Flow
22
23 Here's the basic flow of how the language pack works:
24
25 Ruby (Gemfile and Gemfile.lock is detected)
26
27 * runs bundler
28 * installs binaries
29
30 Rails 2 (config/environment.rb is detected)
31
32 * everything from Ruby
33 * install rails 2 plugins
34 * [rails_log_stdout](http://github.com/ddollar/rails_log_stdout)
35
36 Rails 3 (config/application.rb is detected)
37
38 * everything from Rails 2
39 * install rails 3 plugins
40 * [rails3_server_static_assets](https://github.com/pedro/rails3_serve_static_assets)
41 * installs node if the gem execjs is detected
42 * runs `rake assets:precompile` if the rake task is detected
Something went wrong with that request. Please try again.