deprec 0.0.1 → 1.1.0

data/lib/deprec/third_party/vmbuilder/plugins.rb

@@ -0,0 +1,8 @@
+# plugins.rb: Load all the Capistrano Plugins in the plugins directory.
+
+require 'rubygems'
+
+# Load plugins from the plugins directory
+Dir["#{File.dirname(__FILE__)}/plugins/*.rb"].sort.each do |plugin|
+  load plugin
+end

data/lib/deprec/third_party/vmbuilder/plugins/apt.rb

@@ -0,0 +1,144 @@
+# =apt.rb: Debian 'apt' Installer library
+# Capistrano task library to install and manage apt packages
+#
+# ----
+# Copyright (c) 2006 Neil Wilson, Aldur Systems Ltd
+#
+# Licensed under the GNU Public License v2. No warranty is provided.
+
+require 'capistrano'
+
+# = Purpose
+# Apt is a Capistrano plugin module providing a set of methods
+# that invoke the *apt* package manager (as used in Debian and Ubuntu)
+#
+# Installs within Capistrano as the plugin _apt_.
+#
+# =Usage
+#    
+#    require 'vmbuilder/plugins/apt'
+#
+# Prefix all calls to the library with <tt>apt.</tt>
+#
+module Apt 
+
+  # Default apt-get command - reduces any interactivity to the minimum.
+  APT_GET="DEBCONF_TERSE='yes' DEBIAN_PRIORITY='critical' DEBIAN_FRONTEND=noninteractive apt-get" 
+
+  # Default list of packages required to extract source packages.
+  BACKPORT_REQUIRED={:base => %w(dpkg-dev debhelper devscripts fakeroot)}
+
+  # Directory where any package compilation takes place.
+  BUILD_DIR="/var/cache/backport/build"
+
+  # Run the apt install program across the package list in 'packages'. 
+  # Select those packages referenced by <tt>:base</tt> and the +version+
+  # of the distribution you want to use.
+  def install(packages, version, options={})
+    special_options="--allow-unauthenticated" if version != :stable
+    cmd = <<-CMD
+    sh -c "#{APT_GET} -qyu #{special_options.to_s} install #{package_list(packages, version)}"
+    CMD
+    sudo(cmd, options)
+  end
+
+  # Run an apt autoclean
+  def autoclean(options={})
+    cmd = <<-CMD
+      sh -c "#{APT_GET} -qy autoclean"
+    CMD
+    sudo(cmd, options)
+  end
+
+  # Run an apt distribution upgrade
+  def dist_upgrade(options={})
+    cmd = <<-CMD
+      sh -c "#{APT_GET} -qy dist-upgrade"
+    CMD
+    sudo(cmd, options)
+  end
+
+  # Run an apt upgrade. Use dist_upgrade instead if you want to upgrade
+  # the critical base packages.
+  def upgrade(options={})
+    cmd = <<-CMD
+      sh -c "#{APT_GET} -qy upgrade"
+    CMD
+    sudo(cmd, options)
+  end
+
+  # Run an apt update.
+  def update(options={})
+    cmd = <<-CMD
+      sh -c "#{APT_GET} -qy update"
+    CMD
+    sudo(cmd, options)
+  end
+
+  # Update the apt control files using the files from the machine
+  # which is running Capistrano. Set the default version to +version+
+  def update_apt(version, myopts={})
+    apt_fname="/etc/apt/apt.conf"
+    sources_fname="/etc/apt/sources.list"
+    pref_fname="/etc/apt/preferences"
+    std.su_put("APT::Default-Release \"#{version.to_s}\";\n"+apt_conf, apt_fname, "/tmp", myopts)
+    std.su_put(sources, sources_fname, "/tmp", myopts)
+    std.su_put(preferences, pref_fname, '/tmp', myopts) 
+  end
+
+  # Downloads the specified source module and the quoted dependencies 
+  # Compiles the module and installs it.
+  #
+  # If no dependencies are specified, runs an apt build-dep on the stable
+  # package list in an attempt to locate them automatically.
+  # 
+  # Alter the <tt>deb-src</tt> line in <tt>sources.list</tt> file to
+  # determine which distribution source files are retrieved from.
+  def backport_to_stable(packages, dependencies={})
+    install(BACKPORT_REQUIRED, :stable)
+    if dependencies.empty?
+      sudo <<-CMD
+	sh -c "#{APT_GET} -qyu build-dep #{package_list(packages, :stable)}"
+      CMD
+    else
+      install(dependencies, :stable)
+    end
+    patch_gcc
+    sudo <<-SUDO
+      sh -c "[ -d #{BUILD_DIR} ] || { mkdir -p #{BUILD_DIR} && chown #{user || ENV['USER']} #{BUILD_DIR}; }"
+    SUDO
+    sudo <<-CMD
+      sh -c "cd #{BUILD_DIR} &&
+      if [ ! -f `apt-get --print-uris source #{package_list(packages, :stable)}| tail -n1 | cut -d' ' -f2` ]; then
+	#{APT_GET} -qyub source #{package_list(packages, :stable)};
+      fi;"
+    CMD
+    sudo "dpkg -i #{BUILD_DIR}/*.deb"
+  end
+
+  # Boot script manipulation command
+  def rc_conf(packages, setting)
+    packages.each do |service|
+      sudo "sysv-rc-conf --level 2 #{service} #{setting}"
+    end
+  end
+
+private
+
+  # Provides a string containing all the package names in the base
+  #list plus those in +version+.
+  def package_list(packages, version)
+    packages[:base].to_a.join(' ') + ' ' + packages[version].to_a.join(' ')
+  end
+
+  # Stable likes to use gcc3.3. Force it to use 3.4 if it is installed.
+  def patch_gcc
+    sudo <<-CMD
+      sh -c "[ ! -f /usr/bin/gcc-3.4 ] || ln -sf /usr/bin/gcc-3.4 /usr/local/bin/gcc"
+    CMD
+  end
+
+end
+
+Capistrano.plugin :apt, Apt
+# vim: nowrap sw=2 sts=2 ts=8 ff=unix ft=ruby:

data/lib/deprec/third_party/vmbuilder/plugins/gem.rb

@@ -0,0 +1,97 @@
+# =gem.rb: Gem Installer library
+# Capistrano library to install and manage Ruby Gems.
+# 
+# ----
+# Copyright (c) 2006 Neil Wilson, Aldur Systems Ltd
+#
+# Licensed under the GNU Public License v2. No warranty is provided.
+
+require 'capistrano'
+
+# = Purpose
+# Gem is a Capistrano plugin module providing a set of methods
+# that invoke the *gem* package manager.
+#
+# Installs within Capistrano as the plugin _gem_.
+#
+# =Usage
+#    
+#    require 'vmbuilder/plugins/gem'
+#
+# Prefix all calls to the library with <tt>gem.</tt>
+#
+module Gem
+
+  # Default install command
+  #
+  # * doesn't install documentation
+  # * installs all required dependencies automatically.
+  #
+  GEM_INSTALL="gem install -y --no-rdoc --no-ri"
+
+  # Upgrade the *gem* system to the latest version. Runs via *sudo*
+  def update_system
+    sudo "gem update --system"
+  end
+
+  # Updates all the installed gems to the latest version. Runs via *sudo*.
+  # Don't use this command if any of the gems require a version selection.
+  def upgrade
+    sudo "gem update --no-rdoc"
+  end
+
+  # Removes old versions of gems from installation area.
+  def cleanup
+    sudo "gem cleanup" 
+  end
+
+  # Installs the gems detailed in +packages+, selecting version +version+ if
+  # specified.
+  #
+  # +packages+ can be a single string or an array of strings.
+  #  
+  def install(packages, version=nil)
+    sudo "#{GEM_INSTALL} #{if version then '-v '+version.to_s end} #{packages.to_a.join(' ')}"
+  end
+
+  # Auto selects a gem from a list and installs it.
+  #
+  # *gem* has no mechanism on the command line of disambiguating builds for
+  # different platforms, and instead asks the user. This method has the necessary
+  # conversation to select the +version+ relevant to +platform+ (or the one nearest
+  # the top of the list if you don't specify +version+).
+  def select(package, version=nil, platform='ruby')
+    selections={}
+    cmd="#{GEM_INSTALL} #{if version then '-v '+version.to_s end} #{package}"
+    sudo cmd do |channel, stream, data|
+      data.each_line do | line |
+	case line
+	when /\s(\d+).*\(#{platform}\)/
+	  if selections[channel[:host]].nil?
+	    selections[channel[:host]]=$1.dup+"\n"
+	    logger.info "Selecting #$&", "#{stream} :: #{channel[:host]}"
+	  end
+	when /\s\d+\./
+	  # Discard other selections from data stream
+	when /^>/
+	  channel.send_data selections[channel[:host]]
+	  logger.debug line, "#{stream} :: #{channel[:host]}"
+	else
+	  logger.info line, "#{stream} :: #{channel[:host]}"
+	end
+      end
+    end
+  end
+
+  #def gem_select(package, version, platform='ruby')
+  #  sudo <<-CMD
+  #    sh -c "#{GEM_INSTALL} -v #{version} #{package} </dev/null 2>&1|
+#	    sed -ne '/(#{platform})/s/ \\([0-9][0-9]*\\).*/\\1/p' |
+#	    #{GEM_INSTALL} -v #{version} #{package}"
+#    CMD
+#  end
+
+end
+
+Capistrano.plugin :gem, Gem
+# vim: nowrap sw=2 sts=2 ts=8 ff=unix ft=ruby:

data/lib/deprec/third_party/vmbuilder/plugins/std.rb

@@ -0,0 +1,153 @@
+# =std.rb: Capistrano Standard Methods
+# Standard library of procedures and functions that you can use with Capistrano.
+# 
+# ----
+# Copyright (c) 2006 Neil Wilson, Aldur Systems Ltd
+#
+# Licensed under the GNU Public License v2. No warranty is provided.
+
+require 'capistrano'
+
+# = Purpose
+# Std is a Capistrano plugin that provides a set of standard methods refactored
+# out of several Capistrano task libraries.
+#
+# Installs within Capistrano as the plugin _std_
+#
+# = Usage
+#
+#    require 'vmbuilder/plugins/std'
+#
+# Prefix all calls to the library with <tt>std.</tt>
+module Std
+
+  begin
+    # Use the Mmap class if it is available
+    # http://moulon.inra.fr/ruby/mmap.html    
+    require 'mmap'
+    MMAP=true #:nodoc:
+  rescue LoadError
+    # no MMAP class, use normal reads instead
+    MMAP=false #:nodoc:
+  end
+
+  # Copies the files specified by +file_pattern+ to +destination+
+  #
+  # Error checking is minimal - a pattern onto a single file will result in +destination+
+  # containing the data from the last file only.
+  #
+  # Installs via *sudo*,  +options+ are as for *put*.
+  def fput(file_pattern, destination, options={})
+    logger.info file_pattern
+    Dir.glob(file_pattern) do |fname|
+      logger.info fname
+      if File.readable?(fname) then
+	if MMAP
+	  logger.debug "Using Memory Mapped File Upload"
+	  fdata=Mmap.new(fname,"r", Mmap::MAP_SHARED, :advice => Mmap::MADV_SEQUENTIAL)
+        else
+	  fdata=File.open(fname).read
+	end
+	su_put(fdata, destination, File.join('/tmp',File.basename(fname)), options)
+      end
+    end
+  end
+
+  # Upload +data+ to +temporary_area+ before installing it in
+  # +destination+ using sudo.
+  #
+  # +options+ are as for *put*
+  #
+  def su_put(data, destination, temporary_area='/tmp', options={})
+    temporary_area = File.join(temporary_area,File.basename(destination)) if File.directory?(temporary_area)
+    put(data, temporary_area, options)
+    sudo <<-CMD
+      sh -c "install -m#{sprintf("%3o",options[:mode]||0755)} #{temporary_area} #{destination} &&
+      rm -f #{temporary_area}"
+    CMD
+  end
+  
+  # Copies the +file_pattern+, which is assumed to be a tar
+  # file of some description (gzipped or plain), and unpacks it into
+  # +destination+.
+  def unzip(file_pattern, destination, options={})
+    Dir.glob(file_pattern) do |fname|
+      if File.readable?(fname) then
+	target="/tmp/#{File.basename(fname)}"
+	if MMAP
+	  logger.debug "Using Memory Mapped File Upload"
+	  fdata=Mmap.new(fname,"r", Mmap::MAP_SHARED, :advice => Mmap::MADV_SEQUENTIAL)
+        else
+	  fdata=File.open(fname).read
+	end
+	put(fdata, target, options)
+	sudo <<-CMD
+	  sh -c "cd #{destination} &&
+	  zcat -f #{target} | tar xvf - &&
+	  rm -f #{target}"
+	CMD
+      end
+    end
+  end
+  
+  # Creates the directory +web_root_dir+ using sudo is +use_sudo+ is true.
+  #
+  # Makes the root directory manageble by the +control_group+ group and sets the
+  # permissions so that the directory is writeable by +control_group+ and the group
+  # remains _sticky_
+  #
+  def create_web_root(web_root_dir, control_group)
+    send run_method, <<-CMD
+      sh -c "[ -d #{web_root_dir} ] || mkdir -m2770 -p #{web_root_dir}"
+    CMD
+    send(run_method, "chgrp -c #{control_group} #{web_root_dir}")
+  end
+
+  # Wrap this around your task calls to catch the no servers error and
+  # ignore it
+  #    
+  #    std.ignore_no_servers_error do
+  #      activate_mysql
+  #    end
+  #    
+  def ignore_no_servers_error (&block)
+    begin
+      yield
+    rescue RuntimeError => failure
+      if failure.message =~ /no servers matched/
+	logger.debug "Ignoring 'no servers matched' error in task #{current_task.name}"
+      else
+	raise
+      end
+    end
+  end
+
+  # Wrap this around your task to force a connection as root.
+  #
+  #    std.connect_as_root do
+  #      install_sudo
+  #    end
+  #
+  def connect_as_root (&block)
+    begin
+      tempuser = user
+      set :user, "root"
+      yield tempuser
+    ensure
+      set :user, tempuser if tempuser
+    end
+  end
+
+  #Returns a random string of alphanumeric characters of size +size+
+  #Useful for passwords, usernames and the like.
+  def random_string(size=10)
+    s = ""
+    size.times { s << (i = rand(62); i += ((i < 10) ? 48 : ((i < 36) ? 55 : 61 ))).chr }
+    s
+  end
+
+end
+
+Capistrano.plugin :std, Std
+#
+# vim: nowrap sw=2 sts=2 ts=8 ff=unix ft=ruby:

data/resources/capistrano_include_dotfiles.patch

@@ -0,0 +1,17 @@
+Index: lib/capistrano/cli.rb
+===================================================================
+--- lib/capistrano/cli.rb	(revision 5636)
++++ lib/capistrano/cli.rb	(working copy)
+@@ -289,6 +289,12 @@
+       end
+ 
+       def look_for_default_recipe_file!
++        if File.exist?(system_defaults = '/etc/capistrano.conf') 
++          @options[:recipes] << system_defaults
++        end
++        if File.exist?(user_defaults = File.join(ENV['HOME'],'.caprc')) 
++          @options[:recipes] << user_defaults
++        end
+         DEFAULT_RECIPES.each do |file|
+           if File.exist?(file)
+             @options[:recipes] << file

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.8.11
 specification_version: 1
 name: deprec
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
-date: 2006-11-16 00:00:00 +11:00
+  version: 1.1.0
+date: 2006-11-30 00:00:00 +11:00
 summary: deployment recipes for capistrano
 require_paths: 
 - lib
@@ -13,7 +13,7 @@ homepage:
 rubyforge_project: 
 description: This project provides libraries of Capistrano tasks and extensions to  remove the repetative manual work associated with installing services  on linux servers.
 autorequire: 
-default_executable: 
+default_executable: deprec
 bindir: bin
 has_rdoc: false
 required_ruby_version: !ruby/object:Gem::Version::Requirement 
@@ -28,15 +28,58 @@ cert_chain:
 authors: []
 
 files: 
-- lib/deprec.rb
+- bin/deprec
+- bin/deprec_dotfiles
+- docs/building_edge_capistrano.txt
+- lib/deprec
+- lib/deprec/generators
+- lib/deprec/recipes
+- lib/deprec/recipes.rb
+- lib/deprec/third_party
+- lib/deprec/generators/deprec
+- lib/deprec/generators/loader.rb
+- lib/deprec/generators/deprec/deprec_generator.rb
+- lib/deprec/generators/deprec/templates
+- lib/deprec/generators/deprec/USAGE
+- lib/deprec/generators/deprec/templates/deploy.rb
+- lib/deprec/recipes/slicehost.rb
+- lib/deprec/recipes/ssh.rb
+- lib/deprec/recipes/svn.rb
+- lib/deprec/recipes/templates
+- lib/deprec/recipes/ubuntu.rb
+- lib/deprec/recipes/templates/test_template.rhtml
+- lib/deprec/third_party/mongrel_cluster
+- lib/deprec/third_party/railsmachine
+- lib/deprec/third_party/THIRD_PARTY_README
+- lib/deprec/third_party/vmbuilder
+- lib/deprec/third_party/mongrel_cluster/LICENSE
+- lib/deprec/third_party/mongrel_cluster/recipes.rb
+- lib/deprec/third_party/mongrel_cluster/resources
+- lib/deprec/third_party/mongrel_cluster/resources/mongrel_cluster
+- lib/deprec/third_party/railsmachine/LICENSE
+- lib/deprec/third_party/railsmachine/recipes
+- lib/deprec/third_party/railsmachine/recipes/apache.rb
+- lib/deprec/third_party/railsmachine/recipes/mysql.rb
+- lib/deprec/third_party/railsmachine/recipes/svn.rb
+- lib/deprec/third_party/railsmachine/recipes/templates
+- lib/deprec/third_party/railsmachine/recipes/templates/httpd-ssl.conf
+- lib/deprec/third_party/railsmachine/recipes/templates/httpd.conf
+- lib/deprec/third_party/vmbuilder/LICENSE
+- lib/deprec/third_party/vmbuilder/plugins
+- lib/deprec/third_party/vmbuilder/plugins.rb
+- lib/deprec/third_party/vmbuilder/plugins/apt.rb
+- lib/deprec/third_party/vmbuilder/plugins/gem.rb
+- lib/deprec/third_party/vmbuilder/plugins/std.rb
+- resources/capistrano_include_dotfiles.patch
 test_files: []
 
 rdoc_options: []
 
 extra_rdoc_files: []
 
-executables: []
-
+executables: 
+- deprec
+- deprec_dotfiles
 extensions: []
 
 requirements: []
@@ -51,3 +94,12 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 1.2.0
     version: 
+- !ruby/object:Gem::Dependency 
+  name: termios
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.4
+    version: