falcon-deploy 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c7fd9615428f431856772761ff23f41ab91e0a69
+  data.tar.gz: 579b582c62dbdb5d46b1e5aa0517a76f7d6b3d7e
+SHA512:
+  metadata.gz: 31fb8b50d13fe8083cc60a19ba0f893ab8f8a74dae230b5bc53000fb211e9f53671b4b57172961589939af024466cb3a12aeb7caa25160b8a360b8323ed740ca
+  data.tar.gz: 570e348a90ae096f74d98d40e80217f1e01b78bc5b8cb7963a46ec368f500c40f525375f3600169d7a5faf19f8cfb0a7dbfdbfeadf8c5d54d909681707c9f5b2

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.2

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Sasha Klein
+
+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.md

@@ -0,0 +1,68 @@
+# Falcon Deploy
+
+A simple wrapper to make it easier and less nerve-wracking to deploy to Heroku and roll code back when you mess things up. 
+
+![falcon](http://static3.businessinsider.com/image/547378e869bedd312b36685a/landing.gif)
+
+Inspired by Space X's awesome Falcon rocket, which is working towards the first combined take-off and safe landing, and drawn from [this gist](https://gist.github.com/guapolo/28729b95a7ef6b1aacf5).
+
+Falcon aims to be a simple, pared-down, easy-to-use (and easy-to-maintain) solution to a very specific problem.
+
+## Installation
+
+> Note: This gem is built to use Heroku Toolbelt. It won't do anything if you don't have the Toolbelt installed. 
+
+Add to your Gemfile (`:development` group is fine):
+
+```ruby
+gem 'falcon-deploy'
+```
+
+And then execute:
+
+    $ bundle
+
+## Usage
+
+Falcon is run from the command line. It takes two arguments, `appname` and `command`, and an optional `--force` (or `-f`) flag.
+
+The commands are: 
+
+- `deploy` - Deploy code to your app.
+- `migrations` - Deploy code to your app, turn on maintenance mode, run accompanying migrations, and turn maintenance off.
+- `rollback` - Roll back the most recent deploy. This will *not* reverse migrations, so as the instructions stipulate, run `rake db:rollback` before this command as necessary.
+
+The optional `-f` flag disables the above rollback warning. 
+
+Some examples: 
+
+```bash
+falcon staging-appname deploy
+# => Deploy code to your staging app
+
+falcon my-prod-app migrations
+# => Deploy code to production app, turn on maintenance mode, run accompanying migrations, and turn maintenance off
+
+
+falcon app-name rollback -f
+# => You will not be warned about migrations; falcon will go ahead and reverse the previous deploy
+
+falcon help
+# => ?
+```
+
+## Development
+
+The usual:
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/sashafklein/falcon/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/falcon

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+require "falcon"
+require 'trollop'
+
+input = ARGV
+
+opts = Trollop::options do
+  opt :force, "Ignore warnings", short: :f
+end
+
+appname, command = input[0], input[1]
+
+if input.length != 2 || !%w( deploy migrations rollback).include?( command )
+  puts Falcon::Deploy.help
+else
+  Falcon::Deploy.new( appname, opts[:force] ).run( command )
+end

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/falcon.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'falcon/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "falcon-deploy"
+  spec.version       = Falcon::VERSION
+  spec.authors       = ["Sasha Klein"]
+  spec.email         = ["sashafklein@gmail.com"]
+
+  spec.summary       = %q{A Heroku wrapper to simplify and de-risk app deployment, migrations, and rollbacks.}
+  spec.homepage      = "http://www.sashafklein.com/portfolio#falcon"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.executables   = ['falcon']
+  spec.require_paths = ["lib"]
+
+  spec.test_files = spec.files.grep(%r{^(spec)/})
+  
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "binding_of_caller"
+  spec.add_runtime_dependency "trollop", '2.1.2'
+end

data/lib/falcon.rb

@@ -0,0 +1,72 @@
+require "falcon/version"
+require 'heroku_deployer'
+
+module Falcon
+
+  class Deploy
+
+    attr_reader :env, :appname, :force
+    def initialize(appname, force=false)
+      @appname = appname
+      @force = force
+    end
+
+    def self.help
+      %Q{
+        USAGE: `falcon [appname] [command] [flags]`
+        APPNAME: Your Heroku app name
+        COMMANDS: 
+        - `deploy` - deploy the code
+        - `migrations` - deploy and run migrations
+        - `rollback` - reverse the latest code deploy (does NOT reverse migrations)
+        FLAGS
+        - `-f`, `--force` - force rollback etc
+      }
+    end
+
+    def run(command)
+      if respond_to? command
+        send command
+      else
+        puts "The command '#{command}' is not valid.\n"
+        puts self.class.help
+      end
+    end
+
+    def deploy
+      deployer.deploy
+    end
+
+    def migrations
+      deployer.migrations
+    end
+
+    def rollback
+      unless force
+        puts rollback_warning
+        
+        answer = STDIN.gets.strip
+
+        return (puts "Rollback cancelled.") unless %w( y yes ).include?( answer.downcase )
+      end
+
+      deployer.rollback
+    end
+
+    def deployer
+      @deployer ||= HerokuDeployer.new( appname )
+    end
+
+    def rollback_warning
+      %Q{
+        This command does NOT reverse migrations. 
+        If you want to reverse a migration, please do so manually:
+          `heroku run rake db:rollback`
+        Then run this command again.
+
+        Continue (without DB rollback)? Y/N
+      }
+    end
+  end
+ 
+end

data/lib/falcon/version.rb

@@ -0,0 +1,3 @@
+module Falcon
+  VERSION = "0.1.1"
+end

data/lib/heroku_deployer.rb

@@ -0,0 +1,108 @@
+class HerokuDeployer
+
+  attr_reader :app
+  def initialize(app)
+    @app = app
+    raise "No app flag configured!" unless @app
+  end
+ 
+  def migrations
+    push; turn_app_off; migrate; restart; turn_app_on; tag;
+  end
+ 
+  def deploy
+    push; restart; tag;
+  end
+ 
+  def rollback
+    turn_app_off; push_previous; restart; turn_app_on;
+  end
+ 
+  private
+ 
+  def push
+    current_branch = `git rev-parse --abbrev-ref HEAD`.chomp
+    branch_to_branch = (current_branch.length > 0) ? "#{current_branch}:master" : ""
+    puts "Deploying site to Heroku (#{@app}) ..."
+    puts "git push -f git@heroku.com:#{@app}.git #{branch_to_branch}"
+    puts `git push -f git@heroku.com:#{@app}.git #{branch_to_branch}`
+  end
+ 
+  def restart
+    puts 'Restarting app servers ...'
+    Bundler.with_clean_env { run_and_log(`heroku restart --app #{@app}`) }
+  end
+ 
+  def tag
+    release_name = "#{@app}_release-#{Time.now.utc.strftime("%Y%m%d%H%M%S")}"
+    puts "Tagging release as '#{release_name}'"
+    puts `git tag -a #{release_name} -m 'Tagged release'`
+    puts `git push --tags git@heroku.com:#{@app}.git`
+  end
+ 
+  def migrate
+    puts 'Running database migrations ...'
+    Bundler.with_clean_env { run_and_log(`heroku run 'bundle exec rake db:migrate' --app #{@app}`) }
+  end
+ 
+  def turn_app_off
+    puts 'Putting the app into maintenance mode ...'
+    Bundler.with_clean_env { run_and_log(`heroku maintenance:on --app #{@app}`) }
+  end
+ 
+  def turn_app_on
+    puts 'Taking the app out of maintenance mode ...'
+    Bundler.with_clean_env { puts `heroku maintenance:off --app #{@app}` }
+  end
+ 
+  def push_previous
+    prefix = "#{@app}_release-"
+    releases = `git tag`.split("\n").select { |t| t[0..prefix.length-1] == prefix }.sort
+    current_release = releases.last
+    previous_release = releases[-2] if releases.length >= 2
+    if previous_release
+      puts "Rolling back to '#{previous_release}' ..."
+ 
+      puts "Checking out '#{previous_release}' in a new branch on local git repo ..."
+      puts `git checkout #{previous_release}`
+      puts `git checkout -b #{previous_release}`
+ 
+      puts "Removing tagged version '#{previous_release}' (now transformed in branch) ..."
+      puts `git tag -d #{previous_release}`
+      puts `git push git@heroku.com:#{@app}.git :refs/tags/#{previous_release}`
+ 
+      puts "Pushing '#{previous_release}' to Heroku master ..."
+      puts `git push git@heroku.com:#{@app}.git +#{previous_release}:master --force`
+ 
+      puts "Deleting rollbacked release '#{current_release}' ..."
+      puts `git tag -d #{current_release}`
+      puts `git push git@heroku.com:#{@app}.git :refs/tags/#{current_release}`
+ 
+      puts "Retagging release '#{previous_release}' in case to repeat this process (other rollbacks)..."
+      puts `git tag -a #{previous_release} -m 'Tagged release'`
+      puts `git push --tags git@heroku.com:#{@app}.git`
+ 
+      puts "Turning local repo checked out on master ..."
+      puts `git checkout master`
+      puts 'All done!'
+    else
+      puts "No release tags found - can't roll back!"
+      puts releases
+    end
+  end
+
+  private
+
+  def run_and_log(command, instance = 1, cap=20)
+    response = command
+    return (puts "Gave up after #{cap} seconds.") if instance >= cap
+    
+    if response.include?("Heroku Toolbelt is currently updating")
+      puts "Stalling to allow for Heroku Toolbelt update. Attempt \##{instance}..."
+      sleep 1
+      run_and_log(command, instance + 1)
+    else
+      puts response
+    end
+  end
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: falcon-deploy
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Sasha Klein
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: binding_of_caller
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 2.1.2
+description: 
+email:
+- sashafklein@gmail.com
+executables:
+- falcon
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/falcon
+- bin/setup
+- falcon.gemspec
+- lib/falcon.rb
+- lib/falcon/version.rb
+- lib/heroku_deployer.rb
+homepage: http://www.sashafklein.com/portfolio#falcon
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: A Heroku wrapper to simplify and de-risk app deployment, migrations, and
+  rollbacks.
+test_files: []