dhill-sprinkle 0.3.3.1

data/.gitignore

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

data/CREDITS

@@ -0,0 +1,33 @@
+= CREDITS
+
+Many thanks to the following people who have submitted ideas, patches, helped with testing
+and/or generally provided support to Sprinkle, I really appreciate your help:
+
+Kristin Baumann        (http://crafterm.net/kristin/blog/)
+Ben Schwarz            (http://germanforblack.com/)
+Jim Freeze             (http://www.artima.com/rubycs/articles/ruby_as_dslP.html)
+Matthew Tanase         (http://www.slicehost.com)
+Jared Kuolt            (http://www.slicehost.com)
+Jamis Buck             (http://www.capify.org)
+Matt Allen             (http://blog.allen.com.au)
+Eric Hodel             (http://blog.segment7.net)
+Pete Yandell           (http://notahat.com)
+Adam Meehan            (http://duckpunching.com)
+Mitchell Hashimoto     (http://mitchellhashimoto.com)
+Ari Lerner             (http://www.citrusbyte.com)
+Jorgen Orehøj Erichsen (http://blog.erichsen.net)
+Joshua Sierles         (http://diluvia.net)
+Julian Russell         (http://github.com/plusplus)
+Dave (Gassto)          (http://github.com/gassto)
+Bodaniel Jeanes        (http://bjeanes.github.com)
+Jacob Harris           (http://open.nytimes.com)
+Justin Pease           (http://jit.nuance9.com)
+Tobias Lütke           (http://blog.leetsoft.com)
+Josh Reynolds          (http://github.com/jreynolds)
+Jan Ulbrich            (http://www.ulbrich.net)
+Chris Gaffney          (http://github.com/gaffneyc)
+Maxmpz                 (http://github.com/maxmpz)
+Geoff Garside          (http://geoffgarside.co.uk/)
+Oliver Kiessler        (http://inceedo.com)
+
+The transfer installer contains a piece of exception reporting code copied from the Chef library (http://wiki.opscode.com/display/chef/Home)

data/Gemfile

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

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Marcus Crafter
+
+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.markdown

@@ -0,0 +1,242 @@
+# SPRINKLE
+
+* <http://redartisan.com/2008/5/27/sprinkle-intro>
+* <http://github.com/crafterm/sprinkle>
+* <http://github.com/benschwarz/passenger-stack>
+* <http://github.com/trevorturk/sprinkle-packages>
+* <http://www.vimeo.com/2888665>
+* <http://redartisan.lighthouseapp.com/projects/25275-sprinkle/tickets>
+
+## DESCRIPTION:
+
+Sprinkle is a software provisioning tool you can use to build remote servers with, after the base operating
+system has been installed. For example, to install a Rails or Merb stack on a brand new slice directly after
+its been created.
+
+Properties of packages such as their name, type, dependencies, etc, and what packages apply to what machines
+is described via a domain specific language that Sprinkle executes (in fact one of the aims of Sprinkle is to
+define as concisely as possible a language for installing software).
+
+An example package description follows:
+
+    package :ruby do
+      description 'Ruby Virtual Machine'
+      version '1.8.6'
+      source "ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-#{version}-p111.tar.gz"
+      requires :ruby_dependencies
+
+      verify do
+        has_file '/usr/bin/ruby'
+      end
+    end
+
+This defines a package called 'ruby', that uses the source based installer to build Ruby 1.8.6 from source,
+installing the package 'ruby_dependencies' beforehand. Additionally, the package verifies it was installed
+correctly by verifying the file '/usr/bin/ruby' exists after installation. If this verification fails, the
+sprinkle script will gracefully stop.
+
+Reasonable defaults are set by sprinkle, such as the install prefix, download area, etc, but can be customized
+globally or per package (see below for an example).
+
+Since packages come in many forms (eg. gems, pre-compiled debs, compressed source tar.gz, etc), Sprinkle supports
+many different installer types, giving you the most amount of flexibility of how you'd like software installed.
+New installer types can be added into the system easily.
+
+For example, you could install Rails via gems, nginx via source, and mysql via APT, while retaining the flexibility
+of changing installer types as software is updated upstream.
+
+Sprinkle also supports dependencies between packages, allowing you specify pre-requisites that need to be
+installed in order.
+
+Packages can be grouped into polices to define several packages that should be installed together.
+
+An example policy:
+
+    policy :rails, :roles => :app do
+      requires :rails, :version => '2.1.0'
+      requires :appserver
+      requires :database
+      requires :webserver
+    end
+
+This defines a policy called Rails, that applies to machines of role :app. The policy includes the packages
+rails (version 2.1.0), appserver, database and webserver.
+
+appserver, database and webserver can be virtual packages, where the user will be prompted for selection if
+multiple choices for the virtual package exist.
+
+Sprinkle is architected to be extendable in many ways, one of those areas is in its deployment of commands to
+remote hosts. Currently Sprinkle supports the use of Capistrano, Vlad, or a direct net/ssh connection to
+issue commands on remote hosts via ssh, but could also be extended to use any other command transport mechanism
+desired. Sprinkle can also be configured to simply issue installation commands to provision the local system.
+
+An full example Sprinkle deployment script for deploying Rails (via gems), MySQL (via APT), Apache (via source)
+and Git (via source with dependencies from APT):
+
+    # Sprinkle Rails deployment script
+    #
+    # This is an example Sprinkle script, configured to install Rails from gems, Apache, Ruby and Git from source,
+    # and mysql and Git dependencies from apt on an Ubuntu system. Installation is configured to run via
+    # Capistrano (and an accompanying deploy.rb recipe script). Source based packages are downloaded and built into
+    # /usr/local on the remote system.
+    #
+    # A sprinkle script is separated into 3 different sections. Packages, policies and deployment.
+    #
+    # Packages
+    #
+    #  Defines the world of packages as we know it. Each package has a name and
+    #  set of metadata including its installer type (eg. apt, source, gem, etc). Packages can have
+    #  relationships to each other via dependencies
+    #
+    # Policies
+    #
+    #  Names a group of packages (optionally with versions) that apply to a particular set of roles.
+    #
+    # Deployment
+    #
+    #  Defines script wide settings such as a delivery mechanism for executing commands on the target
+    #  system (eg. capistrano), and installer defaults (eg. build locations, etc).
+
+    # Packages
+
+    package :ruby do
+      description 'Ruby Virtual Machine'
+      version '1.8.6'
+      source "ftp://ftp.ruby-lang.org/pub/ruby/1.8/ruby-#{version}-p111.tar.gz"
+      requires :ruby_dependencies
+    end
+
+    package :ruby_dependencies do
+      description 'Ruby Virtual Machine Build Dependencies'
+      apt %w( bison zlib1g-dev libssl-dev libreadline5-dev libncurses5-dev file )
+    end
+
+    package :mysql, :provides => :database do
+      description 'MySQL Database'
+      apt %w( mysql-server mysql-client )
+    end
+
+    package :apache, :provides => :webserver do
+      description 'Apache 2 HTTP Server'
+      version '2.2.9'
+      source "http://apache.wildit.net.au/httpd/httpd-#{version}.tar.bz2" do
+        enable %w( mods-shared=all proxy proxy-balancer proxy-http rewrite cache headers ssl deflate so )
+        prefix "/opt/local/apache2-#{version}"
+        post :install, 'install -m 755 support/apachectl /etc/init.d/apache2', 'update-rc.d -f apache2 defaults'
+      end
+      requires :apache_dependencies
+    end
+
+    package :apache_dependencies do
+      description 'Apache 2 HTTP Server Build Dependencies'
+      apt %w( openssl libtool mawk zlib1g-dev libssl-dev )
+    end
+
+    package :rubygems do
+      description 'Ruby Gems Package Management System'
+      version '1.2.0'
+      source "http://rubyforge.org/frs/download.php/38646/rubygems-#{version}.tgz" do
+        custom_install 'ruby setup.rb'
+      end
+      requires :ruby
+    end
+
+    package :rails do
+      description 'Ruby on Rails'
+      gem 'rails'
+      version '2.1.0'
+    end
+
+    package :mongrel do
+      description 'Mongrel Application Server'
+      gem 'mongrel'
+      version '1.1.5'
+    end
+
+    package :mongrel_cluster, :provides => :appserver do
+      description 'Cluster Management for Mongrel'
+      gem 'mongrel_cluster' # :source => 'http://gems.github.com/' for alternate gem server
+      version '1.0.5'
+      requires :mongrel
+    end
+
+    package :git, :provides => :scm do
+      description 'Git Distributed Version Control'
+      version '1.5.6.3'
+      source "http://kernel.org/pub/software/scm/git/git-#{version}.tar.gz"
+      requires :git_dependencies
+    end
+
+    package :git_dependencies do
+      description 'Git Build Dependencies'
+      apt 'git', :dependencies_only => true
+    end
+
+    # Policies
+
+    # Associates the rails policy to the application servers. Contains rails, and surrounding
+    # packages. Note, appserver, database and webserver are all virtual packages defined above. If
+    # there's only one implementation of a virtual package, it's selected automatically, otherwise
+    # the user is requested to select which one to use.
+
+    policy :rails, :roles => :app do
+      requires :rails, :version => '2.1.0'
+      requires :appserver
+      requires :database
+      requires :webserver
+      requires :scm
+    end
+
+    # Deployment
+
+    # Configures sprinkle to use capistrano for delivery of commands to the remote machines (via
+    # the named 'deploy' recipe). Also configures 'source' installer defaults to put package gear
+    # in /usr/local
+
+    deployment do
+
+      # mechanism for deployment
+      delivery :capistrano do
+        recipes 'deploy'
+      end
+
+      # source based package installer defaults
+      source do
+        prefix   '/usr/local'           # where all source packages will be configured to install
+        archives '/usr/local/sources'   # where all source packages will be downloaded to
+        builds   '/usr/local/build'     # where all source packages will be built
+      end
+
+    end
+
+Please see the examples directory for more complete examples of Sprinkle deployment scripts, and also the Passenger Stack github page and video by Ben Schwarz (<http://github.com/benschwarz/passenger-stack> and <http://www.vimeo.com/2888665> respectively).
+
+Sprinkle is a work in progress and I'm excited to hear if anyone finds it useful - please feel free to
+comment, ask any questions, or send in any ideas, patches, bugs. All most welcome.
+
+Marcus Crafter <crafterm@redartisan.com>
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008-2009 Marcus Crafter <crafterm@redartisan.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/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/VERSION

@@ -0,0 +1 @@
+0.3.3.1

data/bin/sprinkle

@@ -0,0 +1,95 @@
+#!/usr/bin/env ruby
+#
+#  Created on 2008-3-11.
+#  Copyright (c) 2008. All rights reserved.
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+require 'optparse'
+
+# NOTE: the option -p/--path= is given as an example, and should probably be replaced in your application.
+
+OPTIONS = {}
+MANDATORY_OPTIONS = %w( path )
+
+ARGV.each do |arg|
+  ENV[$1] = $2 if arg =~ /^(\w+)=(.*)$/
+end
+
+parser = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+Sprinkle
+========
+
+http://github.com/crafterm/sprinkle
+
+Sprinkle is a software provisioning tool you can use to build remote servers with. eg. to
+install a Rails or Merb stack on a brand new slice directly after its been created. It uses
+a Ruby based domain specific language to describe packages and policies to determine what
+should be installed on particular systems.
+
+Please see http://github.com/crafterm/sprinkle/tree/master/README.txt for more information.
+
+Usage
+=====
+
+$> #{File.basename($0)} [options]
+
+Options are:
+BANNER
+  opts.separator ""
+  opts.on("-s", "--script=PATH", String,
+          "Path to a sprinkle script to run") { |v| OPTIONS[:path] = v }
+  opts.on("-t", "--test",
+          "Process but don't perform any actions") { |v| OPTIONS[:testing] = v }
+  opts.on("-v", "--verbose",
+          "Verbose output") { |v| OPTIONS[:verbose] = v }
+  opts.on("-c", "--cloud",
+          "Show powder cloud, ie. package hierarchy and installation order") { |v| OPTIONS[:cloud] = v }
+  opts.on("-f", "--force",
+          "Force installation of all packages even if it is detected that it has been previously installed") { |v| OPTIONS[:force] = v }
+  opts.on("-h", "--help",
+          "Show this help message.") { puts opts; exit }
+  opts.parse!(ARGV)
+
+  if MANDATORY_OPTIONS && MANDATORY_OPTIONS.find { |option| OPTIONS[option.to_sym].nil? }
+    puts opts; exit
+  end
+end
+
+def force_mode(options)
+  Sprinkle::OPTIONS[:force] = OPTIONS[:force] || false
+end
+
+def operation_mode(options)
+  Sprinkle::OPTIONS[:testing] = OPTIONS[:testing] || false
+end
+
+def powder_cloud(options)
+  Sprinkle::OPTIONS[:cloud] = OPTIONS[:cloud] || false
+end
+
+def verbosity(options)
+  Sprinkle::OPTIONS[:verbose] = OPTIONS[:verbose] || false
+end
+
+def log_level(options)
+  Object.logger.level = ActiveSupport::BufferedLogger::Severity::DEBUG if options[:verbose]
+end
+
+require File.dirname(__FILE__) + '/../lib/sprinkle'
+
+powder = OPTIONS[:path]
+raise "Sprinkle script is not readable: #{powder}" unless File.readable?(powder)
+
+force_mode(OPTIONS)
+operation_mode(OPTIONS)
+powder_cloud(OPTIONS)
+log_level(OPTIONS)
+verbosity(OPTIONS)
+
+Sprinkle::Script.sprinkle File.read(powder), powder

data/examples/packages/build_essential.rb

@@ -0,0 +1,9 @@
+## Special package, anything that defines a 'source' package means build-essential should be installed for Ubuntu
+
+package :build_essential do
+  description 'Build tools'
+  apt 'build-essential' do
+    # Update the sources and upgrade the lists before we build essentials
+    pre :install, ['aptitude update', 'aptitude safe-upgrade', 'aptitude full-upgrade']
+  end
+end

data/examples/packages/databases/mysql.rb

@@ -0,0 +1,13 @@
+package :mysql, :provides => :database do
+  description 'MySQL Database'
+  apt %w( mysql-server mysql-client libmysqlclient15-dev )
+end
+
+package :mysql_ruby_driver do
+  description 'Ruby MySQL database driver'
+  gem 'mysql' # :build_flags => "—with-mysql-config=/usr/local/mysql/bin/mysql_config"
+  
+  verify do
+    ruby_can_load 'mysql'
+  end
+end

data/examples/packages/databases/sqlite3.rb

@@ -0,0 +1,16 @@
+# Packages to install sqlite3 and the sqlite3 ruby driver.
+package :sqlite3, :provides => :database do
+  description 'SQLite3 database'
+  apt 'sqlite3'
+end
+
+package :sqlite3_ruby_driver do
+  description 'Ruby SQLite3 library.'
+  apt 'libsqlite3-dev libsqlite3-ruby1.8'
+  
+  requires :rubygems
+  
+  verify do
+    ruby_can_load 'sqlite3'
+  end
+end