hennk-hennk-ec2onrails 0.9.9.2

data/server/files/usr/local/ec2onrails/bin/backup_files.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/ruby
+
+# Tars a given file or directory and uploads it to S3 using a time-stamped name.
+# Takes 2 required and 1 optional flags:
+#   -sourceFileOrDir  The full path to the file or dir to be saved to S3
+#   -dir              The directory inside the bucket to save above file/dir to
+#   -bucket           [optional] The bucket where <dir> will be created. If this is not specified, it defaults to the bucket_base_name from s3.yml concatenated with the hostname.
+
+exit unless File.exists?("/mnt/app/current")
+
+require "rubygems"
+require 'zlib'
+require 'archive/tar/minitar'
+include Archive::Tar
+require "optiflag"
+require "fileutils"
+require "#{File.dirname(__FILE__)}/../lib/s3_helper"
+require "#{File.dirname(__FILE__)}/../lib/utils"
+
+module CommandLineArgs extend OptiFlagSet
+  flag "sourceFileOrDir"
+  flag "dir"
+  optional_flag "bucket"
+
+  and_process!
+end
+
+# include the hostname in the bucket name so test instances don't accidentally clobber real backups
+bucket = ARGV.flags.bucket
+dir = ARGV.flags.dir
+@s3 = Ec2onrails::S3Helper.new(bucket, dir)
+@temp_dir = "/mnt/tmp/backup-files-#{@s3.bucket}-#{dir.gsub(/\//, "-")}"
+local_file = File.join(@temp_dir, "#{Time.new.strftime('%Y-%m-%d--%H-%M-%S')}.tar")
+if File.exists?(@temp_dir)
+  puts "Temp dir exists (#{@temp_dir}), aborting. Is another backup process running?"
+  exit
+end
+
+begin
+  FileUtils.mkdir_p @temp_dir
+  
+  source_file = ARGV.flags.sourceFileOrDir
+  
+  FileUtils.cd(File.dirname(source_file)) do
+    File.open(local_file, 'wb') { |tar| Minitar.pack(File.basename(source_file), tar) }
+  end
+  
+  @s3.store_file(local_file)
+ensure
+  FileUtils.rm_rf(@temp_dir)
+end

data/server/files/usr/local/ec2onrails/bin/mongrel_start

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+. /etc/environment
+export PATH
+export RUBYLIB
+
+mongrel_rails cluster::start -C /etc/mongrel_cluster/app.yml --clean $*
+

data/server/files/usr/local/ec2onrails/bin/mongrel_stop

@@ -0,0 +1,8 @@
+#!/bin/sh
+
+. /etc/environment
+export PATH
+export RUBYLIB
+
+mongrel_rails cluster::stop -C /etc/mongrel_cluster/app.yml $*
+

data/server/files/usr/local/ec2onrails/bin/rails_env

@@ -0,0 +1,35 @@
+#!/usr/bin/ruby
+
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+# This script runs a command with RAILS_ENV set to the value that's specified
+# in the the mongrel_cluster config file. If a command isn't given as an 
+# argument it simply prints the value of RAILS_ENV
+
+require "yaml"
+
+@rails_env = YAML::load_file("/etc/mongrel_cluster/app.yml")["environment"]
+
+if ARGV.any?
+  result = system "env RAILS_ENV=#{@rails_env} #{ARGV.join(' ')}"
+  raise("error: #{$?}") unless result
+else
+  puts @rails_env
+end

data/server/files/usr/local/ec2onrails/bin/rebundle.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+cleanup() {
+  rm -f /ec2onrails-first-boot	
+}
+
+fail() {
+  echo "`basename $0`: ERROR: $1"
+  cleanup
+  exit 1
+}
+
+if [ `whoami` != 'root' ] ; then
+  fail "This script must be run as root, use 'sudo $0'".
+fi
+
+. "/usr/local/ec2onrails/config"
+
+TIMESTAMP="`date '+%Y-%m-%d--%H-%M-%S'`"
+NEW_BUCKET_NAME="$BUCKET_BASE_NAME-image-$TIMESTAMP"
+
+if [ ! -e /usr/local/ec2-api-tools ] ; then
+  echo "The EC2 api command-line tools don't seem to be installed."
+  echo "To install them (and Java, which they require), press enter..."
+  read
+  curl http://s3.amazonaws.com/ec2-downloads/ec2-api-tools.zip > /tmp/ec2-api-tools.zip || fail "couldn't download ec2-api-tools.zip"
+  unzip /tmp/ec2-api-tools.zip -d /usr/local || fail "couldn't unzip ec2-api-tools.zip"
+  chmod -R go-w /usr/local/ec2-api-tools*
+  ln -sf /usr/local/ec2-api-tools-* /usr/local/ec2-api-tools
+  aptitude install -y sun-java6-jre || fail "couldn't install Java package"
+fi
+
+echo "--> Clearing apt cache..."
+aptitude clean
+
+touch /ec2onrails-first-boot || fail
+
+echo "--> Clearing sensitive files..."
+rm -f /root/{.bash_history,.lesshst}
+
+echo "--> Creating image..."
+ec2-bundle-vol -e "/root/.ssh,/home/app/.ssh,/home/admin/.ssh,/tmp,/mnt" -d /mnt -k "$EC2_PRIVATE_KEY" -c "$EC2_CERT" -u "$AWS_ACCOUNT_ID" || fail "ec2-bundle-vol failed"
+
+echo "--> Uploading image to $NEW_BUCKET_NAME"
+ec2-upload-bundle -b "$NEW_BUCKET_NAME" -m /mnt/image.manifest.xml -a "$AWS_ACCESS_KEY_ID" -s "$AWS_SECRET_ACCESS_KEY" || fail "ec2-upload-bundle failed"
+
+echo "--> Registering image..."
+ec2-register "$NEW_BUCKET_NAME/image.manifest.xml" || fail "ec2-register failed"
+
+echo "--> Done."
+cleanup

data/server/files/usr/local/ec2onrails/bin/restore_app_db.rb

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby
+
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require "rubygems"
+require "optiflag"
+require "fileutils"
+require "#{File.dirname(__FILE__)}/../lib/mysql_helper"
+require "#{File.dirname(__FILE__)}/../lib/s3_helper"
+require "#{File.dirname(__FILE__)}/../lib/utils"
+
+module CommandLineArgs extend OptiFlagSet
+  optional_flag "bucket"
+  optional_flag "dir"
+  and_process!
+end
+
+bucket = ARGV.flags.bucket
+dir = ARGV.flags.dir || "database"
+@s3 = Ec2onrails::S3Helper.new(bucket, dir)
+@mysql = Ec2onrails::MysqlHelper.new
+@temp_dir = "/mnt/tmp/ec2onrails-backup-#{@s3.bucket}-#{dir.gsub(/\//, "-")}"
+if File.exists?(@temp_dir)
+  puts "Temp dir exists (#{@temp_dir}), aborting. Is another backup process running?"
+  exit
+end
+
+begin
+  FileUtils.mkdir_p @temp_dir
+  
+  file = "#{@temp_dir}/dump.sql.gz"
+  @s3.retrieve_file(file)
+  @mysql.load_from_dump(file)
+  
+  @s3.retrieve_files("mysql-bin.", @temp_dir)
+  logs = Dir.glob("#{@temp_dir}/mysql-bin.[0-9]*").sort
+  logs.each {|log| @mysql.execute_binary_log(log) }
+  
+  @mysql.execute_sql "reset master" # TODO  maybe we shouldn't do this if we're not going to delete the logs from the S3 bucket because this restarts the numbering again
+ensure
+  FileUtils.rm_rf(@temp_dir)
+end

data/server/files/usr/local/ec2onrails/bin/restore_files.rb

@@ -0,0 +1,59 @@
+#!/usr/bin/ruby
+
+# Downloads and untars a backup created with backup_files.rb from a given directory from S3.
+# Takes 2 required and 2 optional flags:
+#   -destDir          The full path to the dir where the downloaded file should be extracted
+#   -dir              The directory inside the bucket where the timestamped backups can be found
+#   -timestamp        [optional] Download the given timestamp. If this flag is not given, the most recent timestamp will be downloaded. Timestamps have to be in the following format: YYYY-MM-DD--HH-MM-SS
+#   -bucket           [optional] The bucket where <dir> will be created. If this is not specified, it defaults to the bucket_base_name from s3.yml concatenated with the hostname.
+
+require "rubygems"
+require 'zlib'
+require 'archive/tar/minitar'
+include Archive::Tar
+require "optiflag"
+require "fileutils"
+require "#{File.dirname(__FILE__)}/../lib/s3_helper"
+require "#{File.dirname(__FILE__)}/../lib/utils"
+require 'aws/s3'
+include AWS::S3
+
+module CommandLineArgs extend OptiFlagSet
+  flag "destDir"
+  flag "dir"
+  optional_flag "timestamp"
+  optional_flag "bucket"
+  
+  and_process!
+end
+
+dir = ARGV.flags.dir
+@s3 = Ec2onrails::S3Helper.new(ARGV.flags.bucket, dir)
+@temp_dir = "/mnt/tmp/backup-files-#{@s3.bucket}-#{dir.gsub(/\//, "-")}"
+if File.exists?(@temp_dir)
+  puts "Temp dir exists (#{@temp_dir}), aborting. Is another backup process running?"
+  exit
+end
+
+begin
+  FileUtils.mkdir_p @temp_dir
+  
+  if ARGV.flags.timestamp
+    filename = "#{ARGV.flags.timestamp}.tar"
+  else
+    # The user didn't supply a timestamp to load, so get a list of all files inside <bucket>/<dir> and take the youngest timestamp.
+    bucket = Bucket.find(@s3.bucket, {:prefix => dir})
+    names_to_buckets = bucket.objects.map { |o| {:name => File.basename(o.key), :object => o }}
+    names_to_buckets.sort_by {|a| a[:name]}
+    filename = names_to_buckets.last[:name]
+  end
+  
+  file = "#{@temp_dir}/#{filename}"
+  @s3.retrieve_file(file)
+
+  FileUtils.cd(ARGV.flags.destDir) do
+    Minitar.unpack(file, '.')
+  end
+ensure
+  FileUtils.rm_rf(@temp_dir)
+end

data/server/files/usr/local/ec2onrails/bin/set_rails_env

@@ -0,0 +1,40 @@
+#!/usr/bin/ruby
+
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+# This script updates the value of "environment" in the the mongrel_cluster
+# config file.
+
+require "yaml"
+require "erb"
+
+if ARGV.length != 1
+  puts "usage: set_rails_env <value>"
+  exit 1
+end
+
+@rails_env = ARGV[0]
+
+# update mongrel_cluster config
+config = YAML::load_file("/etc/mongrel_cluster/app.yml")
+config["environment"] = @rails_env
+File.open("/etc/mongrel_cluster/app.yml", 'w') do |f|
+  YAML.dump(config, f)
+end

data/server/files/usr/local/ec2onrails/bin/set_roles.rb

@@ -0,0 +1,156 @@
+#!/usr/bin/ruby
+
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+require 'net/http'
+require 'pp'
+require 'socket'
+require 'yaml'
+
+def start(role, service, prog_name = service)
+  # ensure script is executable
+  run "chmod a+x /etc/init.d/#{service}"
+  # start service if not running:
+  unless (system("pidof -x #{prog_name}"))
+    run "sh /etc/init.d/#{service} start && sleep 30" # give the service 30 seconds to start before attempting to monitor it
+  end
+  run "monit -g #{role} monitor all"
+end
+
+def stop(role, service, prog_name = service)
+  run "monit -g #{role} unmonitor all"
+  if (system("pidof -x #{prog_name}"))
+    result = run("sh /etc/init.d/#{service} stop")
+  end  
+  # make start script non-executable in case of reboot
+  run("chmod a-x /etc/init.d/#{service}")
+end
+
+def run(cmd)
+  result = system(cmd)
+  puts("*****ERROR: #{cmd} returned #{$?}") unless result
+end
+
+def get_address_metadata(type)
+  address  = Net::HTTP.get('169.254.169.254', "/2007-08-29/meta-data/#{type}").strip
+  raise "couldn't get instance data: #{type}" unless address =~ /\A\d+\.\d+\.\d+\.\d+\Z/
+  puts "#{type}: #{address}"
+  return address
+end
+
+def resolve(hostname)
+  address = IPSocket.getaddress(hostname).strip
+  if address == @local_address || address == @public_address
+    "127.0.0.1"
+  else
+    address
+  end
+  rescue Exception => e
+    puts "couldn't resolve hostname '#{hostname}'"
+    raise e
+end
+
+def resolve_all_addresses(original)
+  resolved = {}
+  original.each do |rolename, hostnames|
+    resolved[rolename] = hostnames.map{|hostname| resolve(hostname)} if hostnames
+  end
+  resolved
+end
+
+def in_role(role)
+  return false unless @roles[role]
+  return @roles[role].include?("127.0.0.1") 
+end
+
+ROLES_FILE = "/etc/ec2onrails/roles.yml"
+
+@local_address  = get_address_metadata "local-ipv4"
+@public_address = get_address_metadata "public-ipv4"
+
+@roles = resolve_all_addresses(YAML::load_file(ROLES_FILE))
+puts "Roles: "
+pp @roles
+
+
+#######################################
+# TODO move these role definitions each into it's own file so adding a new 
+#      role is just dropping a ruby file into a directory
+
+# memcache role:
+if in_role(:memcache)
+  puts "Starting memcache role..."
+  # increase memory size, etc if no other roles exist?
+  start(:memcache, "memcached")
+else
+  puts "Stopping memcache role..."
+  stop(:memcache, "memcached")
+end
+
+# db primary role:
+if in_role(:db_primary)
+  puts "Starting db_primary role..."
+  # increase caches, etc if no other roles exist?
+  start(:db_primary, "mysql", "mysqld")
+else
+  puts "Stopping db_primary role..."
+  stop(:db_primary, "mysql", "mysqld")
+end
+
+# web role:
+if in_role(:web)
+  puts "Starting web role..."
+  balancer_members = File.open("/etc/ec2onrails/balancer_members", "w") do |f|
+    @roles[:app].each do |address|
+      (8000..8005).each do |port|
+        f << "BalancerMember http://#{address}:#{port}\n"
+      end
+      f << "\n"
+    end
+  end
+  start(:web, "apache2")
+  # Force apache to reload config files in case it was already running and app hosts changed.
+  run "/etc/init.d/apache2 reload"
+else
+  puts "Stopping web role..."
+  stop(:web, "apache2")
+end
+
+# app role:
+if in_role(:app)
+  puts "Starting app role..."
+  
+  if @roles[:db_primary]
+    # edit /etc/hosts, need db_primary address & db_slave address
+    db_primary_addr = @roles[:db_primary][0]
+    puts "db_primary has ip address: #{db_primary_addr}"
+    
+    # TODO just use ruby here...
+    run("cp /etc/hosts.original /etc/hosts")
+    run("echo '\n#{db_primary_addr}\tdb_primary\n' >> /etc/hosts")
+  end
+  
+  start(:app, "mongrel", "mongrel_rails")
+else
+  puts "Stopping app role..."
+  stop(:app, "mongrel", "mongrel_rails")
+end
+
+#######################################

data/server/files/usr/local/ec2onrails/config

@@ -0,0 +1,30 @@
+############################################################
+# This script is sourced by .bashrc and by /usr/local/ec2onrails/rebundle.sh
+# You shouldn't need to change anything in here
+
+if [ -r /mnt/aws-config/config ] ; then
+  . /mnt/aws-config/config
+  export EC2_PRIVATE_KEY="/mnt/aws-config/$KEY_FILE_NAME"
+  export EC2_CERT="/mnt/aws-config/$CERT_FILE_NAME"
+
+fi
+
+export EC2_HOME=/usr/local/ec2-api-tools
+export PATH="$PATH:$EC2_HOME/bin"
+
+export JAVA_HOME="/usr/lib/jvm/java-6-sun"
+
+# Set the bash prompt to include the rails environment name
+case "$TERM" in
+xterm-color)
+    PS1='${debian_chroot:+($debian_chroot)}\[\033[01;32m\]\u@\h\[\033[00m\]-\[\033[01;35m\]`/usr/local/ec2onrails/bin/rails_env`\[\033[00m\]:\[\033[01;34m\]\w\[\033[00m\]\$ '
+    ;;
+*)
+    PS1='${debian_chroot:+($debian_chroot)}\u@\h-`/usr/local/ec2onrails/bin/rails_env`:\w\$ '
+    ;;
+esac
+
+# Set some useful aliases
+alias app="pushd /mnt/app/current && sudo su app && popd"
+alias log="tail -f /mnt/app/current/log/`/usr/local/ec2onrails/bin/rails_env`.log"
+alias logs="tail -f /mnt/app/current/log/*.log /mnt/log/apache2/*.log /mnt/log/syslog"

data/server/files/usr/local/ec2onrails/lib/mysql_helper.rb

@@ -0,0 +1,101 @@
+#    This file is part of EC2 on Rails.
+#    http://rubyforge.org/projects/ec2onrails/
+#
+#    Copyright 2007 Paul Dowman, http://pauldowman.com/
+#
+#    EC2 on Rails is free software; you can redistribute it and/or modify
+#    it under the terms of the GNU General Public License as published by
+#    the Free Software Foundation; either version 2 of the License, or
+#    (at your option) any later version.
+#
+#    EC2 on Rails is distributed in the hope that it will be useful,
+#    but WITHOUT ANY WARRANTY; without even the implied warranty of
+#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#    GNU General Public License for more details.
+#
+#    You should have received a copy of the GNU General Public License
+#    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require 'rubygems'
+require 'aws/s3'
+require 'yaml'
+require 'erb'
+require 'fileutils'
+require "#{File.dirname(__FILE__)}/utils"
+
+module Ec2onrails
+  class MysqlHelper
+
+    DEFAULT_CONFIG_FILE = "/mnt/app/current/config/database.yml"
+
+    attr_accessor :database
+    attr_accessor :user
+    attr_accessor :password
+
+    def initialize(config_file = DEFAULT_CONFIG_FILE, rails_env = Utils.rails_env)
+      @rails_env = rails_env
+      load_db_config(config_file)
+    end
+
+    def load_db_config(config_file)
+      db_config = YAML::load(ERB.new(File.read(config_file)).result)
+      if db_config && db_config[@rails_env].nil?
+        puts "the rails environment '#{@rails_env}' was not found in this db onfig file: #{config_file}"
+      end
+      db_config = db_config[@rails_env]
+      @database = db_config['database']
+      @user = db_config['username']
+      @password = db_config['password']
+    end
+
+    def execute_sql(sql)
+      raise "@user not set" unless @user
+      raise "sql not given" unless sql
+      cmd = %{mysql -u #{@user} -e "#{sql}"}
+      cmd += " -p'#{@password}' " unless @password.nil?
+      Utils.run cmd
+    end
+    
+    def execute
+      require "mysql"
+      
+      begin
+        # connect to the MySQL server
+        dbh = Mysql.real_connect("localhost", "#{@user}", "#{@password}", "#{@database}")
+        yield dbh
+      rescue Mysql::Error => e
+        puts "Error code: #{e.errno}"
+        puts "Error message: #{e.error}"
+        puts "Error SQLSTATE: #{e.sqlstate}" if e.respond_to?("sqlstate")
+      ensure
+        # disconnect from server
+        dbh.close if dbh
+      end
+      
+      
+    end
+    
+    def dump(out_file, reset_logs)
+      cmd = "mysqldump --quick --single-transaction --create-options -u#{@user} "
+      if reset_logs
+        cmd += " --flush-logs --master-data=2 --delete-master-logs "
+      end
+      cmd += " -p'#{@password}' " unless @password.nil?
+      cmd += " #{@database} | gzip > #{out_file}"
+      Utils.run cmd    
+    end
+    
+    def load_from_dump(in_file)
+      cmd = "gunzip -c #{in_file} | mysql -u#{@user} "
+      cmd += " -p'#{@password}' " unless @password.nil?
+      cmd += " #{@database}"
+      Utils.run cmd
+    end
+    
+    def execute_binary_log(log_file)
+      cmd = "mysqlbinlog --database=#{@database} #{log_file} | mysql -u#{@user} "
+      cmd += " -p'#{@password}' " unless @password.nil?
+      Utils.run cmd
+    end
+  end
+end