Last post I demonstrated setting up a Ruby on Rails app on Heroku,
running with the Puma server. As I mentioned before, in order to
get the most out of Puma you should use a Ruby implementation with real
threads like JRuby or Rubinius 2. In this post we'll repeat
most of the previous steps, but this time we'll use a Third-Party Buildpack
and get setup with JRuby.
First create a new rails app
~$ jruby -S rails new heroku-jruby-puma create ... ~$ cd heroku-jruby-puma ~$ git init
If you check your Gemfile, you should see some key differences:
sqlite3gem you have
Some adjustments are needed to get this new Rails app to play nice on
Heroku with Puma. First, we can't just use the
pg gem; You need to use
activerecord-jdbcpostgresql-adapter instead. Add
puma and set
some configuration variables for Rails and we're set.
... gem 'activerecord-jdbcpostgresql-adapter' gem 'puma' ... group :development do gem 'foreman' gem 'activerecord-jdbcsqlite3-adapter' end
Note: here I left
activerecord-jdbcsqlite3-adapter in the
development group just as an example.
... config.assets.initialize_on_precompile = false
... config.serve_static_assets = true ... config.threadsafe! # Heroku log stuff STDOUT.sync = true config.logger = Logger.new(STDOUT)
Heroku's Cedar stack has no native language or framework; instead your
sever is setup via a set of scripts called Buildpacks. Heroku
provides buildpacks for Ruby, Node.js, Python and a handful of others,
but you can also create or use your own Buildpack by using the
--buildpack flag and providing a URL. Here we'll use JRuby's Heroku Buildpack from github.com/jruby/heroku-buildpack-jruby.
~$ heroku create heroku-jruby-puma \ --buildpack https://github.com/jruby/heroku-buildpack-jruby.git Creating heroku-jruby-puma ... done, stack is cedar BUILDPACK_URL=https://github.com/jruby/heroku-buildpack-jruby.git ... ~$
Now when you push your code up, Heroku's slug compiler knows how to
package things an build them to use JRuby.
As I mentioned last time, a
Procfile tells Heroku how to run your app:
web: bin/puma -p $PORT -e $RACK_ENV
Thats it! Commit your changes and push to Heroku like before:
~$ git push -----> Heroku receiving push -----> Fetching custom buildpack... done -----> JRuby app detected -----> Vendoring JRuby into slug -----> Installing dependencies with Bundler ... -----> Writing config/database.yml to read from DATABASE_URL -----> Precompiling assets ... -----> Discovering process types Procfile declares types -> web -----> Compiled slug size is 44.5MB -----> Launching... done, v7 http://heroku-jruby-puma.herokuapp.com deployed to Heroku To email@example.com:heroku-jruby-puma.git 6bced4f..383a7cc master -> master ~$
Within a few moments you should be running on JRuby/Puma on Heroku.
Notice that your slug size is significantly larger than a normal stock
Rails app running on MRI. That's because of 4th item you see above,
"Vendoring JRuby into slug".
Congratulations! You're now running Rails with JRuby and Puma on Heroku.