dynect-utils 0.0.1

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+.bundle
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in dynect-utils.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,26 @@
+PATH
+  remote: .
+  specs:
+    dynect-utils (0.0.1)
+      dynect_rest
+      trollop
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    dynect_rest (0.4.0)
+      json
+      json
+      rest-client
+      rest-client
+    json (1.6.5)
+    mime-types (1.17.2)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    trollop (1.16.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  dynect-utils!

data/README.md

@@ -0,0 +1,71 @@
+# dynect-utils
+
+This is a set of utilities that use the
+[DynECT](http://dyn.com/dns/dynect-managed-dns/) REST API to help
+monitor and manage the service.
+
+## Nagios plugin: check_dynect_gslb_region
+
+Checks the health-check status of the addresses in a GSLB region's pool.
+
+Usage:
+
+    Options:
+      --customer, -c <s>:   Dynect customer name
+          --user, -u <s>:   Dynect user name
+          --pass, -p <s>:   Dynect password
+          --zone, -z <s>:   Zone name
+        --record, -r <s>:   GSLB record name
+        --region, -R <s>:   GSLB region (default: global)
+              --help, -h:   Show this message
+
+Example output:
+
+    $ check_dynect_gslb_region -c Customer -u user -p pass123 -z example.org -r foo.example.org
+    OK: all GSLB addresses are healthy
+
+    $ check_dynect_gslb_region -c Customer -u user -p pass123 -z example.org -r bar.example.org
+    CRITICAL: GSLB addresses unhealthy: 1.2.3.4=down
+
+## Utility: dynect_gslb_manage
+
+Drains/undrains a specific address in a GSLB region's pool.
+
+Usage:
+
+    Usage: dynect_gslb_manage [options] command [command opts]
+
+    Possible sub-commands:
+
+      list
+        List all GSLB IPs
+
+      drain <address|label>
+        Set the serving mode to "no" for a GSLB address, identified by IP
+        address or label.
+
+      undrain <address|label>
+        Set the serving mode to "obey" for a GSLB address, identified by IP
+        address or label.
+
+    Main options:
+
+      --customer, -c <s>:   Dynect customer name
+          --user, -u <s>:   Dynect user name
+          --pass, -p <s>:   Dynect password
+          --zone, -z <s>:   Zone name
+        --record, -r <s>:   GSLB record name
+        --region, -R <s>:   GSLB region (default: global)
+              --help, -h:   Show this message
+
+Example output:
+
+    $ dynect_gslb_manage -c Customer -u user -p pass123 -z example.org -r foo.example.org list
+    foo-backend-1 | 1.2.3.4 | status=up | weight=1 | serve_mode=obey
+    foo-backend-2 | 1.2.3.5 | status=up | weight=1 | serve_mode=obey
+
+    $ dynect_gslb_manage -c Customer -u user -p pass123 -z example.org -r foo.example.org drain foo-backend-1
+    1.2.3.4 serve_mode changed from obey to no
+
+    $ dynect_gslb_manage -c Customer -u user -p pass123 -z example.org -r foo.example.org undrain foo-backend-1
+    1.2.3.4 serve_mode changed from no to obey

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/check_dynect_gslb_region

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+# Nagios plugin to monitor the status of IP addresses in a GSLB region.
+
+require "rubygems"
+require "bundler/setup"
+
+require "dynect_rest"
+require "trollop"
+
+progname = File.basename($0)
+
+opts = Trollop::options do
+  opt :customer, "Dynect customer name", :short => "-c", :type => :string,
+      :required => true
+  opt :user, "Dynect user name", :short => "-u", :type => :string,
+      :required => true
+  opt :pass, "Dynect password", :short => "-p", :type => :string,
+      :required => true
+  opt :zone, "Zone name", :short => "-z", :type => :string,
+      :required => true
+  opt :record, "GSLB record name", :short => "-r", :type => :string,
+      :required => true
+  opt :region, "GSLB region", :short => "-R", :type => :string,
+      :default => "global"
+end
+
+dyn = DynectRest.new(opts[:customer], opts[:user], opts[:pass], opts[:zone])
+gslb = dyn.get("GSLB/#{opts[:zone]}/#{opts[:record]}")
+
+region = gslb["region"].select { |r| r["region_code"] == opts[:region] }.first
+if region.nil?
+  puts "UNKNOWN: can't find region #{region}"
+  exit 3
+end
+
+down = {}
+region["pool"].each do |address|
+  if address["status"] != "up"
+    down[address["address"]] = address["status"]
+  end
+end
+
+if down.length > 0
+  msg = down.collect { |addr, status| "#{addr}=#{status}" }.join("; ")
+  puts "CRITICAL: GSLB addresses unhealthy: #{msg}"
+  exit 2
+end
+
+puts "OK: all GSLB addresses are healthy"
+exit 0

data/bin/dynect_gslb_manage

@@ -0,0 +1,84 @@
+#!/usr/bin/env ruby
+# Nagios plugin to monitor the status of IP addresses in a GSLB region.
+
+require "rubygems"
+require "bundler/setup"
+
+require "dynect_rest"
+require "trollop"
+
+progname = File.basename($0)
+
+opts = Trollop::options do
+  banner <<-EOF
+Usage: #{progname} [options] command [command opts]
+
+Possible sub-commands:
+
+  list
+    List all GSLB IPs
+
+  drain <address|label>
+    Set the serving mode to "no" for a GSLB address, identified by IP
+    address or label.
+
+Main options:
+EOF
+  banner ""
+
+  opt :customer, "Dynect customer name", :short => "-c", :type => :string,
+      :required => true
+  opt :user, "Dynect user name", :short => "-u", :type => :string,
+      :required => true
+  opt :pass, "Dynect password", :short => "-p", :type => :string,
+      :required => true
+  opt :zone, "Zone name", :short => "-z", :type => :string,
+      :required => true
+  opt :record, "GSLB record name", :short => "-r", :type => :string,
+      :required => true
+  opt :region, "GSLB region", :short => "-R", :type => :string,
+      :default => "global"
+
+end
+
+dyn = DynectRest.new(opts[:customer], opts[:user], opts[:pass], opts[:zone])
+
+command = ARGV.shift
+
+pool = dyn.get("GSLBRegionPoolEntry/#{opts[:zone]}/#{opts[:record]}/#{opts[:region]}/").collect { |p| p.sub("/REST/", "") }
+
+# Takes an IP or label.
+def find_address(dyn, pool, match)
+  pool.each do |path|
+    entry = dyn.get(path)
+    if entry["label"] == match or entry["address"] == match
+      return path, entry
+    end
+  end
+
+  raise "can't find GSLB entry with address or label matching #{match}"
+end
+
+case command
+when "list"
+  pool.each do |path|
+    entry = dyn.get(path)
+    puts "#{entry["label"]} | #{entry["address"]} | " \
+         "status=#{entry["status"]} | weight=#{entry["weight"]} | " \
+         "serve_mode=#{entry["serve_mode"]}"
+  end
+when "drain", "undrain"
+  match = ARGV.shift
+  if !match
+    Trollop::die "must specify an address to drain"
+  end
+  path, entry = find_address(dyn, pool, match)
+  serve_mode = (command == "drain") ? "no" : "obey"
+  res = dyn.put(path, {"serve_mode" => serve_mode})
+  puts "#{entry["address"]} serve_mode changed from #{entry["serve_mode"]} " \
+       "to #{res["serve_mode"]}"
+when nil
+  Trollop::die "must specify a command"
+else
+  Trollop::die "invalid command #{command}"
+end

data/dynect-utils.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "dynect-utils"
+  s.version     = "0.0.1"
+  s.authors     = ["Pete Fritchman"]
+  s.email       = ["petef@databits.net"]
+  s.homepage    = "https://github.com/fetep/dynect-utils"
+  s.summary     = %q{Utilities to interact with the DynECT API}
+  s.description = %q{
+Utilities included: nagios plugin to check GSLB status, tool to manipulate
+the serving mode of GSLB addresses
+}
+
+  s.rubyforge_project = "dynect-utils"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "dynect_rest"
+  s.add_runtime_dependency "trollop"
+end

metadata

@@ -0,0 +1,105 @@
+--- !ruby/object:Gem::Specification 
+name: dynect-utils
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Pete Fritchman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-03-07 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: dynect_rest
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: trollop
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: |
+  
+  Utilities included: nagios plugin to check GSLB status, tool to manipulate
+  the serving mode of GSLB addresses
+
+email: 
+- petef@databits.net
+executables: 
+- check_dynect_gslb_region
+- dynect_gslb_manage
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/check_dynect_gslb_region
+- bin/dynect_gslb_manage
+- dynect-utils.gemspec
+homepage: https://github.com/fetep/dynect-utils
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: dynect-utils
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Utilities to interact with the DynECT API
+test_files: []
+