Giter VIP home page Giter VIP logo

jetty-rackup's Introduction

jetty-rackup

For the newer projects we decided to switch from MRI to JRuby. One of the bigger questions is certainly the deployment.

Reading and trying all the warbler stuff, we had enough of packaging and wanted to do it the Ruby/Sinatra way (with a standalone script, where one can consciously start things like run Sinatra::Application from a rackup script).

Embedding jetty is also mentioned in the jetty documentation "For many applications, HTTP is just another interface protocol. Jetty can easily be embedded in such applications and products without adopting a WWW centric application architecture."

So here is the solution:

  • write your Rack based application as usual
  • create a rackup script config.ru as usual; there is more information in the official tutorial https://github.com/rack/rack/wiki/(tutorial)-rackup-howto
  • install jetty-rackup (this project), e.g. gem install jetty-rackup or git clone git://github.com/geekq/jetty-rackup.git
  • from your application folder run jetty-rackup. You can also provide a path to non-standard rackup-script and the desired port number for the server to run.

Now your application runs inside jetty servlet container. Enjoy!

Example

$cat config.ru

#\ -p 8765
require 'rubygems'
gem 'sinatra', '>= 1.0.0'
require './my_app.rb'
set :run, false # disable built-in sinatra web server
set :environment, :development
set :base_url, 'http://xxtrial' # custom application option
run Sinatra::Application

Binaries

The jetty and jruby-rack binaries are now provided for your convinience. But you can also download a different version of them, if you wish, from the official web sites of the respective projects:

The major gem version (7) now matches the used jetty version.

FAQ

What's the best way to set max memory?

jruby -J-Xmx2048m  /usr/local/lib/jetty-rackup/jetty-rackup config.ru

Tests

There are no automated tests for jetty-rackup. But there are some example applications with rackup configuration. Just cd to the particular example directory and run. E.g.

cd examples/just_ruby/
jetty-rackup
firefox http://localhost:9292/stranger

jetty-rackup uses config.ru file from the current directory by default.

What's new

  • 7.2.0
    • Add support for Host option. In addition to specifying port now a host ip can also be specified if e.g. you only wish to bind the server only to the loopback interface 127.0.0.1 and not to all IPs.
    • Add support for pid option - create pid file

See also

For Rails deployment you may prefer jetty-rails http://jetty-rails.rubyforge.org/

Copyright

(c) 2009 Vodafone Group Services GmbH

(c) 2013 Vladimir Dobriakov

Author

Vladimir Dobriakov http://blog.geekq.net, http://www.mobile-web-consulting.de

With contributions by Leandro Silva, Jason Rogers and erdeszt.

Further Credits

jetty-rackup's People

Contributors

erdeszt avatar geekq avatar jacaetevha avatar leandrosilva avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.