Pack a Ruby application into an executable jar file.
Jarbler creates a self executing Java jar file containing a Ruby application and all its Gem dependencies.
This tool is inspired by the widely used JRuby runner Warbler. The configured Ruby program is directly executed inside the JVM using the JRuby runtime jars.
Install the gem and add to the application's Gemfile by executing:
$ bundle add jarbler --group "development"
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install jarbler
To create a jar file simply run "jarble" in your application's root directory.
$ jarble
To adjust Jarbler's configuration, modify the settings in config file ´config/jarble.rb´. The template for this config file you create by executing
$ jarble config
- Dependency handling should be based on Bundler (existence of Gemfile is required)
- The Ruby app should be capable of running with JRuby
- Gems with native extensions should not be used (e.g. sassc)
- if needed for development or test such Gems with native extensions should be moved to the development and test group in the Gemfile.
- Otherwise the created jar file may not be executable on all platforms and Java versions.
The jar file created by Jarbler can be executed by
$ java -jar <jar filename>
Additional command line parameters are passed through to the executed Ruby app (like "-p 8900" for different network port number with bin/rails)
The file config/jarble.rb contains the configuration for Jarbler. To create a template config file with information about all the supported configuration options, execute:
$ jarble config
The default configuration is focused on Ruby on Rails applications.
| Option | Default value | Description |
|---|---|---|
| compile_java_version | none | Java version the compiled .class files should be compatible with. Controls the target and source version of the Java compiler if compile_ruby_files=true (javac -source and -target). E.g. "1.8" for Java 8. If not set then it generates the class file version according to your current Java version. |
| compile_ruby_files | false | Ahead of time compilation of all .rb files of the application to .class files. Only the .class files are stored in the jar file. The Gem dependencies are not compiled. Requires JRuby as Ruby environment at compile time. |
| executable | "bin/rails" | The ruby start file to run at execution of jar file. File extension .class is used automatically if start file is .rb and AOT compilation is used. |
| executable_params | ["server", "-e", "production", "-p", "8080"] | Command line parameters to be used for the ruby executable |
| excludes_from_compile | [] | The files and dirs of the project to exclude from the compilation of .rb files. Paths specifies the location in the jar file (e.g. ["app_root/file.rb"] ) |
| excludes | ["tmp/cache", "tmp/pids", ...] (see generated template file for whole content) | The files and dirs of the project to exclude from the include option |
| includes | ["app", "bin", "config", ...] (see generated template file for whole content) | The files and dirs of the project to include in the jar file |
| jar_name | < Name of project dir >.jar | The name of the generated jar file |
| jruby_version | A valid JRuby version from file '.ruby-version' or the current most recent version of the Gem 'jruby-jars' | The version of the JRuby runtime to use |
- Set DEBUG=true in OS environment to get additional runtime information
- The temporary folder with the extracted app and JRuby runtime files is not deleted after execution if DEBUG is set.
- Gem::LoadError: You have already activated ..., but your Gemfile requires ... . Since ... is a default gem, you can either remove your dependency on it or try updating to a newer version of bundler that supports net-protocol as a default gem.
- Reason: Mismatch between the version of the local requested gem and the version of the default gem
- Solution: Update the default gems to the requested version
Bug reports and pull requests are welcome on GitHub at https://github.com/rammpeter/jarbler.
Any feedback about usage experience or missing features is also appreciated.
The gem is available as open source under the terms of the MIT License.