heroku_san_gt 1.0.8

data/README.rdoc

@@ -0,0 +1,113 @@
+= Heroku San
+
+Helpful rake tasks for Heroku.
+
+== Install
+
+=== Rails 3
+
+Add this to your Gemfile:
+
+  group :development do
+    gem 'heroku_san'
+  end
+
+=== Rails 2
+
+To install add the following to config/environment.rb:
+
+  config.gem 'heroku_san'
+
+Rake tasks are not automatically loaded from gems, so you’ll need to add the following to your Rakefile:
+
+  begin
+    require 'heroku_san/tasks'
+  rescue LoadError
+    STDERR.puts "Run `rake gems:install` to install heroku_san"
+  end
+
+== Configure
+
+In config/heroku.yml you will need add the Heroku apps that you would like to attach to this project. You can generate this file and edit it by running:
+  
+  rake heroku:create_config
+
+If this is a fresh project, heroku_san can create all the applications for
+you, and set the RACK_ENV.
+
+  rake all heroku:create heroku:rack_env
+
+== Usage
+
+After configuring your Heroku apps you can use rake tasks to control the
+apps.
+
+  rake production deploy
+
+A rake task with the shorthand name of each app is now available and adds that
+server to the list that subsequent commands will execute on. Because this list
+is additive, you can easily select which servers to run a command on.
+
+  rake demo staging restart
+
+A special rake task 'all' is created that causes any further commands to
+execute on all heroku apps.
+
+Manipulate collaborators on all this project's apps (prompts for email
+address):
+
+  rake all heroku:share
+  rake all heroku:unshare
+
+Need to add remotes for each app?
+
+  rake all heroku:remotes
+
+A full list of tasks provided:
+
+  rake all                   # Select all Heroku apps for later command
+  rake console               # Opens a remote console
+  rake deploy[commit]        # Pushes the given commit, migrates and restarts (default: HEAD)
+  rake deploy:force[commit]  # Force-pushes the given commit, migrates and restarts (default: HEAD)
+  rake after_deploy          # Callback after deploys
+  rake before_deploy         # Callback before deploys
+  rake capture               # Captures a bundle on Heroku
+  rake heroku:apps           # Lists configured apps
+  rake heroku:create         # Creates the Heroku app
+  rake heroku:create_config  # Creates an example configuration file
+  rake heroku:gems           # Generate the Heroku gems manifest from gem dependencies
+  rake heroku:maintenance    # Enable maintenance mode
+  rake heroku:maintenance_off# Disable maintenance mode
+  rake heroku:push           # Pushes the given commit (default: HEAD)
+  rake heroku:push:force     # Force-pushes the given commit (default: HEAD)
+  rake heroku:remotes        # Add git remotes for all apps in this project
+  rake heroku:rack_env       # Add proper RACK_ENV to each application
+  rake heroku:rake[task]     # Runs a rake task remotely
+  rake heroku:share          # Adds a collaborator
+  rake heroku:unshare        # Removes a collaborator
+  rake logs                  # Shows the Heroku logs
+  rake migrate               # Migrates and restarts remote servers
+  rake restart               # Restarts remote servers
+
+Frequently used tasks are not namespaced, everything else lives under heroku.
+
+== Links
+
+Homepage:: http://github.com/fastestforward/heroku_san
+Issue Tracker:: http://github.com/fastestforward/heroku_san/issues
+
+== Contributors
+
+* Elijah Miller (elijah.miller@gmail.com)
+* Glenn Roberts (glenn.roberts@siyelo.com)
+* Damien Mathieu (42@dmathieu.com)
+* Matthew Hassfurder (matthew.hassfurder@gmail.com)
+* Peter Jaros
+* Lee Semel
+* Michael Haddad (michael@ludditetechnology.com)
+* Les Hill (leshill@gmail.com)
+* Bryan Ash
+
+== License
+
+License:: Copyright (c) 2009 Elijah Miller <mailto:elijah.miller@gmail.com>, released under the MIT license.

data/Rakefile

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

data/lib/heroku_san/railtie.rb

@@ -0,0 +1,10 @@
+require 'heroku_san'
+require 'rails'
+
+module HerokuSan
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load 'heroku_san/tasks.rb'
+    end
+  end
+end

data/lib/heroku_san/tasks.rb

@@ -0,0 +1,288 @@
+HEROKU_CONFIG_FILE = Rails.root.join('config', 'heroku.yml')
+
+@app_settings = 
+  if File.exists?(HEROKU_CONFIG_FILE)
+    YAML.load_file(HEROKU_CONFIG_FILE)
+  else
+    {}
+  end
+
+if @app_settings.has_key? 'apps'
+  @app_settings = @app_settings['apps']
+  @app_settings.each_pair do |shorthand, app_name|
+    @app_settings[shorthand] = {'app' => app_name}
+  end
+end
+
+(@app_settings.keys || []).each do |name|
+  desc "Select #{name} Heroku app for later commands"
+  task name do
+    @heroku_apps ||= []
+    @heroku_apps << name
+  end
+end
+
+desc 'Select all Heroku apps for later command'
+task :all do
+  @heroku_apps = @app_settings.keys
+end
+
+namespace :heroku do
+  desc "Creates the Heroku app"
+  task :create do
+    each_heroku_app do |name, app, repo|
+      sh "heroku create #{app} --stack bamboo-mri-1.9.2"
+    end
+  end
+
+  desc "Generate the Heroku gems manifest from gem dependencies"
+  task :gems => 'gems:base' do
+    RAILS_ENV='production'
+    Rake::Task[:environment].invoke
+    gems = Rails.configuration.gems.reject { |g| g.frozen? && !g.framework_gem? }
+    list = gems.collect do |g|
+      command, *options = g.send(:install_command)
+      options.join(" ")
+    end
+
+    list.unshift(%Q{rails --version "= #{Rails.version}"})
+
+    File.open(Rails.root.join('.gems'), 'w') do |f|
+      f.write(list.join("\n"))
+    end
+  end
+
+  desc 'Add git remotes for all apps in this project'
+  task :remotes do
+    each_heroku_app do |name, app, repo|
+      system("git remote add #{name} #{repo}")
+    end
+  end
+
+  desc 'Adds a collaborator'
+  task :share do
+    print "Email address of collaborator to add: "
+    $stdout.flush
+    email = $stdin.gets
+    each_heroku_app do |name, app, repo|
+      sh "heroku sharing:add --app #{app} #{email}"
+    end
+  end
+
+  desc 'Removes a collaborator'
+  task :unshare do
+    print "Email address of collaborator to remove: "
+    $stdout.flush
+    email = $stdin.gets
+    each_heroku_app do |name, app, repo|
+      sh "heroku sharing:remove --app #{app} #{email}"
+    end
+  end
+
+  desc 'Lists configured apps'
+  task :apps => :all do
+    each_heroku_app do |name, app, repo|
+      puts "#{name} is shorthand for the Heroku app #{app} located at:"
+      puts "  #{repo}"
+      puts
+    end
+  end
+
+  desc 'Add proper RACK_ENV to each application'
+  task :rack_env => :all do
+    each_heroku_app do |name, app, repo|
+      command = "heroku config --app #{app}"
+      puts command
+      config = Hash[`#{command}`.scan(/^(.+?)\s*=>\s*(.+)$/)]
+      if config['RACK_ENV'] != name
+        sh "heroku config:add --app #{app} RACK_ENV=#{name}"
+      end
+    end
+  end
+
+  desc 'Creates an example configuration file'
+  task :create_config do
+    example = File.join(File.dirname(__FILE__), '..', 'templates', 'heroku.example.yml')
+    if File.exists?(HEROKU_CONFIG_FILE)
+      puts "config/heroku.yml already exists"
+    else
+      puts "Copied example config to config/heroku.yml"
+      FileUtils.cp(example, HEROKU_CONFIG_FILE)
+      sh("#{ENV['EDITOR']} #{HEROKU_CONFIG_FILE}")
+    end
+  end
+
+  desc 'Add config:vars to each application.'
+  task :config do
+    each_heroku_app do |name, app, repo, config|
+      (config).each do |var, value|
+        sh "heroku config:add --app #{app} #{var}=#{value}"
+      end
+    end
+  end
+  
+  desc 'Runs a rake task remotely'
+  task :rake, :task do |t, args|
+    each_heroku_app do |name, app, repo|
+      sh "heroku rake --app #{app} #{args[:task]}"
+    end
+  end
+
+  desc "Pushes the given commit (default: HEAD)"
+  task :push, :commit do |t, args|
+    each_heroku_app do |name, app, repo|
+      push(args[:commit], repo)
+    end
+  end
+
+  namespace :push do
+    desc "Force-pushes the given commit (default: HEAD)"
+    task :force, :commit do |t, args|
+      @git_push_arguments ||= []
+      @git_push_arguments << '--force'
+      Rake::Task[:'heroku:push'].execute(args)
+    end
+  end
+
+  desc "Enable maintenance mode"
+  task :maintenance do
+    each_heroku_app do |name, app, repo|
+      maintenance(app, 'on')
+    end
+  end
+
+  desc "Disable maintenance mode"
+  task :maintenance_off do
+    each_heroku_app do |name, app, repo|
+      maintenance(app, 'off')
+    end
+  end
+end
+
+desc "Pushes the given commit, migrates and restarts (default: HEAD)"
+task :deploy, :commit, :needs => :before_deploy do |t, args|
+  each_heroku_app do |name, app, repo|
+    push(args[:commit], repo)
+    migrate(app)
+  end
+  Rake::Task[:after_deploy].execute
+end
+
+namespace :deploy do
+  desc "Force-pushes the given commit, migrates and restarts (default: HEAD)"
+  task :force, :commit do |t, args|
+    @git_push_arguments ||= []
+    @git_push_arguments << '--force'
+    Rake::Task[:deploy].invoke(args)
+  end
+end
+
+# Deprecated.
+task :force_deploy do
+  Rake::Task[:'deploy:force'].invoke
+end
+
+desc "Callback before deploys"
+task :before_deploy do
+end
+
+desc "Callback after deploys"
+task :after_deploy do
+end
+
+desc "Captures a bundle on Heroku"
+task :capture do
+  each_heroku_app do |name, app, repo|
+    sh "heroku bundles:capture --app #{app}"
+  end
+end
+
+desc "Opens a remote console"
+task :console do
+  each_heroku_app do |name, app, repo|
+    sh "heroku console --app #{app}"
+  end
+end
+
+desc "Restarts remote servers"
+task :restart do
+  each_heroku_app do |name, app, repo|
+    sh "heroku restart --app #{app}"
+  end
+end
+
+desc "Migrates and restarts remote servers"
+task :migrate do
+  each_heroku_app do |name, app, repo|
+    migrate(app)
+  end
+end
+
+desc "Shows the Heroku logs"
+task :logs do
+  each_heroku_app do |name, app, repo|
+    sh "heroku logs --app #{app}"
+  end
+end
+
+namespace :db do
+  task :pull do
+    each_heroku_app do |name, app, repo|
+      sh "heroku pgdumps:capture --app #{app}"
+      dump = `heroku pgdumps --app #{app}`.split("\n").last.split(" ").first
+      sh "mkdir -p #{Rails.root}/db/dumps"
+      file = "#{Rails.root}/db/dumps/#{dump}.sql.gz"
+      url = `heroku pgdumps:url --app #{app} #{dump}`.chomp
+      sh "wget", url, "-O", file
+      sh "rake db:drop db:create"
+      sh "gunzip -c #{file} | #{Rails.root}/script/dbconsole"
+      sh "rake jobs:clear"
+    end
+  end
+end
+
+def each_heroku_app
+  if @heroku_apps.blank? && @app_settings.keys.size == 1
+    app = @app_settings.keys.first
+    puts "Defaulting to #{app} app since only one app is defined"
+    @heroku_apps = [app]
+  end
+  if @heroku_apps.present?
+    @heroku_apps.each do |name|
+      app = @app_settings[name]['app']
+      config = @app_settings[name]['config'] || []
+      yield(name, app, "git@heroku.com:#{app}.git", config)
+    end
+    puts
+  else
+    puts "You must first specify at least one Heroku app:
+      rake <app> [<app>] <command>
+      rake production restart
+      rake demo staging deploy"
+
+    puts "\nYou can use also command all Heroku apps for this project:
+      rake all heroku:share"
+
+    exit(1)
+  end
+end
+
+def push(commit, repo)
+  commit ||= "HEAD"
+  @git_push_arguments ||= []
+  begin
+    sh "git update-ref refs/heroku_san/deploy #{commit}"
+    sh "git push #{repo} #{@git_push_arguments.join(' ')} refs/heroku_san/deploy:refs/heads/master"
+  ensure
+    sh "git update-ref -d refs/heroku_san/deploy"
+  end
+end
+
+def migrate(app)
+  sh "heroku rake --app #{app} db:migrate"
+  sh "heroku restart --app #{app}"
+end
+
+def maintenance(app, action)
+  sh "heroku maintenance:#{action} --app #{app}"
+end

data/lib/heroku_san.rb

@@ -0,0 +1,4 @@
+require 'heroku_san/railtie.rb' if defined?(Rails) && Rails::VERSION::MAJOR == 3
+
+module HerokuSan
+end

data/lib/tasks/heroku.rake

@@ -0,0 +1 @@
+require File.expand_path(File.join(File.dirname(__FILE__), '..', 'heroku_san', 'tasks'))

data/lib/templates/heroku.example.yml

@@ -0,0 +1,22 @@
+#
+# Format:
+# 
+# <heroku_san shorthand name>:
+#   app: <Heroku app name>
+#   config:
+#     - <Heroku config:var name>: <Heroku config:var value>
+#
+production: 
+  app: awesomeapp
+  config:
+    - BUNDLE_WITHOUT: "development:test"
+    - GOOGLE_ANALYTICS: "UA-12345678-1"
+
+staging:
+  app: awesomeapp-staging
+  config: &default
+    - BUNDLE_WITHOUT: "development:test"
+
+demo: 
+  app: awesomeapp-demo
+  config: *default

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: heroku_san_gt
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 8
+  version: 1.0.8
+platform: ruby
+authors: 
+- Elijah Miller
+- Glenn Roberts
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-01-06 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: heroku
+  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: Manage multiple Heroku instances/apps for a single Rails app using Rake
+email: elijah.miller@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- Rakefile
+- lib/heroku_san.rb
+- lib/heroku_san/railtie.rb
+- lib/heroku_san/tasks.rb
+- lib/tasks/heroku.rake
+- lib/templates/heroku.example.yml
+has_rdoc: true
+homepage: http://github.com/glennr/heroku_san
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: A bunch of useful Rake tasks for managing your Heroku apps
+test_files: []
+