opsworks-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3dce3800bcff9f369454aab457becf9716146ad9
+  data.tar.gz: 76c70f6e2ef658083f9643ada130827ba584878a
+SHA512:
+  metadata.gz: 507226df1efe63108f37d6f202389b1d429d1df580ce80f72b1a39ffffa9794641872ce8d2dca1b594f46ba9d4d96240500fb7343fd3bcb1bf5248cf7ddf0319
+  data.tar.gz: 818cf0dc76e545f5a754792131ef02acd9526bfb97d7331524f05f52ada266cc3fd17465df5ecbbc582c7dfbde194d753a96ea492f3c71672cf1efa0baf54d83

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,3 @@
+rvm:
+  - 2.0.0
+  - jruby

data/Gemfile

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

data/LICENSE.md

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Aptible, Inc.
+
+MIT 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/README.md

@@ -0,0 +1,53 @@
+# ![](https://raw.github.com/aptible/straptible/master/lib/straptible/rails/templates/public.api/icon-60px.png) OpsWorks::CLI
+
+[![Gem Version](https://badge.fury.io/rb/opsworks-cli.png)](https://rubygems.org/gems/opsworks-cli)
+[![Build Status](https://travis-ci.org/aptible/opsworks-cli.png?branch=master)](https://travis-ci.org/aptible/opsworks-cli)
+[![Dependency Status](https://gemnasium.com/aptible/opsworks-cli.png)](https://gemnasium.com/aptible/opsworks-cli)
+
+An alternative CLI for Amazon OpsWorks, focused on managing a large number of similarly provisioned stacks.
+
+## Installation
+
+Install the gem:
+
+    gem install 'opsworks-cli'
+
+## Configuration
+
+The gem expects to have access to your AWS access key ID and secret access key. You can configure this in either of two ways. First, you may set the following environment variables:
+
+    export AWS_ACCESS_KEY_ID=...
+    export AWS_SECRET_ACCESS_KEY=...
+
+If you're on OS X, you may also use the [aws-keychain-util](https://github.com/zwily/aws-keychain-util) to password-protect these credentials within the OS X Keychain. To do this, follow the instructions in the gem's README:
+
+    gem install aws-keychain-util
+    aws-creds init
+    aws-creds add
+
+When you add credentials, make sure to name the account `default`.
+
+## Usage
+
+```
+$ opsworks help
+Commands:
+  opsworks deploy [--stack STACK] APP   # Deploy an OpsWorks app
+  opsworks exec [--stack STACK] RECIPE  # Execute a Chef recipe
+  opsworks status [--stack STACK] APP   # Display the most recent deployment of an app
+  opsworks update [--stack STACK]       # Update OpsWorks custom cookbooks
+  opsworks version                      # Print OpsWorks CLI version
+```
+
+## Contributing
+
+1. Fork the project.
+1. Commit your changes, with specs.
+1. Ensure that your code passes specs (`rake spec`) and meets Aptible's Ruby style guide (`rake rubocop`).
+1. Create a new pull request on GitHub.
+
+## Copyright and License
+
+MIT License, see [LICENSE](LICENSE.md) for details.
+
+Copyright (c) 2014 [Aptible](https://www.aptible.com), Frank Macreery, and contributors.

data/Rakefile

@@ -0,0 +1,4 @@
+require 'bundler/gem_tasks'
+
+require 'aptible/tasks'
+Aptible::Tasks.load_tasks

data/bin/opsworks

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'opsworks/cli'
+rescue
+  require 'rubygems'
+  require 'opsworks/cli'
+end
+
+OpsWorks::CLI::Agent.start

data/lib/opsworks/app.rb

@@ -0,0 +1,31 @@
+require_relative 'resource'
+require_relative 'deployment'
+
+module OpsWorks
+  class App < Resource
+    attr_accessor :id, :name
+
+    def deployments
+      @deployments ||= initialize_deployments
+      @deployments || []
+    end
+
+    def last_deployment
+      deployments.find(&:success?)
+    end
+
+    private
+
+    def initialize_deployments
+      return nil unless id
+      response = self.class.client.describe_deployments(app_id: id)
+      response.data[:deployments].map do |hash|
+        Deployment.new(
+          id: hash[:deployment_id],
+          created_at: hash[:created_at],
+          status: hash[:status]
+        )
+      end
+    end
+  end
+end

data/lib/opsworks/cli/agent.rb

@@ -0,0 +1,32 @@
+require 'thor'
+require 'aws'
+
+require_relative 'helpers/keychain'
+require_relative 'helpers/options'
+
+require_relative 'subcommands/update'
+require_relative 'subcommands/exec'
+require_relative 'subcommands/deploy'
+require_relative 'subcommands/status'
+
+require 'opsworks/stack'
+require 'opsworks/app'
+require 'opsworks/deployment'
+
+module OpsWorks
+  module CLI
+    class Agent < Thor
+      include Thor::Actions
+
+      include Subcommands::Update
+      include Subcommands::Exec
+      include Subcommands::Deploy
+      include Subcommands::Status
+
+      desc 'version', 'Print OpsWorks CLI version'
+      def version
+        puts "opsworks-cli v#{OpsWorks::CLI::VERSION}"
+      end
+    end
+  end
+end

data/lib/opsworks/cli/helpers/keychain.rb

@@ -0,0 +1,25 @@
+module OpsWorks
+  module CLI
+    module Helpers
+      module Keychain
+        KEYCHAIN = 'aws'
+
+        def fetch_keychain_credentials(account = 'default')
+          require 'aws-keychain-util/credential_provider'
+
+          provider = AwsKeychainUtil::CredentialProvider.new(
+            account, KEYCHAIN
+          )
+          AWS.config(credential_provider: provider) if provider.set?
+        rescue LoadError
+          # Keychain utility is optional and only relevant on OS X
+          nil
+        end
+
+        def env_credentials?
+          !!(ENV['AWS_ACCESS_KEY_ID'] && ENV['AWS_SECRET_ACCESS_KEY'])
+        end
+      end
+    end
+  end
+end

data/lib/opsworks/cli/helpers/options.rb

@@ -0,0 +1,17 @@
+require 'opsworks/stack'
+
+module OpsWorks
+  module CLI
+    module Helpers
+      module Options
+        def parse_stacks(options = {})
+          stacks = OpsWorks::Stack.all
+          if options[:stack]
+            stacks.select! { |stack| stack.name == options[:stack] }
+          end
+          stacks
+        end
+      end
+    end
+  end
+end

data/lib/opsworks/cli/subcommands/deploy.rb

@@ -0,0 +1,27 @@
+module OpsWorks
+  module CLI
+    module Subcommands
+      module Deploy
+        # rubocop:disable MethodLength
+        # rubocop:disable CyclomaticComplexity
+        def self.included(thor)
+          thor.class_eval do
+            desc 'deploy [--stack STACK] APP', 'Deploy an OpsWorks app'
+            option :stack
+            def deploy(name)
+              fetch_keychain_credentials unless env_credentials?
+              stacks = parse_stacks(options)
+              stacks.each do |stack|
+                next unless (app = stack.find_app_by_name(name))
+                say "Deploying to #{stack.name}..."
+                stack.deploy_app(app)
+              end
+            end
+          end
+        end
+        # rubocop:enable CyclomaticComplexity
+        # rubocop:enable MethodLength
+      end
+    end
+  end
+end

data/lib/opsworks/cli/subcommands/exec.rb

@@ -0,0 +1,26 @@
+module OpsWorks
+  module CLI
+    module Subcommands
+      module Exec
+        # rubocop:disable MethodLength
+        # rubocop:disable CyclomaticComplexity
+        def self.included(thor)
+          thor.class_eval do
+            desc 'exec [--stack STACK] RECIPE', 'Execute a Chef recipe'
+            option :stack
+            def exec(recipe)
+              fetch_keychain_credentials unless env_credentials?
+              stacks = parse_stacks(options)
+              stacks.each do |stack|
+                say "Executing recipe on #{stack.name}..."
+                stack.execute_recipe(recipe)
+              end
+            end
+          end
+        end
+        # rubocop:enable CyclomaticComplexity
+        # rubocop:enable MethodLength
+      end
+    end
+  end
+end

data/lib/opsworks/cli/subcommands/status.rb

@@ -0,0 +1,43 @@
+module OpsWorks
+  module CLI
+    module Subcommands
+      module Status
+        # rubocop:disable MethodLength
+        # rubocop:disable CyclomaticComplexity
+        def self.included(thor)
+          thor.class_eval do
+            include Helpers::Keychain
+            include Helpers::Options
+
+            desc 'status [--stack STACK] APP',
+                 'Display the most recent deployment of an app'
+            option :stack
+            def status(name)
+              fetch_keychain_credentials unless env_credentials?
+
+              table = parse_stacks(options).map do |stack|
+                next unless (app = stack.find_app_by_name(name))
+                if (deployment = app.last_deployment)
+                  deployed_at = formatted_time(deployment.created_at)
+                else
+                  deployed_at = '-'
+                end
+                [stack.name, name, deployed_at]
+              end
+              table.compact!
+              print_table table
+            end
+
+            private
+
+            def formatted_time(timestamp)
+              timestamp.strftime('%Y-%m-%d %H:%M:%S %Z')
+            end
+          end
+        end
+        # rubocop:enable CyclomaticComplexity
+        # rubocop:enable MethodLength
+      end
+    end
+  end
+end

data/lib/opsworks/cli/subcommands/update.rb

@@ -0,0 +1,31 @@
+require 'aws'
+
+module OpsWorks
+  module CLI
+    module Subcommands
+      module Update
+        # rubocop:disable MethodLength
+        # rubocop:disable CyclomaticComplexity
+        def self.included(thor)
+          thor.class_eval do
+            include Helpers::Keychain
+            include Helpers::Options
+
+            desc 'update [--stack STACK]', 'Update OpsWorks custom cookbooks'
+            option :stack
+            def update
+              fetch_keychain_credentials unless env_credentials?
+              stacks = parse_stacks(options)
+              stacks.each do |stack|
+                say "Updating #{stack.name}..."
+                stack.update_custom_cookbooks
+              end
+            end
+          end
+        end
+        # rubocop:enable CyclomaticComplexity
+        # rubocop:enable MethodLength
+      end
+    end
+  end
+end

data/lib/opsworks/cli/version.rb

@@ -0,0 +1,5 @@
+module OpsWorks
+  module CLI
+    VERSION = '0.1.0'
+  end
+end

data/lib/opsworks/cli.rb

@@ -0,0 +1,7 @@
+require 'opsworks/cli/version'
+require 'opsworks/cli/agent'
+
+module OpsWorks
+  module CLI
+  end
+end

data/lib/opsworks/deployment.rb

@@ -0,0 +1,17 @@
+require_relative 'resource'
+
+module OpsWorks
+  class Deployment < Resource
+    attr_accessor :id, :status, :created_at
+
+    def success?
+      status == 'successful'
+    end
+
+    def created_at
+      Time.parse(@created_at)
+    rescue
+      @created_at
+    end
+  end
+end

data/lib/opsworks/resource.rb

@@ -0,0 +1,17 @@
+module OpsWorks
+  class Resource
+    def initialize(options = {})
+      options.each do |key, value|
+        send("#{key}=", value) if respond_to?("#{key}=")
+      end
+    end
+
+    def self.client
+      @client ||= AWS::OpsWorks::Client.new
+    end
+
+    def self.account
+      ENV['ACCOUNT'] || @account || 'opsworks-cli'
+    end
+  end
+end

data/lib/opsworks/stack.rb

@@ -0,0 +1,58 @@
+require_relative 'resource'
+require_relative 'app'
+
+module OpsWorks
+  class Stack < Resource
+    attr_accessor :id, :name
+
+    def self.all
+      client.describe_stacks.data[:stacks].map do |hash|
+        new(id: hash[:stack_id], name: hash[:name])
+      end
+    end
+
+    def self.find_by_name(name)
+      all.find { |stack| stack.name == name }
+    end
+
+    def apps
+      @apps ||= initialize_apps
+      @apps || []
+    end
+
+    def find_app_by_name(name)
+      apps.find { |app| app.name == name }
+    end
+
+    def update_custom_cookbooks
+      create_deployment(command: { name: 'update_custom_cookbooks' })
+    end
+
+    def execute_recipe(recipe)
+      create_deployment(
+        command: {
+          name: 'execute_recipes',
+          args: { 'recipes' => [recipe] }
+        }
+      )
+    end
+
+    def deploy_app(app)
+      fail 'App not found' unless app && app.id
+      create_deployment(app_id: app.id, command: { name: 'deploy' })
+    end
+
+    private
+
+    def initialize_apps
+      return nil unless id
+      self.class.client.describe_apps(stack_id: id).data[:apps].map do |hash|
+        App.new(id: hash[:app_id], name: hash[:name])
+      end
+    end
+
+    def create_deployment(options = {})
+      self.class.client.create_deployment(options.merge(stack_id: id))
+    end
+  end
+end

data/opsworks-cli.gemspec

@@ -0,0 +1,31 @@
+# encoding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'English'
+require 'opsworks/cli/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'opsworks-cli'
+  spec.version       = OpsWorks::CLI::VERSION
+  spec.authors       = ['Frank Macreery']
+  spec.email         = ['frank@macreery.com']
+  spec.description   = %q(OpsWorks CLI)
+  spec.summary       = %q(Alternative CLI for Amazon OpsWorks)
+  spec.homepage      = 'https://github.com/aptible/opsworks-cli'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($RS)
+  spec.test_files    = spec.files.grep(/^spec\//)
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'thor'
+  spec.add_dependency 'aws-sdk'
+
+  spec.add_development_dependency 'aws-keychain-util'
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'aptible-tasks'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 2.0'
+  spec.add_development_dependency 'pry'
+end

data/spec/opsworks/cli/agent_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe OpsWorks::CLI::Agent do
+  before { subject.stub(:ask) }
+
+  describe '#version' do
+    it 'should print the version' do
+      version = OpsWorks::CLI::VERSION
+      expect(STDOUT).to receive(:puts).with "opsworks-cli v#{version}"
+      subject.version
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+# Load shared spec files
+Dir["#{File.dirname(__FILE__)}/shared/**/*.rb"].each do |file|
+  require file
+end
+
+# Require library up front
+require 'opsworks/cli'

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: opsworks-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Frank Macreery
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-05-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-keychain-util
+  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: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: aptible-tasks
+  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: rake
+  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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  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'
+description: OpsWorks CLI
+email:
+- frank@macreery.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/opsworks
+- lib/opsworks/app.rb
+- lib/opsworks/cli.rb
+- lib/opsworks/cli/agent.rb
+- lib/opsworks/cli/helpers/keychain.rb
+- lib/opsworks/cli/helpers/options.rb
+- lib/opsworks/cli/subcommands/deploy.rb
+- lib/opsworks/cli/subcommands/exec.rb
+- lib/opsworks/cli/subcommands/status.rb
+- lib/opsworks/cli/subcommands/update.rb
+- lib/opsworks/cli/version.rb
+- lib/opsworks/deployment.rb
+- lib/opsworks/resource.rb
+- lib/opsworks/stack.rb
+- opsworks-cli.gemspec
+- spec/opsworks/cli/agent_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/aptible/opsworks-cli
+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.2.2
+signing_key: 
+specification_version: 4
+summary: Alternative CLI for Amazon OpsWorks
+test_files:
+- spec/opsworks/cli/agent_spec.rb
+- spec/spec_helper.rb