amphibian 0.0.1 → 0.0.2

data/History.txt

@@ -2,3 +2,9 @@
 
 * 1 major enhancement:
   * Initial release
+  
+== 0.0.2 2009-06-28
+
+* 2 major enhancements:
+  * adding 'check_balancer_members' executable
+  * fixing output of 'BalancerManager#enabled_hosts' and 'BalancerManager#disabled_hosts'

data/Manifest.txt

@@ -3,6 +3,7 @@ Manifest.txt
 PostInstall.txt
 README.rdoc
 Rakefile
+bin/check_balancer_members
 lib/amphibian.rb
 lib/amphibian/balancerManagerDocument.rb
 lib/amphibian/runner.rb

data/README.rdoc

@@ -4,17 +4,37 @@
 
 Amphibian is a ruby library for accessing and interacting with an Apache mod_proxy_balancer via the web GUI created by the balancer_manager directive.
 
+Amhpbian works by scraping the balancer-manager page, and sending get requests with appropriate query strings to the balancer manager in order to enable and disable hosts.
+
 == FEATURES/PROBLEMS:
 
-* TODO
+Allows you to access the different balancers and members on the Apache mod_proxy_balancer balancer-manager handler page.
+
+Also, investigating controlling the load balancer via the web page, but use at your own risk.
+
 
 == SYNOPSIS:
 
-*  TODO
+  nick-stielaus-computer-3:amphibian nick$ irb
+  >> require 'amphibian'
+  => true
+  >> a = "http://example.com/balancer-manager"
+  => "http://example.com/balancer-manager"
+  >> amp = Amphibian::BalancerManager.new(a)
+  >> amp.hosts
+  => ["http://127.0.0.1:10000", "http://127.0.0.1:10001", "http://127.0.0.1:10002"]
+  >> amp.enabled_hosts
+  => ["http://127.0.0.1:10001", "http://127.0.0.1:10002"]
+  >> amp.disabled_hosts
+  => ["http://127.0.0.1:10000"]
+  >> amp.hosts_with_status
+  => {"http://127.0.0.1:10000"=>"Dis", "http://127.0.0.1:10001"=>"Ok", "http://127.0.0.1:10002"=>"Ok"}
+
 
 == REQUIREMENTS:
 
-* TODO
+* Ruby stuff
+* Apache, mod_proxy, mod_proxy_balancer, and an accessible balancer-manager page.
 
 == INSTALL:
 

data/Rakefile

@@ -9,6 +9,8 @@ $hoe = Hoe.new('amphibian', Amphibian::VERSION) do |p|
   p.changes              = p.paragraphs_of("History.txt", 0..1).join("\n\n")
   p.post_install_message = 'PostInstall.txt'
   p.rubyforge_name       = p.name
+  p.bin_files          = ["bin/check_balancer_members"]
+
   # p.extra_deps         = [
   #   ['activesupport','>= 2.0.2'],
   # ]

data/bin/check_balancer_members

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'amphibian'
+
+options = {:dry_run => false, :test_page => '/', :test_regex => nil}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename($0)}"
+
+  opts.on("-h", "--help", "Displays this help info") do
+    puts opts
+    exit 0
+  end
+  
+  opts.on("-d", "--dry-run", "Prints and logs, but does not change balancer manager.") do |d|
+    options[:dry_run] = d
+  end
+  
+  opts.on("-b", "--balancer-manager URL", "The URL of the balancer-manager to use.") do |b|
+    options[:balancer_manager_url] = b
+  end
+  
+  opts.on("-p", "--test-page PAGE", "The page to test with the heartbeat, i.e. '/pages/heartbeat'.") do |p|
+    options[:test_page] = p
+  end
+  
+  opts.on("-r", "--test-regex REGEX", "The regex to run against the test page that verify's the page is loading correctly.") do |r|
+    options[:test_regex] = r
+  end
+
+  # TODO: Version
+  # opts.on_tail("--version", "Show version") do
+  #   puts Amphibian::Version.join('.')
+  #   exit
+  # end
+
+  begin
+    opts.parse!(ARGV)
+  rescue OptionParser::ParseError => e
+    warn e.message
+    puts opts
+    exit 1
+  end
+end
+
+# Arg checking...
+abort "You must specify the URL of the balancer-manager to use." if options[:balancer_manager_url].nil?
+
+# Instanciate and check!
+amp = Amphibian::Runner.new(options[:balancer_manager_url], options[:test_page], options[:test_regex], options[:dry_run])
+amp.do_check
+
+

data/lib/amphibian.rb

@@ -16,5 +16,5 @@ require 'amphibian/balancerManagerDocument'
 
 
 module Amphibian
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

data/lib/amphibian/balancerManagerDocument.rb

@@ -30,17 +30,23 @@ module Amphibian
       @hosts ||= (get_doc/'a').select{|a_tag| a_tag.inner_text =~ /^http:/}.map{|a_tag| a_tag.inner_text}
     end
     
+    # Get an array of hosts that are in 'Ok' state
+    #---
     # TODO: Optionally force refresh
+    #+++
     def enabled_hosts
       hosts_array = []
-      hosts_with_status.select{|host,state| state == 'Ok'}.each{|host| hosts_array << host}
+      hosts_with_status.select{|host,state| state == 'Ok'}.each{|host, state| hosts_array << host}
       hosts_array
     end
     
+    # Get an array of hosts that are not in 'Ok' state
+    #---
     # TODO: Optionally force refresh
+    #+++
     def disabled_hosts
       hosts_array = []
-      hosts_with_status.select{|host,state| state != 'Ok'}.each{|host| hosts_array << host}
+      hosts_with_status.select{|host,state| state != 'Ok'}.each{|host, state| hosts_array << host}
       hosts_array
     end
     
@@ -93,7 +99,7 @@ private
       end
     end
 
-    def log_error(error)
+    def log_error(error = "")
       puts "ERROR: #{error}"
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: amphibian
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Nick Stielau
@@ -32,11 +32,11 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.8.0
     version: 
-description: Amphibian is a ruby library for accessing and interacting with an Apache mod_proxy_balancer via the web GUI created by the balancer_manager directive.
+description: Amphibian is a ruby library for accessing and interacting with an Apache mod_proxy_balancer via the web GUI created by the balancer_manager directive.  Amhpbian works by scraping the balancer-manager page, and sending get requests with appropriate query strings to the balancer manager in order to enable and disable hosts.
 email: 
 - nick.stielau@gmail.com
-executables: []
-
+executables: 
+- check_balancer_members
 extensions: []
 
 extra_rdoc_files: 
@@ -50,6 +50,7 @@ files:
 - PostInstall.txt
 - README.rdoc
 - Rakefile
+- bin/check_balancer_members
 - lib/amphibian.rb
 - lib/amphibian/balancerManagerDocument.rb
 - lib/amphibian/runner.rb
@@ -84,7 +85,7 @@ rubyforge_project: amphibian
 rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
-summary: Amphibian is a ruby library for accessing and interacting with an Apache mod_proxy_balancer via the web GUI created by the balancer_manager directive.
+summary: Amphibian is a ruby library for accessing and interacting with an Apache mod_proxy_balancer via the web GUI created by the balancer_manager directive
 test_files: 
 - test/test_amphibian.rb
 - test/test_helper.rb