kurgan 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: aa42f950ad3cb1bf07eb4bc1f465bb0f49208eddda21e376038b121e15207d7b
+  data.tar.gz: 1fe9dfd5e80f2bcbce439d520d6bd50b386a7e3bf5225aa344057fba4800071b
+SHA512:
+  metadata.gz: 4c0cc35a6abb39c0a4c1a8bd48f24762f46ac93357fb7302639b265ab9bed5fb27baf6fe86372d6c241f99215494dd54613680e3d150473f856c36336115e9bc
+  data.tar.gz: 03524ea72aff8ca3bf8d31712a5fdd445517091363172f9612f178517c023ef0f732bfdb2132798b0741ea4f65ea9547d199cdf89bf28d3911084cc2c581605a

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+*.gem

data/.travis.yml

@@ -0,0 +1,17 @@
+sudo: required
+dist: trusty
+language: ruby
+rvm:
+  - 2.5
+script:
+  - bundle install
+  - gem build kurgan.gemspec
+  - gem install kurgan-*.gem
+  - kurgan help
+deploy:
+  provider: rubygems
+  api_key: "${RUBYGEMS_API_KEY}"
+  gem: kurgan
+  on:
+   all_branches: true
+   condition: $TRAVIS_BRANCH =~ ^develop|master &&  $TRAVIS_EVENT_TYPE =~ ^push|api$ && $TRAVIS_REPO_SLUG == "theonestack/kurgan"

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 kurgan.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,22 @@
+PATH
+  remote: .
+  specs:
+    kurgan (0.1.1)
+      thor (~> 0.19)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (10.5.0)
+    thor (0.20.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  kurgan!
+  rake (~> 10.0)
+
+BUNDLED WITH
+   1.16.1

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Guslington
+
+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,20 @@
+# Kurgan
+---
+
+[![Build Status](https://travis-ci.org/theonestack/kurgan.svg?branch=develop)](https://travis-ci.org/theonestack/kurgan) [![Join the chat at https://gitter.im/theonestack/cfhighlander](https://badges.gitter.im/theonestack/cfhighlander.svg)](https://gitter.im/theonestack/cfhighlander?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+Tool to manage CfHighlander stacks
+
+```bash
+Commands:
+  kurgan --version, -v     # print the version
+  kurgan add [component]   # Adds a new component to an existing CfHighlander project
+  kurgan component [name]  # Generates a new CfHighlander component
+  kurgan help [COMMAND]    # Describe available commands or one specific command
+  kurgan list              # List available components and latest version from theonestack github
+  kurgan project [name]    # Generates a new CfHighlander project
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/exe/kurgan

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "kurgan"
+
+Kurgan::Cli.start( ARGV )

data/kurgan.gemspec

@@ -0,0 +1,37 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "kurgan/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "kurgan"
+  spec.version       = Kurgan::VERSION
+  spec.authors       = ["Guslington"]
+  spec.email         = ["theonestackcfhighlander@gmail.com"]
+
+  spec.summary       = %q{Manage a cfhighalnder project}
+  spec.description   = %q{Manage a cfhighalnder project}
+  spec.homepage      = "http://iamkurgan.com"
+  spec.license       = "MIT"
+
+  # 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"] = "http://mygemserver.com"
+  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_dependency "thor", "~> 0.19"
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/kurgan.rb

@@ -0,0 +1,39 @@
+require "thor"
+require "json"
+require "kurgan/version"
+require 'kurgan/globals'
+require "kurgan/init"
+require "kurgan/component"
+require "kurgan/add"
+require "kurgan/list"
+
+module Kurgan
+  class Cli < Thor
+
+    map %w[--version -v] => :__print_version
+    desc "--version, -v", "print the version"
+    def __print_version
+      puts Kurgan::VERSION
+    end
+
+    register Kurgan::Init, 'project', 'project [name]', 'Generates a new CfHighlander project'
+    tasks["project"].options = Kurgan::Init.class_options
+
+    register Kurgan::Component, 'component', 'component [name]', 'Generates a new CfHighlander component'
+    tasks["component"].options = Kurgan::Component.class_options
+
+    register Kurgan::Add, 'add', 'add [component]', 'Adds a new component to an existing CfHighlander project'
+    tasks["add"].options = Kurgan::Add.class_options
+
+    desc "list", "List available components and latest version from theonestack github"
+    method_option :filter, aliases: '-f', type: :string, desc: "filter components by service type"
+    method_option :component, aliases: '-c', type: :string, desc: "list all versions for matched components"
+    method_option :update, aliases: '-u', type: :boolean, lazy_default: true, default: false, desc: "Update components list"
+    def list
+      cmd = Kurgan::List.new(options)
+      cmd.execute
+    end
+
+
+  end
+end

data/lib/kurgan/add.rb

@@ -0,0 +1,35 @@
+module Kurgan
+  class Add < Thor::Group
+    include Thor::Actions
+
+    argument :template
+
+    class_option :name, aliases: :n, type: :string
+    class_option :version, aliases: :v, type: :string
+
+    def get_cfhighlander_template
+      @cfhighlander_template = Dir['*.cfhighlander.rb'][0]
+      if @cfhighlander_template.nil?
+        raise "No cfhighlander.rb file found in #{Dir.pwd}"
+      end
+    end
+
+    def get_component_name
+      @name = options[:name] || template
+    end
+
+    def get_template_version
+      @template = options[:version] ? "#{template}@#{options[:version]}" : template
+      say "adding #{@template} to the #{@cfhighlander_template.split('.')[0]} project"
+    end
+
+    def add_component
+      insert_into_file @cfhighlander_template, "  Component name: '#{@name}', template: '#{@template}'\n\n", :before => /^end/
+    end
+
+    def create_config
+      create_file "#{@name}.config.yaml"
+    end
+
+  end
+end

data/lib/kurgan/component.rb

@@ -0,0 +1,43 @@
+require 'kurgan/init'
+
+module Kurgan
+  class Component < Kurgan::Init
+
+    def set_directory
+      @dir = ask "directory name ", default: "hl-component-#{name}"
+      empty_directory @dir
+    end
+
+    def set_description
+      @description = ask "template description ", default: "#{name} - \#{component_version}"
+    end
+
+    def set_template_parameters
+      @parameters = [
+        { name: 'EnvironmentName', default: 'dev', options: 'isGlobal: true' },
+        { name: 'EnvironmentType', default: 'development', options: "allowedValues: ['development','production'], isGlobal: true" }
+      ]
+    end
+
+    def create_cfndsl_template
+      template('templates/cfndsl.rb.tt', "#{@dir}/#{name}.cfndsl.rb")
+    end
+
+    def copy_licence
+      if yes?("Use MIT license?")
+        copy_file "templates/MITLICENSE", "#{@dir}/LICENSE"
+      else
+        say "Skipping license", :yellow
+      end
+    end
+
+    def create_travis_config
+      if yes?("Use Travis-ci?")
+        copy_file "templates/travis.yml.tt", "#{@dir}/travis-ci.yml"
+      else
+        say "skipping travis", :yellow
+      end
+    end
+
+  end
+end

data/lib/kurgan/globals.rb

@@ -0,0 +1,10 @@
+module Kurgan
+  module_function
+
+  def components_file(file = nil)
+    @components_file = file if file
+    @components_file ||= File.join(ENV['HOME'], '.kurgan/components.json')
+    @components_file
+  end
+
+end

data/lib/kurgan/init.rb

@@ -0,0 +1,69 @@
+require 'thor'
+require 'kurgan/projects'
+
+module Kurgan
+  class Init < Thor::Group
+    include Thor::Actions
+
+    argument :name
+
+    class_option :type, aliases: :t, default: 'empty', enum: ['empty','vpc','ecs'], desc: "Create a pre-canned project"
+
+    def self.source_root
+      File.dirname(__FILE__)
+    end
+
+    def set_directory
+      @dir = ask "directory name ", default: name
+      empty_directory @dir
+    end
+
+    def set_description
+      @description = ask "template description ", default: name
+    end
+
+    def set_template_parameters
+      @parameters = Kurgan::Projects.properties[options['type'].to_sym][:parameters]
+    end
+
+    def set_template_components
+      @components = Kurgan::Projects.properties[options['type'].to_sym][:components]
+    end
+
+    def create_cfhighlander_template
+      opts = {parameters: @parameters, components: @components, description: @description}
+      template('templates/cfhighlander.rb.tt', "#{@dir}/#{name}.cfhighlander.rb", opts)
+    end
+
+    def create_config_yaml
+      template 'templates/config.yaml.tt', "#{@dir}/#{name}.config.yaml"
+    end
+
+    def git_init
+      if yes?("git init project?")
+        run "git init #{@dir}"
+        template 'templates/gitignore.tt', "#{@dir}/.gitignore"
+        template 'templates/README.md.tt', "#{@dir}/README.md"
+      else
+        say "Skipping git init", :yellow
+      end
+    end
+
+    def ci_init
+      if yes?("Setup a CI pipeline?")
+        type = ask "CI flavour", limited_to: ['jenkins', 'travis-ci', 'codepipeline']
+        case type
+        when 'jenkins'
+          template('templates/Jenkinsfile.tt', "#{@dir}/Jenkinsfile")
+        when 'travis-ci'
+          template('templates/travis-ci.yaml.tt', "#{@dir}/.travis-ci.yaml")
+        when 'codepipeline'
+          say 'AWS CodePipeline is not supported yet...', :red
+        end
+      else
+        say "Skipping CI setup", :yellow
+      end
+    end
+
+  end
+end

data/lib/kurgan/list.rb

@@ -0,0 +1,59 @@
+require 'open-uri'
+
+module Kurgan
+  class List
+
+    def initialize(options)
+      @filter = options[:filter]
+      @component = options[:component]
+      if options[:update] || !File.exists?(Kurgan.components_file)
+        update_component_list
+      end
+      content = File.read(Kurgan.components_file)
+      @components = JSON.parse(content)['components']
+    end
+
+    def execute
+      puts "\n\s\s============================="
+      puts "\s\s## CfHighlander Components ##"
+      puts "\s\s=============================\n\n"
+      if @component
+        return component
+      elsif @filter
+        return filter
+      else
+        return all
+      end
+    end
+
+    def component
+      components = @components.select { |comp| comp['name'].include? @component }
+      abort "no match for component #{@component}" if !components.any?
+      components.each { |comp| puts "\s\s\s\s#{comp['name']} (#{comp['versions'].join(', ')})" }
+    end
+
+    def filter
+      components = @components.select { |comp| comp['filter'].include? @filter }
+      abort "no match for filter #{@filter}" if !components.any?
+      components.each { |comp| format(comp['name'],comp['latest']) }
+    end
+
+    def all
+      @components.each { |comp| format(comp['name'],comp['latest']) }
+    end
+
+    def format(name,version)
+      version = version != "" ? version : 'latest'
+      puts "\s\s\s\s#{name}@#{version}"
+    end
+
+    def update_component_list
+      puts "Updating components list"
+      FileUtils.mkdir_p File.dirname(Kurgan.components_file)
+      content = open('https://s3-ap-southeast-2.amazonaws.com/cfhighlander-component-specification/components.json').read
+      File.open(Kurgan.components_file, 'w') { |f| f.puts content }
+      puts "Succesfully updated components list #{Kurgan.components_file}"
+    end
+
+  end
+end

data/lib/kurgan/projects.rb

@@ -0,0 +1,33 @@
+module Kurgan
+  class Projects
+    class << self
+
+      attr_reader :properties
+
+      def properties
+        @projects={
+          empty: {
+            components:[],
+            parameters:[]
+          },
+          vpc: {
+            components: [
+              { name: 'vpc', template: 'vpc' }
+            ],
+            parameters: []
+          },
+          ecs: {
+            components: [
+              { name: 'vpc', template: 'vpc' },
+              { name: 'bastion', template: 'bastion'},
+              { name: 'loadbalancer', template: 'loadbalancer'},
+              { name: 'ecs', template: 'ecs'}
+            ],
+            parameters: []
+          }
+        }
+      end
+
+    end
+  end
+end

data/lib/kurgan/templates/Jenkinsfile.tt

@@ -0,0 +1,39 @@
+pipeline {
+
+  environment {
+    AWS_REGION = 'us-east-1'
+    PROJECT_NAME = '<%= @name %>'
+  }
+
+  agent {
+    docker {
+        image 'theonestack/cfhighlander'
+    }
+  }
+
+  stages {
+
+    stage('Compile and validate templates') {
+      steps {
+        sh 'cfndsl -u'
+        sh "cfcompile --validate"
+      }
+    }
+
+    stage('Publish templates to S3') {
+      steps {
+        script {
+          env['VERSION'] = ${env.BRANCH_NAME}-${env.SHORT_COMMIT}
+        }
+        sh "cfpublish ${PROJECT_NAME} --version ${VERSION}"
+      }
+    }
+
+    stage('Deploy') {
+      steps {
+        println "Deploying ${env.PROJECT_NAME} version ${env.VERSION}"
+      }
+    }
+
+  }
+}

data/lib/kurgan/templates/MITLICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 theonestack
+
+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/lib/kurgan/templates/README.md.tt

@@ -0,0 +1,34 @@
+# <%= name %> CfHighlander project
+---
+
+## Cfhighlander Setup
+
+install cfhighlander [gem](https://github.com/theonestack/cfhighlander)
+
+```bash
+gem install cfhighlander
+```
+
+or via docker
+
+```bash
+docker pull theonestack/cfhighlander
+```
+
+compiling the templates
+
+```bash
+cfcompile <%= name %>
+```
+
+compiling with the vaildate fag to validate the templates
+
+```bash
+cfcompile <%= name %> --validate
+```
+
+publish the templates to s3
+
+```bash
+cfpublish <%= name %> --version latest
+```

data/lib/kurgan/templates/cfhighlander.rb.tt

@@ -0,0 +1,17 @@
+CfhighlanderTemplate do
+  Name '<%= name %>'
+  Description "<%= config[:description] %>"
+
+  <%- if config[:parameters].any? -%>
+  Parameters do
+    <%- config[:parameters].each do |param| -%>
+    ComponentParam '<%= param[:name] %>', '<%= param[:default] %>', <%= param[:options] %>
+    <%- end -%>
+  end
+  <%- end -%>
+
+  <%- config[:components].each do |comp| -%>
+  Component template: '<%= comp[:template] %>', name: '<%= comp[:name] %>'
+  <%- end if config[:components].any? -%>
+
+end

data/lib/kurgan/templates/cfndsl.rb.tt

@@ -0,0 +1,3 @@
+CloudFormation do
+  ## Add your cfndsl resources here
+end

data/lib/kurgan/templates/gitignore.tt

@@ -0,0 +1 @@
+out/

data/lib/kurgan/templates/travis.yml.tt

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.3
+script:
+  - gem install cfhighlander
+  - if [ "${TRAVIS_PULL_REQUEST}" != "false" ]; then cfcompile ; else cfcompile --validate; fi%

data/lib/kurgan/version.rb

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

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: kurgan
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Guslington
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-01-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !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'
+description: Manage a cfhighalnder project
+email:
+- theonestackcfhighlander@gmail.com
+executables:
+- kurgan
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/kurgan
+- kurgan.gemspec
+- lib/kurgan.rb
+- lib/kurgan/add.rb
+- lib/kurgan/component.rb
+- lib/kurgan/globals.rb
+- lib/kurgan/init.rb
+- lib/kurgan/list.rb
+- lib/kurgan/projects.rb
+- lib/kurgan/templates/Jenkinsfile.tt
+- lib/kurgan/templates/MITLICENSE
+- lib/kurgan/templates/README.md.tt
+- lib/kurgan/templates/cfhighlander.rb.tt
+- lib/kurgan/templates/cfndsl.rb.tt
+- lib/kurgan/templates/config.yaml.tt
+- lib/kurgan/templates/gitignore.tt
+- lib/kurgan/templates/travis.yml.tt
+- lib/kurgan/version.rb
+homepage: http://iamkurgan.com
+licenses:
+- MIT
+metadata:
+  allowed_push_host: http://mygemserver.com
+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: []
+rubygems_version: 3.0.2
+signing_key: 
+specification_version: 4
+summary: Manage a cfhighalnder project
+test_files: []