awsstack 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f3a649d0e04854b4207945c9b426ee5b0e7b6b9a
+  data.tar.gz: 4882820003b414f5be911d8f5d4e737b06c670bc
+SHA512:
+  metadata.gz: 2c605604f0e32d83829e4af3005ffbcc89c315794763cf686d5bb61d996708b7688a1d6f531526379be86e837273c54d2d28901875eb88b60e6cb5720d04765d
+  data.tar.gz: 1fb5979a4e5bab43422dea729ee16c18c5c31db7c0d8b649dcb2b2d5a3d789e4274618c0b7f318f45ca3dc9dc1987b9583f02f7b897ede0aa5230ec2bd8ea105

data/.gitignore

@@ -0,0 +1,12 @@
+.bundle/
+vendor/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem
+.aws_session*

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.13.3

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in awsstack.gemspec
+gemspec

data/README.md

@@ -0,0 +1,83 @@
+# Awsstack
+
+AWS CloudFormation stack creation helper
+
+## Building
+
+Clone this repository and run
+
+    gem build awsstack.gemspec
+
+This will create `awsstack-<version>.gem`
+
+you can then install this gem
+
+    [sudo] gem install awsstack-<version>.gem
+
+## Usage
+
+    awsstack --help
+        /usr/local/bin/awsstack [OPTION]
+
+        -h, --help:
+        show help
+
+        -r, --role <rolename>
+        IAM role to use. From ~/.aws/config
+
+        -o, --operation <operation>
+        Operation to perform on the template. (...)
+        Operations :
+          check   Check a template on AWS
+          create  Create a stack
+          update  Update a stack
+          delete  Delete a stack
+
+        -s, --stackname <stackname>
+        Stackname to operate on.
+
+        -t, --templatefile <file>
+        Template file to use. (JSON format)
+
+        -p, --paramfile <file>
+        Optional Parameter file. (JSON format)
+
+        -e, --environment <environment>
+        Execution environment. (dev, stag, prod, ...)
+
+        -d, --debug [level]:
+        Debug level.
+
+( Todo: Debug Level is not implemented )
+
+### example use
+
+    awsstack -r vrt-dpc-sandbox-admin -t output/aem_author.json -e dev -s Aemsecuritydev -o create
+
+### params file
+
+To pass parameters to the CFN with this script, create a json file with the same
+name as the template file but in the directory <repo>/params/<env>/<template>
+The content should look like this.
+
+This file will automatically be used and the params passed to CFN.
+
+    {
+        "Parameters": {
+            "AemEnvironmentNameParameter": "stag",
+            "LabelOwner": "zipkid"
+        }
+    }
+
+You can also pass a --paramfile option specifying an alternate params file
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also 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`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/awsstack.

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/awsstack.gemspec

@@ -0,0 +1,38 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'awsstack/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'awsstack'
+  spec.version       = AwsStack::VERSION
+  spec.licenses      = ['MIT']
+  spec.authors       = ['Stefan - Zipkid - Goethals']
+  spec.email         = ['stefan.goethals@vrt.be']
+
+  spec.summary       = 'AWS stack handling helper script.'
+  spec.description   = 'AWS stack handling helper script.'
+  spec.homepage      = 'https://github.com/'
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  end
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+
+  spec.add_runtime_dependency 'aws_config', '~> 0.1', '>= 0.1.0'
+  spec.add_runtime_dependency 'aws-sdk', '~> 2.8', '>= 2.8.4'
+  spec.add_runtime_dependency 'awssession'
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "awsstack"
+
+# 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/setup

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

data/exe/awsstack

@@ -0,0 +1,109 @@
+#!/usr/bin/env ruby
+require 'getoptlong'
+require 'pp'
+
+require 'aws_config'
+require 'awssession'
+require 'awsstack'
+
+def clidoc
+  puts <<-CLIDOC
+
+    #{$PROGRAM_NAME} [OPTION]
+
+    -h, --help:
+    show help
+
+    -r, --role <rolename>
+    IAM role to use. From ~/.aws/config
+
+    -s, --stackname <stackname>
+    Stackname to operate on.
+
+    -t, --templatefile <file>
+    Template file to use. (JSON format)
+
+    -e, --environment <environment>
+    Execution environment. (dev, stag, prod, ...)
+    Needed for automatic param file detection.
+
+    -p, --paramfile <file>
+    Optional Parameter file. (JSON format)
+
+    -o, --operation <operation>
+    Operation to perform on the template. (...)
+    Operations :
+      check   Check a template on AWS
+      create  Create a stack
+      update  Update a stack
+      delete  Delete a stack
+
+    -d, --debug [level]:
+    Debug level.
+
+  CLIDOC
+end
+
+opts = GetoptLong.new(
+  ['--help', '-h', GetoptLong::NO_ARGUMENT],
+  ['--role', '-r', GetoptLong::REQUIRED_ARGUMENT],
+  ['--stackname', '-s', GetoptLong::REQUIRED_ARGUMENT],
+  ['--templatefile', '-t', GetoptLong::REQUIRED_ARGUMENT],
+  ['--paramfile', '-p', GetoptLong::REQUIRED_ARGUMENT],
+  ['--environment', '-e', GetoptLong::REQUIRED_ARGUMENT],
+  ['--operation', '-o', GetoptLong::REQUIRED_ARGUMENT],
+  ['--debug', '-d', GetoptLong::OPTIONAL_ARGUMENT]
+)
+
+role = nil
+operation = nil
+stackname = nil
+templatefile = nil
+paramfile = nil
+environment = nil
+debug = 0
+
+opts.each do |opt, arg|
+  case opt
+  when '--help'
+    clidoc
+    exit
+  when '--role'
+    role = arg
+  when '--operation'
+    operation = arg
+  when '--stackname'
+    stackname = arg
+  when '--templatefile'
+    templatefile = arg
+  when '--paramfile'
+    paramfile = arg
+  when '--environment'
+    environment = arg
+  when '--debug'
+    debug = if arg == ''
+              1
+            else
+              arg.to_i
+            end
+  end
+end
+
+profile_name = role
+profile = AWSConfig[profile_name]
+profile['name'] = profile_name
+
+awssession = AwsSession.new(profile: profile)
+awssession.start
+
+AwsStack::CloudFormation.new(
+  credentials: awssession.credentials,
+  operation: operation,
+  stackname: stackname,
+  templatefile: templatefile,
+  paramfile: paramfile,
+  environment: environment,
+  debug: debug
+)
+
+# vim:set fileencoding=utf8 fileformat=unix filetype=ruby tabstop=2 expandtab:

data/lib/awsstack.rb

@@ -0,0 +1,6 @@
+require 'awsstack/version'
+require 'awsstack/cloudformation'
+
+module Awsstack
+  # Your code goes here...
+end

data/lib/awsstack/cfntemplate.rb

@@ -0,0 +1,75 @@
+require 'aws-sdk'
+
+module AwsStack
+  # AWS CFN template file handling
+  class CfnTemplate
+    attr_reader :body, :url
+    def initialize(options)
+      @credentials = options[:credentials]
+      @templatefile = options[:templatefile]
+      @stackname = options[:stackname]
+      @bucket_name = 'awsstack.cloudformation.templates'
+      @bucket_template_filename = "#{@stackname}_#{File.basename(@templatefile)}"
+      template
+    end
+
+    def delete_template
+      s3.delete_object(
+        bucket: @bucket_name,
+        key: @bucket_template_filename
+      )
+    end
+
+    private
+
+    def template
+      case File.size? @templatefile
+      when nil, 0
+        raise "Template file : '#{@templatefile}', not found or zero length."
+      when 1..51_200
+        @body = template_file_body
+      when 51_201..460_800
+        @url = template_url
+      else
+        raise "Template file : '#{@templatefile}', Too large. (> 460.800 bytes)"
+      end
+    end
+
+    def template_file_body
+      File.open(@templatefile, 'r').read
+    end
+
+    def template_url
+      create_bucket unless bucket_exist?
+      put_template
+      "https://s3.amazonaws.com/#{@bucket_name}/#{@bucket_template_filename}"
+    end
+
+    def put_template
+      s3.put_object(
+        bucket: @bucket_name,
+        key: @bucket_template_filename,
+        body: template_file_body
+      )
+    end
+
+    def create_bucket
+      s3.create_bucket(
+        bucket: @bucket_name
+      )
+    end
+
+    def bucket_exist?
+      s3.head_bucket(
+        bucket: @bucket_name
+      )
+      true
+    rescue Aws::S3::Errors::NotFound # , Aws::S3::Errors::Http301Error
+      false
+    end
+
+    def s3
+      @s3 || @s3 = Aws::S3::Client.new(credentials: @credentials)
+    end
+  end
+end

data/lib/awsstack/cloudformation.rb

@@ -0,0 +1,146 @@
+require 'aws-sdk'
+require 'awsstack/cfntemplate'
+
+module AwsStack
+  # AWS Session creation with profile
+  class CloudFormation
+    def initialize(options)
+      @credentials = options[:credentials]
+      create_cfn_client
+      @operation = options[:operation].to_sym
+      @stackname = options[:stackname]
+      @templatefile = options[:templatefile]
+      @paramfile = options[:paramfile]
+      @environment = options[:environment]
+      @debug = options[:debug]
+
+      if public_methods.include?(@operation)
+        public_send @operation
+      else
+        puts "Requested operation '#{@operation}' is not a public method."
+      end
+    end
+
+    def check
+      raise unless validate_template
+      puts "Template '#{@templatefile}' validated! OK."
+    end
+
+    def create
+      check
+      @params = read_param_file
+      pp create_stack
+    end
+
+    def update
+      check
+      @params = read_param_file
+      update_stack
+    end
+
+    def delete
+      delete_stack
+      puts 'Delete started...'
+    end
+
+    def operation_names
+      pp @cfn.operation_names
+    end
+
+    private
+
+    def create_cfn_client
+      @cfn = Aws::CloudFormation::Client.new(credentials: @credentials)
+    end
+
+    def read_file(file)
+      File.open(file, 'r').read
+    end
+
+    def template
+      @template_instance || @template_instance = AwsStack::CfnTemplate.new(
+        credentials: @credentials, templatefile: @templatefile, stackname: @stackname
+      )
+    end
+
+    def read_param_file
+      param_file = if @paramfile.class == NilClass
+                     "params/#{@environment}/#{File.basename @templatefile}"
+                   else
+                     @paramfile
+                   end
+      return unless File.file? param_file
+      param_string = read_file param_file
+      prepare_params JSON.parse(param_string)['Parameters']
+    end
+
+    def prepare_params(params)
+      params.map do |key, value|
+        {
+          parameter_key: key,
+          parameter_value: value,
+          use_previous_value: false
+        }
+      end
+    end
+
+    def list_stacks
+      @cfn.list_stacks
+    end
+
+    def validate_template
+      @cfn.validate_template(
+        template_body: template.body,
+        template_url: template.url
+      )
+    end
+
+    def create_stack
+      @cfn.create_stack(
+        stack_name: @stackname, # required
+        template_body: template.body,
+        template_url: template.url,
+        capabilities: ['CAPABILITY_IAM'],
+        parameters: @params
+      ).stack_id
+    rescue Aws::CloudFormation::Errors::AlreadyExistsException, Aws::CloudFormation::Errors::ValidationError => e
+      puts "#{e.class} : #{e.message}"
+      exit 1
+    end
+
+    def update_stack
+      @cfn.update_stack(
+        stack_name: @stackname, # required
+        template_body: template.body,
+        template_url: template.url,
+        capabilities: ['CAPABILITY_IAM'],
+        parameters: @params
+      ).stack_id
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      puts "#{e.class} : #{e.message}"
+      exit 1
+    end
+
+    def delete_stack
+      @cfn.delete_stack(
+        stack_name: @stackname, # required
+      )
+    end
+
+    def create_change_set
+      @cfn.create_change_set
+    end
+
+    def describe_change_set
+      @cfn.describe_change_set
+    end
+
+    def execute_change_set
+      @cfn.execute_change_set
+    end
+
+    def delete_change_set
+      @cfn.delete_change_set
+    end
+  end
+end

data/lib/awsstack/version.rb

@@ -0,0 +1,3 @@
+module AwsStack
+  VERSION = '0.2.1'.freeze
+end

data/license.txt

@@ -0,0 +1,19 @@
+Copyright 2017 VRT.be
+
+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.

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: awsstack
+version: !ruby/object:Gem::Version
+  version: 0.2.1
+platform: ruby
+authors:
+- Stefan - Zipkid - Goethals
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-10-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !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: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: aws_config
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.4
+- !ruby/object:Gem::Dependency
+  name: awssession
+  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'
+description: AWS stack handling helper script.
+email:
+- stefan.goethals@vrt.be
+executables:
+- awsstack
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- awsstack.gemspec
+- bin/console
+- bin/setup
+- exe/awsstack
+- lib/awsstack.rb
+- lib/awsstack/cfntemplate.rb
+- lib/awsstack/cloudformation.rb
+- lib/awsstack/version.rb
+- license.txt
+homepage: https://github.com/
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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.6.13
+signing_key: 
+specification_version: 4
+summary: AWS stack handling helper script.
+test_files: []