norr-merb-manage 0.6

data/CONTRIBUTORS

@@ -0,0 +1,5 @@
+merb-manage: a tool for controlling and configuring Merb applications
+
+Contributors:
+
+	* Fabien Franzen (loob2) - http://github.com/fabien

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+ 
+Copyright (c) 2008 El Draper
+ 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README

@@ -0,0 +1,40 @@
+merb-manage: a tool for controlling and configuring Merb applications
+
+Usage:
+
+	merb-manage-ctl [start|stop|restart] (-c CONFIG_DIR)
+		start: starts any instances of Merb applications configured within the CONFIG_DIR (defaults to /etc/merb-manage)
+		stop: stops any instances of Merb applications configured within the CONFIG_DIR
+		restart: stops, then starts any instances of Merb applications configured within the CONFIG_DIR
+		
+	merb-manage [start|stop|restart]
+		this script can be used as a startup script, for example within /etc/init.d, to call out to merb-manage-ctl to start Merb applications when a server starts
+		
+
+Configuration:
+
+	YAML configuration files define the Merb application settings for merb-manage. Generally you can store the configuration within the config directory of your Merb application (config/merb-manage.yml), and then symlink this to a file within the configuration directory (/etc/merb-manage/myapp.yml).
+	
+	Configuration might look like the following:
+	
+		path: /var/www/sample_app
+		gem: false
+		adapter: thin
+		environment: production
+		port: 5000
+		servers: 3
+		user: www-data
+		group: www-data
+		logging: info
+
+	Here are the supported parameters:
+		user:			the user that the application should run as - if specified, the Merb application is started with an su USER -c "COMMAND", and the user is passed through to the Merb startup command
+		group:			the group that the application runs under, passed through to the Merb startup command
+		adapter:		the web application server adapter, such as mongrel, thin etc - anything that your installation of Merb supports
+		environment:		the Merb environment to run as, development, test or production
+		servers:		the amount of servers to start (for clustering/load balancing etc)
+		port:			the port to start the Merb application on (in the case of multiple servers, the ports will be sequential from the port specified, i.e. servers set to 3, with port set to 5000, would start the application on 5000, 5001 and 5002)
+		logging:		the logging level to pass through to Merb - debug, info, warn, error and fatal
+		gem:			set to true to use bundled merb gem in app (bin/merb). set to false or leave out to use global merb
+		
+	Most of these options can be left off if you simply want the Merb defaults - if "servers" isn't specified however, then Merb will be passed the "-d" flag to ensure that the single Merb server will run in daemonized mode.

data/bin/merb-manage-ctl

@@ -0,0 +1,85 @@
+#!/usr/bin/env ruby
+#
+# Copyright (c) 2008 El Draper, el@eldiablo.co.uk
+#
+# merb-manage-ctl     Controller script for starting/stopping/restarting configured Merb applications
+#
+require "yaml"
+
+# Default config directory
+configuration_pattern = "/etc/merb-manage/*.yml"
+
+# This iterates through each config found in the configuration directory, executing the specified block for each
+def each_config(config, &block)
+  begin
+    Dir.glob(config) do |yml|
+      begin
+        result = yield YAML.load(open(File.join(yml)))
+        puts "#{yml}:"
+        result.split("\n").each { |r| puts r }
+      rescue Exception => err
+        puts "Exception (#{yml}): #{err.message}"
+      end
+    end
+  rescue Errno::ENOENT
+    puts "Unable to find #{config}"
+  rescue Errno::ENOTDIR
+    puts "Not a directory - #{config}"
+  end
+end
+
+# This starts the server as per the specified yml config
+def start(yml)
+  # Decide which merb to use, bundled gem or global
+  if yml["gem"].nil?
+    command = "merb -m #{yml['path']} "
+  else
+    if yml["gem"]
+      command = "#{yml['path']}/bin/merb -m #{yml['path']} "
+    else
+      command = "merb -m #{yml['path']} "  
+    end
+  end
+  command += "-u #{yml['user']} " unless yml["user"].nil?
+  command += "-G #{yml['group']} " unless yml["group"].nil?
+  command += "-a #{yml['adapter']} " unless yml["adapter"].nil?
+  command += "-e #{yml['environment']} " unless yml["environment"].nil?
+  command += "-c #{yml['servers']} " unless yml["servers"].nil?
+  command += "-d " if yml["servers"].nil?
+  command += "-p #{yml['port']} " unless yml["port"].nil?
+  command += "-l #{yml['logging']} " unless yml["logging"].nil?
+  command = "su #{yml['user']} -c \"#{command}\"" unless yml["user"].nil?
+  `#{command}`
+end
+
+# This stops the server as per the specified yml config
+def stop(yml)
+  `merb -m #{yml["path"]} -k all`
+end
+
+# See if there is a -c argument
+if ARGV.include?("-c")
+  # Attempt to grab the specified config directory
+  config = ARGV[ARGV.index("-c") + 1]
+  configuration_pattern = config unless config.nil?
+end
+
+# Evaluate and execute the action being requested
+case ARGV[0]
+  when "start":
+    each_config(configuration_pattern) do |yml|
+      start(yml)
+    end
+  when "restart":
+    each_config(configuration_pattern) do |yml|
+      stop(yml)
+      start(yml)
+    end
+  when "stop":
+    each_config(configuration_pattern) do |yml|
+      stop(yml)
+    end
+else
+  # Print out the usage as the arguments didn't match a known action
+  puts "Usage: merb-manage-ctl {start|stop|restart} (-c CONFIG_GLOB)"
+end

data/config/merb.yml.sample

@@ -0,0 +1,9 @@
+path: /var/www/sample_app
+gem: false
+adapter: thin
+environment: production
+port: 5000
+servers: 3
+user: www-data
+group: www-data
+logging: info

data/resources/merb-manage

@@ -0,0 +1,41 @@
+#!/bin/bash
+#
+# Copyright (c) 2008 El Draper, el@eldiablo.co.uk
+#
+# merb-manage			Startup script for Merb applications, utilising merb-manage-ctl
+#
+# Can be used as a startup script to ensure Merb apps fire back up after a reboot (such as within /etc/init.d)
+#
+PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/local:/usr/local/sbin:/usr/local/bin
+MERB_MANAGE_CONF_DIR=/etc/merb-manage
+
+# Default return value
+RETVAL=0
+
+# Exit if we can't find the merb-manage-ctl script
+which merb-manage-ctl >/dev/null || exit 0
+
+# Validate config directory
+[ -d "$MERB_MANAGE_CONF_DIR" ] || exit 0
+
+# Evaluate command
+case "$1" in
+    start)
+      merb-manage-ctl start -c $MERB_MANAGE_CONF_DIR
+      RETVAL=$?
+  ;;
+    stop)
+      merb-manage-ctl stop -c $MERB_MANAGE_CONF_DIR
+      RETVAL=$?
+  ;;
+    restart)
+      merb-manage-ctl restart -c $MERB_MANAGE_CONF_DIR
+      RETVAL=$?
+  ;;
+    *)
+      echo "Usage: merb-manage {start|stop|restart}"
+      exit 1
+  ;;
+esac
+
+exit $RETVAL

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification 
+name: norr-merb-manage
+version: !ruby/object:Gem::Version 
+  version: "0.6"
+platform: ruby
+authors: 
+- El Draper
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-09 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: merb
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.2
+    version: 
+description: 
+email: el@eldiablo.co.uk
+executables: 
+- merb-manage-ctl
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- CONTRIBUTORS
+- LICENSE
+- README
+- bin/merb-manage-ctl
+- config/merb.yml.sample
+- resources/merb-manage
+has_rdoc: false
+homepage: http://github.com/eldiablo/merb-manage
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Provides easy configuration and management of Merb applications, including multiple servers and different adapters
+test_files: []
+