nutcracker-web 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9c831f101911a1da17244fd48d15e1df8dad6426
-  data.tar.gz: b2a214d68ee537ffdd4e4eef91ed3a5e27c7889e
+  metadata.gz: 5bef0363a281acf0545f3616b258d4f8d6f1b938
+  data.tar.gz: 0214c654bee10878930cd57a471d41c075aac8c4
 SHA512:
-  metadata.gz: 5d0efaf08c4932b219a96d2dc0786ddb8ff63ddce26adc51357eb8096f105bced20afcc61ad9aea0c0e951e442fcadf354fd3a06a66b84fc7e90451105dd4bc5
-  data.tar.gz: 580dc7627926824c9c819f2b004f79111e8c5eba8869d7ec7f267039da3c4c15d4ce90acdb5b0279e8924418a893d4093c55c7d75cd066e11d69e6bd5baa6f19
+  metadata.gz: 154f7d879843a9558eb97800156c9f359f9b245e8bfafda9782593b29d4301b193eb80546d1dca29228c7d9d991ab7e747b908414238611a047747a1a969ab29
+  data.tar.gz: cb04e9ce6042be389f86b5da61860de1a933d4e1696b84cfe4c340d06306cff6c5871e041d8324be953d3a5b36ebe1e0e3f4c53d81460c2db007a449c06cab7f

data/Gemfile

@@ -7,4 +7,5 @@ gem 'sprockets'
 gem 'coffee-script'
 gem 'eco'
 gem 'json'
-gem 'uglifier'
+gem 'uglifier'
+gem 'nutcracker'

data/Gemfile.lock

@@ -19,9 +19,12 @@ GEM
     hike (1.2.2)
     json (1.8.0)
     multi_json (1.7.5)
+    nutcracker (0.3.0.12)
+      redis
     rack (1.5.2)
     rack-protection (1.5.0)
       rack
+    redis (3.0.7)
     sinatra (1.4.2)
       rack (~> 1.5, >= 1.5.2)
       rack-protection (~> 1.4)
@@ -48,6 +51,7 @@ DEPENDENCIES
   eco
   haml
   json
+  nutcracker
   sinatra
   sprockets
   thin

data/README.md

@@ -25,6 +25,57 @@ gem install nutcracker-web
 ```
 
 ## Usage
+```
+$ nutcracker-web --help
+Usage: nutcracker-web [web-options] -- [nutcracker-options]
+
+[web-options]
+
+  -s, --stats-port PORT            Nutcracker stats port - 22222
+  -c, --config FILE                Nutcracker cluster config file
+  -p, --port PORT                  Web interface listening port
+  -b, --backend BACKEND            Web server to use ( needs to be Rack compliant )
+  -d, --daemonize                  run in background
+  -l, --launch                     launch Nutcracker instance as well
+  -i, --pid FILE                   pid file
+
+[nutcracker-options]
+
+  -h, --help             : this help
+  -V, --version          : show version and exit
+  -t, --test-conf        : test configuration for syntax errors and exit
+  -d, --daemonize        : run as a daemon
+  -D, --describe-stats   : print stats description and exit
+  -v, --verbosity=N      : set logging level (default: 5, min: 0, max: 11)
+  -o, --output=S         : set logging file (default: stderr)
+  -c, --conf-file=S      : set configuration file (default: conf/nutcracker.yml)
+  -s, --stats-port=N     : set stats monitoring port (default: 22222)
+  -a, --stats-addr=S     : set stats monitoring ip (default: 0.0.0.0)
+  -i, --stats-interval=N : set stats aggregation interval in msec (default: 30000 msec)
+  -p, --pid-file=S       : set pid file (default: off)
+  -m, --mbuf-size=N      : set size of mbuf chunk in bytes (default: 16384 bytes)
+
+```
+
+conneting to a running instance of Nutcracker and running the web interface on port 22122
+```
+$ nutcracker-web --config /etc/nutcracker/cluster.yml --port 22122
+[2014-03-02 17:26:40] INFO  WEBrick 1.3.1
+[2014-03-02 17:26:40] INFO  ruby 2.0.0 (2013-05-14) [x86_64-darwin11.4.2]
+[2014-03-02 17:26:40] INFO  WEBrick::HTTPServer#start: pid=84800 port=22122
+```
+
+launching Nutcracker and nutcracker-web
+```
+$ nutcracker-web --config /etc/nutcracker/cluster.yml --port 22122 --launch
+[Sun Mar  2 17:26:37 2014] nc.c:187 nutcracker-0.3.0 built for Darwin 13.0.0 x86_64 started on pid 84801
+[Sun Mar  2 17:26:37 2014] nc.c:192 run, rabbit run / dig that hole, forget the sun / and when at last the work is done / don't sit down / it's time to dig another one
+[2014-03-02 17:26:40] INFO  WEBrick 1.3.1
+[2014-03-02 17:26:40] INFO  ruby 2.0.0 (2013-05-14) [x86_64-darwin11.4.2]
+[2014-03-02 17:26:40] INFO  WEBrick::HTTPServer#start: pid=84800 p
+```
+
+## Usage via code
 After starting the nutcracker service via [nutcracker-ruby](https://github.com/kontera-technologies/nutcracker) just activate the `nutcracker-web` plugin:
 ```ruby
 require 'nutcracker'

data/bin/nutcracker-web

@@ -0,0 +1,98 @@
+#! /usr/bin/env ruby
+$:.unshift File.expand_path('../../lib',__FILE__)
+
+require 'nutcracker'
+require 'nutcracker/web'
+require 'optparse'
+require 'fileutils'
+require 'socket'
+require 'open3'
+
+options = { stats_port: 22222 }
+
+OptionParser.new do |opts|
+  opts.set_summary_indent "  "
+
+  opts.banner = "Usage: nutcracker-web [web-options] -- [nutcracker-options]"
+  opts.separator ""
+  opts.separator "[web-options]"
+  opts.separator ""
+  
+  opts.on("-s", "--stats-port PORT", "Nutcracker stats port - #{options[:stats_port]}") do |v|
+    options[:stats_port] = v.to_i
+  end
+
+  opts.on("-c","--config FILE", "Nutcracker cluster config file") do |v|
+    options[:config_file] = File.expand_path v
+  end
+
+  opts.on("-p","--port PORT", "Web interface listening port") do |v|
+    options[:Port] = v.to_i
+  end
+
+  opts.on("-b","--backend BACKEND", "Web server to use ( needs to be Rack compliant )") do |v|
+    options[:server] = v
+  end
+  
+  opts.on("-d", "--daemonize","run in background") do 
+    options[:daemonize] = true
+  end
+  
+  opts.on("-l", "--launch","launch Nutcracker instance as well") do 
+    options[:launch_nutcracker] = true
+  end
+  
+  opts.on("-i","--pid FILE","pid file") do |v|
+    options[:pid] = v
+    options[:nutcracker_pid] = v + ".nutcracker"
+  end
+  
+  opts.separator ""
+  opts.separator "[nutcracker-options]"
+  Open3.popen3("nutcracker --help") do |_,_,stderr|
+    opts.separator stderr.read.match(/options:(.*)/msi)[1]
+  end rescue nil
+  
+end.parse!
+
+abort "Please specified nutcracker config file" if options[:config_file].nil?
+abort "Can't find the specified config file @ #{options[:config_file]}" unless File.exists? options[:config_file]
+
+args = ARGV.to_a
+args << "--stats-port" << options[:stats_port]
+
+if options[:pid]
+  args << "--pid-file" << options[:nutcracker_pid]
+  at_exit { options.values_at(:pid,:nutcracker_pid).map(&FileUtils.method(:rm_rf)) }
+end
+
+if options[:daemonize]
+  if RUBY_VERSION < "1.9"
+    exit if fork
+    Process.setsid
+    exit if fork
+    Dir.chdir "/"
+    STDIN.reopen "/dev/null"
+    STDOUT.reopen "/dev/null", "a"
+    STDERR.reopen "/dev/null", "a"
+  else
+    Process.daemon
+  end  
+  File.open(options[:pid],'w') { |f| f.write(Process.pid) } rescue nil  
+end
+
+if options[:launch_nutcracker]
+  nutcracker = Nutcracker.start(options.merge(args: args))
+else
+  if (TCPSocket.new('127.0.0.1',options[:stats_port]) rescue nil)
+    nutcracker = Nutcracker.attach(options)
+  else
+   abort "Failed to attach, are you sure that Nutcracker is running ?\n"             + 
+         "the specified stats port is closed ( #{options[:stats_port]} )\n"          +
+         "If you want to launch Nutcracker instance as well use the --launch switch"
+  end
+end
+
+server = nutcracker.use(:web, options)
+
+( options[:launch_nutcracker] ? nutcracker : server ).join

data/lib/nutcracker/web/version.rb

@@ -1,5 +1,5 @@
 module Nutcracker
   module Web
-    VERSION="0.0.8"
+    VERSION="0.0.9"
   end
 end

data/lib/nutcracker/web.rb

@@ -19,6 +19,10 @@ module Nutcracker
       self
     end
     
+    def self.join
+      @thread.join
+    end
+    
     def self.stop
       @thread.kill
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nutcracker-web
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Eran Barak Levi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-23 00:00:00.000000000 Z
+date: 2014-03-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -110,7 +110,8 @@ dependencies:
         version: '0'
 description: Web interface for Nutcracker cluster
 email: eran@kontera.com
-executables: []
+executables:
+- nutcracker-web
 extensions: []
 extra_rdoc_files: []
 files:
@@ -123,6 +124,7 @@ files:
 - lib/nutcracker/web.rb
 - public/assets/application.css
 - public/assets/application.js
+- bin/nutcracker-web
 homepage: http://www.kontera.com
 licenses: []
 metadata: {}