mongrel_cluster 0.1

data/COPYING

@@ -0,0 +1,20 @@
+Copyright (c) 2006 Bradley Taylor, bradley@railsmachine.com
+
+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/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006 Bradley Taylor, bradley@railsmachine.com
+
+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,17 @@
+== Mongrel Cluster Plugin
+
+Tool to help start/stop/restart multiple mongrel servers to use behind a load balancer like Pound or Balance. This plugin adds an option to specify a number of Mongrel servers to launch, a range of ports, and a configuration file for the cluster. Use "-h" to see command syntax.
+
+Configure cluster and write configuration file:
+mongrel_rails cluster::configure  
+
+Start cluster:
+mongrel_rails cluster::start
+
+Restart cluster:
+mongrel_rails cluster::restart
+
+Stop cluster:
+mongrel_rails cluster::stop
+
+

data/Rakefile

@@ -0,0 +1,38 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'tools/rakehelp'
+require 'fileutils'
+include FileUtils
+
+setup_tests
+setup_clean ["pkg", "lib/*.bundle", "*.gem", ".config"]
+
+setup_rdoc ['README', 'LICENSE', 'COPYING', 'lib/**/*.rb', 'doc/**/*.rdoc']
+
+desc "Does a full compile, test run"
+task :default => [:test, :package]
+
+version="0.1"
+name="mongrel_cluster"
+
+setup_gem(name, version) do |spec|
+  spec.summary = "The mongrel_cluster GemPlugin"
+  spec.description = spec.summary
+  spec.author="Bradley Taylor"
+  spec.add_dependency('gem_plugin', '>= 0.2.1')
+  spec.add_dependency('mongrel', '>= 0.3.12.2')
+  spec.files += Dir.glob("resources/**/*")
+end
+
+
+task :install => [:test, :package] do
+  sh %{sudo gem install pkg/#{name}-#{version}.gem}
+end
+
+task :uninstall => [:clean] do
+  sh %{sudo gem uninstall #{name}}
+end
+

data/lib/mongrel_cluster/init.rb

@@ -0,0 +1,197 @@
+require 'gem_plugin'
+require 'mongrel'
+require 'yaml'
+
+module Cluster
+  
+  class Start < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+    
+    def configure
+      options [['-C', '--config PATH', "Path to configuraion file", :@config_file, "config/mongrel_cluster.yml"]]
+    end
+
+    def validate
+      valid_exists?(@config_file, "Configuration file does not exist. Run mongrel_rails cluster::configure.")
+      return @valid
+    end
+    
+    def run
+      @options = { 
+        "environment" => ENV['RAILS_ENV'] || "development",
+        "port" => 3000,
+        "address" => "0.0.0.0",
+        "log_file" => "log/mongrel.log",
+        "pid_file" => "log/mongrel.pid",
+        "servers" => 2 
+      }
+      
+      @conf_options = YAML.load_file(@config_file)
+      @options.merge! @conf_options if @conf_options
+      port = @options["port"].to_i - 1
+      pid = @options["pid_file"].split(".")
+      puts "Starting #{@options["servers"]} Mongrel servers..."
+      1.upto(@options["servers"].to_i) do |i|
+        argv = [ "mongrel_rails" ]
+        argv << "start"
+        argv << "-d"
+        argv << "-e #{@options["environment"]}"
+        argv << "-p #{port+i}"
+        argv << "-a #{@options["address"]}"
+        argv << "-l #{@options["log_file"]}"
+        argv << "-P #{pid[0]}-#{i}.#{pid[1]}"
+        argv << "-c #{@options["cwd"]}"
+        argv << "-t #{@options["timeout"]}"
+        argv << "-m #{@options["mime_map"]}" if @options["mime_map"]
+        argv << "-r #{@options["docroot"]}"
+        argv << "-n #{@options["num-procs"]}"
+        argv << "-B" if @options["debug"]
+        argv << "-S #{@options["config_script"]}" if @options["config_script"]
+        cmd = argv.join " "
+        puts cmd
+        status = `#{cmd}`
+        puts status
+      end
+    end
+  end
+  
+  class Stop < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+
+    def configure
+      options [
+       ['-C', '--config PATH', "Path to config file", :@config_file, "config/mongrel_cluster.yml"],
+       ['-f', '--force', "Force the shutdown.", :@force, false]
+      ]
+    end
+
+    def validate
+      valid_exists?(@config_file, "Configuration file does not exist. Run mongrel_rails cluster::configure.")
+      return @valid
+    end
+    
+    def run
+      @options = { 
+       "environment" => ENV['RAILS_ENV'] || "development",
+       "port" => 3000,
+       "address" => "0.0.0.0",
+       "log_file" => "log/mongrel.log",
+       "pid_file" => "log/mongrel.pid",
+       "servers" => 2 
+      }
+      
+      @conf_options = YAML.load_file(@config_file)
+      @options.merge! @conf_options if @conf_options
+      pid = @options["pid_file"].split(".")
+      puts "Stopping #{@options["servers"]} Mongrel servers..."
+      1.upto(@options["servers"].to_i) do |i|
+        cmd = "mongrel_rails stop -P #{pid[0]}-#{i}.#{pid[1]} -c #{@options["cwd"]} #{"-f" if @force }"
+        puts cmd
+        status = `#{cmd}`
+        puts status
+      end
+    end  
+  end
+  
+  class Restart < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+
+    def configure 
+      options [ 
+        ['-C', '--config PATH', "Path to config file", :@config_file, "config/mongrel_cluster.yml"],
+        ['-s', '--soft', "Do a soft restart rather than a process exit restart", :@soft, false]       
+      ]
+    end
+
+    def validate
+      valid_exists?(@config_file, "Configuration file does not exist. Run mongrel_rails cluster::configure.")
+      return @valid
+    end
+    
+    def run
+      @options = { 
+        "environment" => ENV['RAILS_ENV'] || "development",
+        "port" => 3000,
+        "address" => "0.0.0.0",
+        "log_file" => "log/mongrel.log",
+        "pid_file" => "log/mongrel.pid",
+        "servers" => 2 
+      }
+      
+      @conf_options = YAML.load_file(@config_file)
+      @options.merge! @conf_options if @conf_options
+      pid = @options["pid_file"].split(".")
+      puts "Restarting #{@options["servers"]} Mongrel servers..."
+      1.upto(@options["servers"].to_i) do |i|
+        cmd = "mongrel_rails restart -P #{pid[0]}-#{i}.#{pid[1]} -c #{@options["cwd"]} #{"-s" if @soft }"
+        puts cmd
+        status = `#{cmd}`
+        puts status
+      end
+    end  
+  end
+  
+  class Configure < GemPlugin::Plugin "/commands"
+    include Mongrel::Command::Base
+    
+    def configure 
+      options [
+        ["-e", "--environment ENV", "Rails environment to run as", :@environment, ENV['RAILS_ENV'] || "development"],
+        ['-p', '--port PORT', "Starting port to bind to", :@port, 3000],
+        ['-a', '--address ADDR', "Address to bind to", :@address, "0.0.0.0"],
+        ['-l', '--log FILE', "Where to write log messages", :@log_file, "log/mongrel.log"],
+        ['-P', '--pid FILE', "Where to write the PID", :@pid_file, "log/mongrel.pid"],
+        ['-c', '--chdir PATH', "Change to dir before starting (will be expanded)", :@cwd, Dir.pwd],
+        ['-t', '--timeout SECONDS', "Timeout all requests after SECONDS time", :@timeout, 120],
+        ['-m', '--mime PATH', "A YAML file that lists additional MIME types", :@mime_map, nil],
+        ['-r', '--root PATH', "Set the document root (default 'public')", :@docroot, "public"],
+        ['-n', '--num-procs INT', "Number of processor threads to use", :@num_procs, 1024],
+        ['-B', '--debug', "Enable debugging mode", :@debug, false],
+        ['-S', '--script PATH', "Load the given file as an extra config script.", :@config_script, nil],
+        ['-N', '--num-servers INT', "Number of Mongrel servers", :@servers, 2],
+        ['-C', '--config PATH', "Path to config file", :@config_file, "config/mongrel_cluster.yml"]
+      ]
+    end
+
+    def validate
+      @servers = @servers.to_i
+      @port = @port.to_i
+      @timeout = @timeout.to_i
+      
+      @cwd = File.expand_path(@cwd)
+      valid_dir? @cwd, "Invalid path to change to during daemon mode: #{@cwd}"
+      valid?(@servers > 0, "Must give a valid number of servers")
+      valid?(@port > 0, "Must give a valid starting port")
+      valid?(@timeout > 0, "Must give a valid timeout for requests")
+
+      valid_dir? File.dirname(@log_file), "Path to log file not valid: #{@log_file}"
+      valid_dir? File.dirname(@pid_file), "Path to pid file not valid: #{@pid_file}"
+      valid_dir? File.dirname(@config_file), "Path to config file not valid: #{@config_file}"
+      
+      valid_dir? File.dirname(@docroot), "Path to docroot not valid: #{@docroot}"
+      valid_exists? @mime_map, "MIME mapping file does not exist: #{@mime_map}" if @mime_map
+      
+      return @valid
+    end
+
+    def run
+      @options = { 
+        "environment" => @environment,
+        "port" => @port,
+        "address" => @address,
+        "log_file" => @log_file,
+        "pid_file" => @pid_file,
+        "servers" => @servers,
+        "cwd" => @cwd,
+        "timeout" => @timeout,
+        "mime_map" => @mime_map,
+        "docroot" => @docroot,
+        "debug" => @debug,
+        "config_script" => @config_script,
+        "num-procs" => @num_procs
+      }
+      puts "Writing configuration file to #{@config_file}."
+      File.open(@config_file,"w") {|f| f.write(@options.to_yaml)}
+    end  
+  end
+end

data/resources/defaults.yaml

@@ -0,0 +1,2 @@
+--- 
+:debug: false

data/tools/rakehelp.rb

@@ -0,0 +1,105 @@
+
+def make(makedir)
+    Dir.chdir(makedir) do
+        sh(PLATFORM =~ /win32/ ? 'nmake' : 'make')
+    end
+end
+
+
+def extconf(dir)
+    Dir.chdir(dir) do ruby "extconf.rb" end
+end
+
+
+def setup_tests
+    Rake::TestTask.new do |t|
+        t.libs << "test"
+        t.test_files = FileList['test/test*.rb']
+        t.verbose = true
+    end
+end
+
+
+def setup_clean otherfiles
+    files = ['build/*', '**/*.o', '**/*.so', '**/*.a', 'lib/*-*', '**/*.log'] + otherfiles
+    CLEAN.include(files)
+end
+
+
+def setup_rdoc files
+    Rake::RDocTask.new do |rdoc|
+        rdoc.rdoc_dir = 'doc/rdoc'
+        rdoc.options << '--line-numbers'
+        rdoc.rdoc_files.add(files)
+    end
+end
+
+
+def setup_extension(dir, extension)
+    ext = "ext/#{dir}"
+    ext_so = "#{ext}/#{extension}.#{Config::CONFIG['DLEXT']}"
+    ext_files = FileList[
+    "#{ext}/*.c",
+    "#{ext}/*.h",
+    "#{ext}/extconf.rb",
+    "#{ext}/Makefile",
+    "lib"
+    ] 
+    
+    task "lib" do
+        directory "lib"
+    end
+
+    desc "Builds just the #{extension} extension"
+    task extension.to_sym => ["#{ext}/Makefile", ext_so ]
+
+    file "#{ext}/Makefile" => ["#{ext}/extconf.rb"] do
+        extconf "#{ext}"
+    end
+
+    file ext_so => ext_files do
+        make "#{ext}"
+        cp ext_so, "lib"
+    end
+end
+
+
+def base_gem_spec(pkg_name, pkg_version)
+  pkg_version = pkg_version
+  pkg_name    = pkg_name
+  pkg_file_name = "#{pkg_name}-#{pkg_version}"
+  Gem::Specification.new do |s|
+    s.name = pkg_name
+    s.version = pkg_version
+    s.platform = Gem::Platform::RUBY
+    s.has_rdoc = true
+    s.extra_rdoc_files = [ "README" ]
+    
+    s.files = %w(COPYING LICENSE README Rakefile) +
+      Dir.glob("{bin,doc/rdoc,test,lib}/**/*") + 
+      Dir.glob("ext/**/*.{h,c,rb}") +
+      Dir.glob("examples/**/*.rb") +
+      Dir.glob("tools/*.rb")
+    
+    s.require_path = "lib"
+    s.extensions = FileList["ext/**/extconf.rb"].to_a
+    s.bindir = "bin"
+  end
+end
+
+def setup_gem(pkg_name, pkg_version)
+  spec = base_gem_spec(pkg_name, pkg_version)
+  yield spec if block_given?
+    
+  Rake::GemPackageTask.new(spec) do |p|
+    p.gem_spec = spec
+    p.need_tar = true
+  end
+end
+
+def setup_win32_gem(pkg_name, pkg_version)
+  spec = base_gem_spec(pkg_name, pkg_version)
+  yield spec if block_given?
+
+  Gem::Builder.new(spec).build
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: mongrel_cluster
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+date: 2006-04-24 00:00:00 -04:00
+summary: The mongrel_cluster GemPlugin
+require_paths: 
+- lib
+email: 
+homepage: 
+rubyforge_project: 
+description: The mongrel_cluster GemPlugin
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+- Bradley Taylor
+files: 
+- COPYING
+- LICENSE
+- README
+- Rakefile
+- lib/mongrel_cluster
+- lib/mongrel_cluster/init.rb
+- tools/rakehelp.rb
+- resources/defaults.yaml
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: 
+- README
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: gem_plugin
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mongrel
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.12.2
+    version: