tannins 0.6

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "spec/rails"]
+	path = spec/rails
+	url = git@github.com:notch8/tannins-rails-fixture.git
+[submodule "spec/merb"]
+	path = spec/merb
+	url = git@github.com:notch8/tannins-merb-fixture.git

data/History.txt

@@ -0,0 +1,3 @@
+== 0.1.0 / 2008-08-21
+
+* First public release

data/README.txt

@@ -0,0 +1,87 @@
+tannins
+    by FIXME (your name)
+    FIXME (url)
+
+== DESCRIPTION:
+
+Variables:
+
+user
+group
+use_nginx
+application
+mongrel_servers
+precedence
+server_name
+ssl_required
+forced_prefix
+
+database_adapter
+database_username
+database_password
+database_host # optional
+database_socket # optional
+
+=== EC2 SPECIFIC VARIABLES
+
+ec2_access_key
+ec2_secret_key
+ec2_ami_image
+ec2_elastic_ip
+
+== DEPLOY SPECIFIC VARIABLES
+
+deploy_username
+deploy_password
+
+== APPLICATION SPECIFIC VARIABLES
+
+github_sshkey
+mysql_password
+
+== BACKUP SPECIFIC VARIABLES
+
+s3_id
+s3_key
+s3_backup_bucket
+
+== FEATURES/PROBLEMS:
+
+* FIXME (list of features or problems)
+
+== SYNOPSIS:
+
+  FIXME (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIXME (list of requirements)
+
+== INSTALL:
+
+* FIXME (sudo gem install, anything else)
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME (different license?)
+
+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,23 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+load 'tasks/setup.rb'
+
+ensure_in_path 'lib'
+require 'tannins'
+
+task :default => 'spec:run'
+
+PROJ.name = 'tannins'
+PROJ.authors = 'Rob Kaufman, Chris Petersen and Ryan Felton'
+PROJ.email = 'rob@notch8.com'
+PROJ.url = 'http://notch8.com'
+PROJ.rubyforge.name = 'tannins'
+PROJ.version = Tannins::VERSION
+PROJ.spec.opts << '--color'
+PROJ.ignore_file = '.bnsignore'
+depend_on 'amazon-ec2'
+depend_on 'mongrel_cluster'
+
+# EOF

data/lib/tannins.rb

@@ -0,0 +1,64 @@
+# $Id$
+# Equivalent to a header guard in C/C++
+# Used to prevent the class/module from being loaded more than once
+unless defined? Tannins
+
+module Tannins
+
+  # :stopdoc:
+  VERSION = '0.6'
+  LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+  PATH = ::File.dirname(LIBPATH) + ::File::SEPARATOR
+  # :startdoc:
+
+  def self.get_template(file_name)
+    file_path = File.join(Dir.pwd, "config", "templates", file_name)
+    if File.exists?(file_path)
+      return file_path
+    else
+      return "#{File.expand_path(File.dirname(__FILE__))}/templates"
+    end
+  end
+
+  # Returns the version string for the library.
+  #
+  def self.version
+    VERSION
+  end
+
+  # Returns the library path for the module. If any arguments are given,
+  # they will be joined to the end of the libray path using
+  # <tt>File.join</tt>.
+  #
+  def self.libpath( *args )
+    args.empty? ? LIBPATH : ::File.join(LIBPATH, *args)
+  end
+
+  # Returns the lpath for the module. If any arguments are given,
+  # they will be joined to the end of the path using
+  # <tt>File.join</tt>.
+  #
+  def self.path( *args )
+    args.empty? ? PATH : ::File.join(PATH, *args)
+  end
+
+  # Utility method used to rquire all files ending in .rb that lie in the
+  # directory below this file that has the same name as the filename passed
+  # in. Optionally, a specific _directory_ name can be passed in such that
+  # the _filename_ does not have to be equivalent to the directory.
+  #
+  def self.require_all_libs_relative_to( fname, dir = nil )
+    dir ||= ::File.basename(fname, '.*')
+    search_me = ::File.expand_path(
+        ::File.join(::File.dirname(fname), dir, '**', '*.rb'))
+
+    Dir.glob(search_me).sort.each {|rb| require rb}
+  end
+
+end  # module Tannins
+
+# Tannins.require_all_libs_relative_to __FILE__
+
+end  # unless defined?
+
+# EOF

data/lib/tannins/apache.rb

@@ -0,0 +1,27 @@
+require 'erubis'
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :gentoo do
+    desc "Setup Apache Configuration"
+    task :web_configuration_setup, :roles => :web do
+      sudo "mkdir -p /etc/apache2/vhosts.d"
+      
+      vhost_file = Tannins.get_template("apache_vhost.erb")
+      common_file = Tannins.get_template("apache_common.erb")
+    
+      # generate web server configuration (apache specific)
+      apache2_rails_conf = ::Erubis::Eruby.new(File.read(vhost_file)).result(binding)
+
+      apache2_rails_common_conf =  ::Erubis::Eruby.new(File.read(common_file)).result(binding)
+
+      put apache2_rails_conf, "#{shared_path}/system/#{application}.conf"
+      put apache2_rails_common_conf, "#{shared_path}/system/#{application}.common"
+
+      # if apache is setup to read /etc/apache2/vhosts.d/*.conf these will get read as configuration files
+      #  see prerequisites above for more info
+      sudo "ln -nfs #{shared_path}/config/#{application}.conf /etc/apache2/vhosts.d/#{precedence}_#{application}.conf"
+      sudo "ln -nfs #{shared_path}/config/#{application}.common /etc/apache2/vhosts.d/#{application}.common"
+      sudo "rc-update add apache2 default"
+
+    end
+  end
+end

data/lib/tannins/ec2.rb

@@ -0,0 +1,123 @@
+require 'EC2'
+require 'erubis'
+
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :ec2 do    
+    desc 'Creates a new EC2 instance and runs then launch_new.rb script'
+    task :new do
+      LIBPATH = ::File.expand_path(::File.dirname(__FILE__)) + ::File::SEPARATOR
+      
+      if File.exists?( "#{Dir.pwd}/config/ec2/launch_new.rb" )
+        user_data = File.read( "#{Dir.pwd}/config/ec2/launch_new.rb" )
+      else
+        user_data = ""
+      end
+      # user_data += File.read( "#{LIBPATH}launch_new.erb" )
+
+      processed_erb =  ::Erubis::Eruby.new(File.read("#{LIBPATH}templates/launch_new.erb")).result(binding)
+      # raw_erb = File.read( "#{LIBPATH}launch_new.erb" )
+      # processed_erb = ERB.new( raw_erb )
+      user_data += processed_erb
+
+      ec2 = EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+      reservation = ec2.run_instances(:image_id => ec2_ami_image, 
+        :keypair => "#{Dir.pwd}/config/ec2/id_rsa-gsg-keypair", 
+        :instance_type => "m1.small", 
+        :user_data => user_data)
+
+      reservation.instancesSet.item.each do |item|
+        raise Exception, "Instance did not start." unless item.instanceState.name == "pending"
+        puts "Instance #{item.instanceId} Startup Pending" 
+        puts "Checking every 10 seconds to detect startup for up to 5 minutes"
+        tries = 0
+        while tries < 35
+          launched = ec2.describe_instances(:instance_id =>[item.instanceId]).reservationSet.item.first.instancesSet.item.first
+          case launched.instanceState.name
+          when "pending"
+            print '.'
+            $stdout.flush
+            sleep 10
+            tries += 1
+          when "running"
+            puts "running #{item.instanceId} at #{launched.dnsName}"
+            assign_ip(ec2, item.instanceId)
+            break
+          else
+            puts "error initializing instance: #{item.instanceId}"
+            break
+          end
+        end
+      end
+      
+    end
+
+    desc 'Shuts down an instance'
+    task :terminate do
+      raise "INSTANCE_ID required" unless instance_id = ENV['INSTANCE_ID']
+
+      ec2 = EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+      ec2.terminate_instances(:instance_id => [instance_id])
+    end
+  
+    desc 'Returns all of your currently running instances'
+    task :instances do
+      ec2 = EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+      ec2.describe_instances.reservationSet.item.each do |set|
+        set.instancesSet.item.each do |instance|
+         str = instance.instanceId
+         str << " ("
+         str << instance.instanceState.name
+         if instance.instanceState.name == "running"
+           str << " at "
+           str << instance.dnsName
+           str << " on image "
+           str << instance.imageId
+           str << " launched at "
+           str << instance.launchTime
+         end
+         str << ")"
+         puts str
+        end
+      end
+    end
+
+    desc "return your own amazon images."
+    task :images do
+      ec2 = EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+      ec2.describe_images(:owner_id => "self").imagesSet.item.each do |image|
+       	 str = image.imageId
+       	 str << " ("
+       	 str << image.imageLocation
+       	 str << ") status: ("
+       	 str << 
+         str << image.imageState
+       	 str << " and "
+       	 p = (image.isPublic == "true")? "public" : "private"
+       	 str << p
+       	 str << ")"
+       	 puts str
+      end
+    end
+  
+    desc "change the production/staging ip to the value of INSTANCE_ID.  stagings is used unless RAILS_ENV=production"
+    task :assign_ip do
+      raise "INSTANCE_ID required" unless ENV['INSTANCE_ID']
+      ec2 = EC2::Base.new(:access_key_id => ec2_access_key, :secret_access_key => ec2_secret_key)
+      assign_ip(ec2, ENV['INSTANCE_ID'], true)
+    end
+  
+    def assign_ip(ec2, instance_id, force = false)
+      environment_var = ENV['RAILS_ENV'] || ENV['MERB_ENV']
+      if environment_var == 'production' && force
+        puts "Changing where the PRODUCTIOIN IP address points"
+        ec2.associate_address(:instance_id => instance_id, :public_ip => PRODUCTION_IP)
+      elsif ENV['RAILS_ENV'] == 'production'
+        puts "We don't move the production elastic IP automatically..."
+        puts "you have to force it by doing 'rake ec2:assign_ip INSTANCE_ID=#{instance_id} RAILS_ENV=production"
+      else
+        puts "Changing where the IP address points"
+        ec2.associate_address(:instance_id => instance_id, :public_ip => ec2_elastic_ip)
+      end
+    end
+  end
+end

data/lib/tannins/fedora.rb

@@ -0,0 +1,21 @@
+Capistrano::Configuration.instance(:must_exist).load do
+  namespace :deploy do
+    desc 'restart mongrel cluster'
+    task :restart do
+      run  "cd #{current_release} && mongrel_rails cluster::restart" 
+    end
+
+    task :start do
+      run "cd #{current_release} && mongrel_rails cluster::start"
+    end
+
+    task :stop do
+      run "cd #{current_release} && mongrel_rails cluster::stop"
+    end
+
+    desc 'rails cluster status'
+    task :cluster_status do
+      run "cd #{current_release} && mongrel_rails cluster::status"
+    end
+  end
+end

data/lib/tannins/gentoo.rb

@@ -0,0 +1,100 @@
+require 'erubis'
+Capistrano::Configuration.instance(:must_exist).load do
+  after  'deploy:update_code',  'deploy:symlink_configs'
+
+  before 'deploy:setup', 'gentoo:set_keys'
+  after  'deploy:setup', 'gentoo:fix_permissions'
+  after  'deploy:setup', 'deploy:update'
+  after  'deploy:setup', 'gentoo:setup'
+
+  namespace :tannins do
+    desc "Copy templates over for editing"
+    task :copy_templates do
+      run_locally "mkdir -p config/templates"
+      run_locally "cp -r #{Tannins.path}/lib/tannins/templates/* config/templates/"
+    end
+    
+    desc "Show which template would be used for TEMPLATE"
+    task :template do
+      puts Tannins.get_template(ENV["TEMPLATE"])
+    end
+  end
+  
+  namespace :gentoo do
+    # =============================================================================
+    # CALLBACK TASKS
+    # =============================================================================
+
+    desc "Tasks to execute before initial setup"
+    task :fix_permissions do
+      sudo "mkdir -p /etc/mongrel_cluster"
+      
+      sudo "chown -R #{user}:#{group} #{deploy_to}"
+      # make shared config dir to hold these config files
+      run "mkdir -p #{shared_path}/config"
+
+      # make a shared tmp dir for sessions
+      run "mkdir -p #{shared_path}/tmp"
+      run "mkdir -p #{shared_path}/tmp/cache"
+      run "mkdir -p #{shared_path}/tmp/sessions"
+      run "mkdir -p #{shared_path}/tmp/sockets"
+      # run "mkdir -p #{shared_path}/tmp/pids"  # new rails construct
+      # create any other shared dirs
+      # run "mkdir -p #{shared_path}/db"
+      # run "mkdir -p #{shared_path}/db/ferret_index"  
+    end
+
+    before 'gentoo:setup', 'gentoo:application_configuration_setup'
+    before 'gentoo:setup', 'gentoo:database_configuration_setup'
+    before 'gentoo:setup', 'gentoo:web_configuration_setup'
+    
+    desc "Tasks to execute after initial setup"
+    task :setup do
+      rake = fetch(:rake, "rake")
+      run "cd #{latest_release} && #{rake} db:create db:migrate RAILS_ENV=#{rails_env}"
+    end
+
+    desc "Setup Database Configuration"
+    task :database_configuration_setup do
+      # generate database configuration 
+      database_file = Tannins.get_template("database.erb")
+      database_conf = Erubis::Eruby.new(File.read(database_file)).result(binding)
+
+      # put database configuration in shared config dir
+      put database_conf, "#{shared_path}/config/database.yml"
+    end
+        
+    desc "Add the deploy keys to the deployment user"
+    task :set_keys, :roles => :app do
+      sudo "mkdir -p #{deploy_to}"
+      sudo "chown -R #{user}:#{group} #{deploy_to}"
+      
+      key_file = File.read("#{Dir.pwd}/config/deploy_key")
+      pub_file = File.read("#{Dir.pwd}/config/deploy_key.pub")
+      run "mkdir -p /home/#{user}/.ssh/"
+      put key_file, "/home/#{user}/.ssh/id_dsa"
+      put pub_file, "/home/#{user}/.ssh/id_dsa.pub"
+      sudo "chmod 600 /home/#{user}/.ssh/id_dsa"
+    end
+  end
+
+  task :testing do
+    puts fetch(:database_host, "")
+  end
+
+
+  namespace :deploy do
+  
+    desc "Symlinks the database and mongrel cluster configs"
+    task :symlink_configs, :roles => [:web] do 
+      symlink_database_config
+    end
+  
+    desc "Link to the shared database.yml."
+    task :symlink_database_config, :roles => [:web] do
+      run "rm -f #{latest_release}/config/database.yml"
+      run "ln -nfs #{shared_path}/config/database.yml #{latest_release}/config/database.yml"
+    end
+  end
+  
+end