paratele 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 Michel Martens and Damian Janowski
+
+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,106 @@
+TELE(1)
+
+NAME
+      tele -- Provisioning at a distance.
+
+SYNOPSIS
+      tele [-h] [-d path] (init|status|install)
+
+DESCRIPTION
+      Tele is a small provisioning framework that allows you to run bash
+      scripts on remote servers over SSH. It uses your own SSH, not a Ruby
+      version, so you can profit from your settings and public/private keys.
+
+      It uses the following directory structure to store the recipes and
+      configuration files:
+
+          .tele/layout.json
+          .tele/ssh_config
+          .tele/recipes/redis/status.sh
+          .tele/recipes/redis/install.sh
+          .tele/recipes/unicorn/status.sh
+          .tele/recipes/unicorn/install.sh
+
+      In the example, there are recipes for Redis and Unicorn. Please note that you are in
+      charge of creating them.
+
+      layout.json
+          The server layout, with the available roles and servers. Example:
+
+          {
+            "servers": {
+              "app-1": ["redis"],
+              "app-2": ["ruby", "unicorn"],
+              "app-3": ["ruby", "resque"]
+            }
+          }
+
+          The key "servers" stores a map of servers to roles. The keys can be
+          either hostnames declared in .tele/ssh_config or IP addresses.
+
+      ssh_config
+          Configuration file for the SSH connection. Check the SSH_CONFIG man
+          page for more information.
+
+      The following options are available:
+
+      -h
+          Display this help message.
+
+      -d path
+          Sets path as the directory where tele will search for scripts and
+          configuration files. You can also use the environment variable
+          TELE_HOME.
+
+      -v
+          Print output from servers for all roles, whether they succeed or
+          not. The default is to print output from servers only if a recipe
+          fails.
+
+      -q
+          Don't print output from servers locally.
+
+      init
+          Copies a .tele template to the current directory.
+
+      run command
+          Runs every <recipe>/<command>.sh script on the servers declared
+          in layout.json, in the specified order. The scripts must have an
+          exit status of 0 on success, otherwise it will be counted as failed.
+          If a recipe fails, no more recipes for that server will be executed.
+          
+
+USAGE
+      To provision two servers called `server1` and `server2` with Redis,
+      starting from scratch:
+
+          # Create the .tele directory.
+          $ tele init
+
+          # Create directories for the recipes.
+          $ mkdir -p .tele/recipes/redis
+
+          # Create install.sh script (ommited).
+
+          # Edit .tele/layout.json as follows:
+
+            {
+              "servers": {
+                "server1": ["redis"],
+                "server2": ["redis"]
+              }
+            }
+
+          # Edit .tele/ssh_config:
+
+            Host server1
+              Hostname 10.0.0.1
+
+            Host server2
+              Hostname 10.0.0.2
+
+          # Run tele install
+          $ tele run install
+
+INSTALLATION
+      $ gem install tele

data/Rakefile

@@ -0,0 +1,7 @@
+task :test do
+  require "cutest"
+
+  Cutest.run(Dir["test/tele.rb"])
+end
+
+task :default => :test

data/bin/tele

@@ -0,0 +1,140 @@
+#! /usr/bin/env ruby
+
+help = File.expand_path(File.join("..", "README"), File.dirname(__FILE__))
+
+if ARGV.empty?
+  exec "less #{help}"
+end
+
+require "clap"
+require "json"
+require "open3"
+
+def path(*parts)
+  File.expand_path(File.join(*parts), ENV["TELE_HOME"])
+end
+
+def ssh(server, script)
+  out, status = Open3.capture2e("ssh -T -F #{path("ssh_config")} #{server} < #{script}")
+  [out, status.exitstatus]
+end
+
+def layout
+  $layout ||= JSON.parse(File.read(path("layout.json")))
+end
+
+def servers
+  layout["servers"]
+end
+
+def recipe_script(recipe, command)
+  path("recipes", recipe, "#{command}.sh")
+end
+
+def run(server, recipe, command)
+  script = recipe_script(recipe, command)
+
+  if File.exist?(script)
+    ssh(server, script)
+  end
+end
+
+out = Module.new do
+  def self.server(name)
+    puts name
+  end
+
+  def self.error
+    puts "\033[01;31mERROR\033[00m"
+  end
+
+  def self.ok
+    puts "\033[01;32mOK\033[00m"
+  end
+
+  def self.missing
+    puts "\033[01;33mMISSING\033[00m"
+  end
+
+  def self.done
+    puts "\033[01;32mDONE\033[00m"
+  end
+
+  def self.unknown
+    puts "?"
+  end
+end
+
+###
+
+ENV["TELE_HOME"] ||= File.join(Dir.pwd, ".tele")
+
+verbosity = 1
+
+commands = Clap.run ARGV,
+  "-h" => lambda {
+    exec "less #{help}"
+  },
+  "-q" => lambda {
+    verbosity = 0
+  },
+  "-v" => lambda {
+    verbosity = 2
+  },
+  "-d" => lambda {|path|
+    ENV["TELE_HOME"] = File.join(Dir.pwd, path)
+  }
+
+Clap.run commands,
+  "init" => lambda {
+    source = File.expand_path("../templates/.tele", File.dirname(__FILE__))
+    target = File.expand_path(Dir.pwd)
+
+    %x{cp -r #{source} #{target}}
+    out.done
+  }
+
+unless File.directory?(path)
+  $stderr.puts "Couldn't find a .tele directory"
+  exit 1
+end
+
+Clap.run commands,
+  "run" => lambda {|command|
+    if commands.size == 3
+      selected = commands.last.split(",")
+      servers.select! {|server| selected.include?(server)}
+    end
+
+    exit_status = 0
+
+    servers.each do |server, recipes|
+      out.server(server)
+
+      recipes.each do |recipe|
+        print "  #{recipe}: "
+
+        if File.exists?(path("recipes", recipe))
+          stdout, status = run(server, recipe, command)
+
+          case status
+          when nil
+            out.unknown
+          when 0
+            out.ok
+            $stderr.print stdout if verbosity >= 2
+          else
+            out.error
+            $stderr.print stdout if verbosity >= 1
+            exit_status = 1
+            break
+          end
+        else
+          out.unknown
+          exit 1
+        end
+      end
+    end
+
+    exit exit_status
+  }

data/paratele.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |s|
+  s.name              = "paratele"
+  s.version           = "0.0.1"
+  s.summary           = "Provisioning at a distance"
+  s.description       = "Tele is a small provisioning framework that allows you to run bash scripts on remote servers over SSH."
+  s.authors           = ["Damian Janowski", "Michel Martens"]
+  s.email             = ["djanowski@dimaion.com", "michel@soveran.com"]
+  s.homepage          = "http://github.com/djanowski/tele"
+
+  s.executables.push("tele")
+
+  s.add_dependency("clap")
+
+  s.files = ["LICENSE", "README", "Rakefile", "bin/tele", "templates/.tele/layout.json", "templates/.tele/ssh_config", "paratele.gemspec", "tele.gemspec", "test/tele.rb"]
+end

data/tele.gemspec

@@ -0,0 +1,15 @@
+Gem::Specification.new do |s|
+  s.name              = "tele"
+  s.version           = "0.0.1"
+  s.summary           = "Provisioning at a distance"
+  s.description       = "Tele is a small provisioning framework that allows you to run bash scripts on remote servers over SSH."
+  s.authors           = ["Damian Janowski", "Michel Martens"]
+  s.email             = ["djanowski@dimaion.com", "michel@soveran.com"]
+  s.homepage          = "http://github.com/djanowski/tele"
+
+  s.executables.push("tele")
+
+  s.add_dependency("clap")
+
+  s.files = ["LICENSE", "README", "Rakefile", "bin/tele", "templates/.tele/layout.json", "templates/.tele/ssh_config", "tele.gemspec", "test/tele.rb"]
+end

data/templates/.tele/layout.json

@@ -0,0 +1,9 @@
+{
+  "roles": {
+
+  },
+
+  "servers": {
+
+  }
+}

data/test/tele.rb

@@ -0,0 +1,126 @@
+require "shellwords"
+require "open3"
+
+ROOT = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+
+def root(*args)
+  File.join(ROOT, *args)
+end
+
+def tele(*args)
+  sh("ruby #{root "bin/tele"} #{Shellwords.join args}")
+end
+
+def sh(cmd)
+  Open3.capture3(cmd)
+end
+
+prepare do
+  `rm -rf /tmp/tele`
+  `mkdir /tmp/tele`
+end
+
+test "`tele run` without a config" do
+  out, err, status = tele("run", "install")
+
+  assert err =~ /Couldn't find/
+  assert_equal 1, status.exitstatus
+end
+
+test "`tele run` with missing recipes" do
+  out, err, status = tele("run", "deploy", "-d", "test/.tele.missing-recipes")
+
+  assert_equal 1, status.exitstatus
+  assert out =~ /db-1/
+  assert out =~ /redis: .*\?/
+  assert out !~ /cassandra: .*\?/
+end
+
+test "`tele run` successful" do
+  out, err, status = tele("run", "install", "-d", "test/.tele.simple")
+
+  assert_equal 0, status.exitstatus
+  assert out =~ /db-1/
+  assert out =~ /db-2/
+  assert out =~ /redis: .*OK/
+  assert out =~ /cdb: .*OK/
+  assert out =~ /cassandra: .*OK/
+end
+
+test "`tele run` with recipes missing a command" do
+  out, err, status = tele("run", "status", "-d", "test/.tele.simple")
+
+  assert_equal 0, status.exitstatus
+  assert out =~ /cassandra: .*\?/
+  assert out =~ /cdb: .*OK/
+  assert out =~ /redis: .*OK/
+end
+
+test "`tele run` with errors" do
+  out, err, status = tele("run", "update", "-d", "test/.tele.simple")
+
+  assert_equal 1, status.exitstatus
+
+  assert out =~ /db-1/
+  assert out =~ /cassandra: .*ERROR/
+  assert err =~ /Updating Cassandra failed/
+  assert out !~ /cdb:/
+
+  assert out =~ /db-2/
+  assert out =~ /redis: .*OK/
+end
+
+test "`tele run` with specific server" do
+  out, err, status = tele("run", "install", "db-2", "-d", "test/.tele.simple")
+
+  assert_equal 0, status.exitstatus
+  assert out !~ /db-1/
+  assert out !~ /cassandra/
+  assert out !~ /cdb/
+  assert out =~ /db-2/
+  assert out =~ /redis/
+end
+
+test "`tele run` with multiple server" do
+  out, err, status = tele("run", "install", "db-2,db-1", "-d", "test/.tele.simple")
+
+  assert_equal 0, status.exitstatus
+  assert out =~ /db-1/
+  assert out =~ /db-2/
+end
+
+test "`tele run -v`" do
+  out, err, status = tele("run", "update", "-v", "-d", "test/.tele.simple")
+
+  assert err =~ /Redis succesfully updated/
+  assert err =~ /Updating Cassandra failed/
+  assert out !~ /Redis succesfully updated/
+  assert out !~ /Updating Cassandra failed/
+end
+
+test "`tele run -q`" do
+  out, err, status = tele("run", "update", "-q", "-d", "test/.tele.simple")
+
+  assert err !~ /Redis succesfully updated/
+  assert err !~ /Updating Cassandra failed/
+  assert out !~ /Redis succesfully updated/
+  assert out !~ /Updating Cassandra failed/
+end
+
+__END__
+
+test "`tele init`" do
+  `rm -rf test/tmp`
+  `mkdir test/tmp`
+
+  assert !File.exists?("test/tmp/.tele")
+
+  Dir.chdir("test/tmp") do
+    out, err = tele("init")
+
+    assert File.exists?(".tele")
+
+    out, err, status = tele("status")
+    assert status.exitstatus == 0
+  end
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification 
+name: paratele
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Damian Janowski
+- Michel Martens
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-09 00:00:00 -03:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: clap
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Tele is a small provisioning framework that allows you to run bash scripts on remote servers over SSH.
+email: 
+- djanowski@dimaion.com
+- michel@soveran.com
+executables: 
+- tele
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- README
+- Rakefile
+- bin/tele
+- templates/.tele/layout.json
+- templates/.tele/ssh_config
+- paratele.gemspec
+- tele.gemspec
+- test/tele.rb
+has_rdoc: true
+homepage: http://github.com/djanowski/tele
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Provisioning at a distance
+test_files: []
+