enscalator 0.4.0.pre.alpha.pre.16

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 56c12d72d43705f3c0dd5368c0a237ef07b17440
+  data.tar.gz: 051a15cfb748bf3d18687f0859d0871a9a536867
+SHA512:
+  metadata.gz: 0c864f9ed600f5216906a630778d06cb8eca34882ce85156a258484cff0fca95c396e9db114a4e4dd4188b72c483e12db08bbb49b97f79712b0869a699f6273f
+  data.tar.gz: d771e4ebdd6d994ab8dea52e817de195c9461ff3efc22cb83850febe0de56991b6cd1e679fcb5e4a0854c2906da46e8b877d6f441b215fd68737dec704de728b

data/.gitignore

@@ -0,0 +1,15 @@
+/.DS_S*
+/.bundle/
+/vendor/bundle
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.*.swp
+/.idea
+*.iml
+/.bin

data/.rubocop.yml

@@ -0,0 +1,9 @@
+require: rubocop-rspec
+
+inherit_from: .rubocop_todo.yml
+
+AllCops:
+  Exclude:
+    - vendor/**/*
+    - tools/openvpn/**/*
+    - lib/enscalator/templates/**/*

data/.rubocop_todo.yml

@@ -0,0 +1,59 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2015-12-23 23:28:02 +0900 using RuboCop version 0.33.0.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 27
+Metrics/AbcSize:
+  Max: 110
+
+# Offense count: 3
+# Configuration parameters: CountComments.
+Metrics/ClassLength:
+  Max: 400
+
+# Offense count: 6
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+# Offense count: 403
+# Configuration parameters: AllowURI, URISchemes.
+Metrics/LineLength:
+  Max: 129
+
+# Offense count: 41
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 400
+
+# Offense count: 4
+# Configuration parameters: CountComments.
+Metrics/ModuleLength:
+  Max: 250
+
+# Offense count: 13
+# Configuration parameters: CountKeywordArgs.
+Metrics/ParameterLists:
+  Max: 10
+
+# Offense count: 4
+Metrics/PerceivedComplexity:
+  Max: 22
+
+# Offense count: 8
+Style/AccessorMethodName:
+  Exclude:
+    - 'lib/enscalator/enapp.rb'
+
+# Offense count: 3
+Style/RescueModifier:
+  Exclude:
+    - 'lib/enscalator/enapp.rb'
+
+# Offense count: 1
+Style/FlipFlop:
+  Exclude:
+    - 'lib/enscalator/plugins/debian.rb'

data/.travis.yml

@@ -0,0 +1,22 @@
+language: ruby
+cache: bundler
+rvm:
+- 2.2.1
+script: bundle exec rake test
+notifications:
+  email: false
+env:
+  global:
+    - secure: "LUUnEhX/N8+0N4QB4hw0T5Ln+jV1JBsF5SR+ba0rTkfcY/lRXkhqxGZD7P5eJrIiX00ojjyuExQ0ACLnoMW+ZvAs6P1UvT2cfzvSuT0acMQWIj01M2X3iDEU9fovr3VZVD55rIO2EukjXxqtmm6SXng0ns7hjMu5qrpBBz/XonuDJeYpRlq6v1RhXpM5IJbCf36tx/wxrS37cerX/oXHXnASH0BqW2m3mncOLLb9xdwGj9GQShwTFkrk64jHP+lCRR1L0lYes9wNEzMayIOzNThyTVBYMP7Og19hRQMXU7USmW6sqiXIAV9OR6Mw44NsoUzgifzmcpG44lldutgBEvDGC3KauEZALFlUl6wV5Ccp0JBY+dKUaiP5kyAWJtI4HYkWkn/f2urENcmS2pzMBi7Tx2pvFpuDLXdDQR4BzW+53kVSqXJU98FByjg6DX13PYchcV4jb/CYheM6ZoKRWhAAc+S75tCA3uCeJjGoiuK3FHZvnjDQzOIJh66EA2AHqxj0FWyKVn1BGdA3y0jK5suyAXiVdSIfqFiTRVEKvUf3J3tzxhriWT/RPMTjsYEGvNTSZKhuUYlIZ4SxDaMgqQajQMoAgSXJ4VUkPv/faIZwYIl3H8KuMI9wsjU4+k+ZDyUzOx4xnze1gCW6on8TYo806uOiOUhL5q1VnBYckrY="
+deploy_rubygems: &deploy_rubygems
+  provider: rubygems
+  api_key:
+    secure: "bfgS0ra7Yi/60/eH+sxUspst0iA5j7Ez6jA58PIzPn/mXE47gM0f7vEI/yCLshxzpepoQZGW+XWPHMwerVTl6B31RP2ShMjggxIgOs703HQpElZ5E9T2/hz87CTvMRyp/ZSTwWnhjcqnbRGQvXohv/e6HmYOU08GztmvVlM3saweIUSrZUWgnfQvytY6BRmCsoknWnAJw0ikazVaQOURszQRS88xbZO+FraBMMDDCQlmyvptOkDnMNGDZXj760LCUKb4R0BgwfVNT0L/fOL/wEX+OMYGlTXfdYI6F8EZA41QbwUXij8d0okZr9TzsLAg//q4QHEWZKhEsmGP2nyo20z33ke/OD6eUA6e4EP5qH9kuRneHKCVrnyge9f/fNktfm/RdRYb4FGXiNR2o0Nv0ibXaKCY+HLW8FLXoEgHY8Re7GoFgsHE9qGD4Vs4n2sHPRU1uQRUMlVtZ43QLlUOII8q9Fu4NvzZfkNAtb4KhZQXtxPt8TQgrshMy420hv4Ve1Oc21D+3lnS2SYykX1v+b0eoU3vHzl+3cLpMUOvDRhwAWH1dZ0mOi2YNG+wwgK8gFjxpUHDAfTHCW9bims5KPUAsCWC9FWwuM1sm2glDPbddzomZjyvt0EkBv2k2mPOSx8JWTvZuCKPMmOuCA86g08U/ArqM0KDEqxg2H55FSk="
+deploy:
+  <<: *deploy_rubygems
+  on:
+    tags: true
+deploy:
+  <<: *deploy_rubygems
+  on:
+    branch: master

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'
+
+# All gem dependencies are specified in enscalator.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 AIR at en-japan inc.
+
+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,148 @@
+# Enscalator
+
+[![Build Status](https://travis-ci.org/en-japan-air/enscalator.svg?branch=master)](https://travis-ci.org/en-japan-air/enscalator)
+[![Coverage Status](https://coveralls.io/repos/github/en-japan-air/enscalator/badge.svg?branch=master)](https://coveralls.io/github/en-japan-air/enscalator?branch=master)
+[![Inline docs](http://inch-ci.org/github/en-japan-air/enscalator.svg?branch=master)](http://inch-ci.org/github/en-japan-air/enscalator)
+
+Enscalator is based on [bazaarvoice/cloudformation-ruby-dsl](https://github.com/bazaarvoice/cloudformation-ruby-dsl) 
+and helps cloudforming applications created by AIR at en-japan inc.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'enscalator'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install enscalator
+
+## Usage
+
+### CLI
+
+```bash
+$ enscalator -h
+Usage: enscalator [arguments]
+  -l, --list-templates             List all available templates
+  -t, --template=<s>               Template name
+  -f, --template-file=<s>          Template filename
+  -r, --region=<s>                 AWS Region (default: us-east-1)
+  -p, --parameters=<s>             Parameters 'Key1=Value1;Key2=Value2'
+  -s, --stack-name=<s>             Stack name
+  -z, --private-hosted-zone=<s>    Private hosted zone (e.x. 'default-vpc.internal')
+  -g, --public-hosted-zone=<s>     Public hosted zone
+  -c, --create-stack               Create the stack
+  -u, --update-stack               Update already deployed stack
+  -e, --pre-run, --no-pre-run      Use pre-run hooks (default: true)
+  -o, --post-run, --no-post-run    Use post-run hooks (default: true)
+  -x, --expand                     Print generated JSON template
+  -a, --capabilities=<s>           AWS capabilities (default: CAPABILITY_IAM)
+  -n, --vpc-stack-name=<s>         VPC stack name (default: default-vpc)
+  -d, --availability-zone=<s>      Deploy to specific availability zone (default: all)
+  -i, --profile=<s>                Use a specific profile from your credential file
+  -h, --help                       Show this message
+```
+
+Examples:
+
+Create new stack with name `en-japan-air-vpc` in `us-west-1`
+
+```bash
+$ enscalator -t VPC -r us-west-1 -s en-japan-air-vpc -d a -c
+```
+
+> Note: if you'd like to run enscalator directly inside gem repository, use `./exe/enscalator` script.
+
+### Autogenerated ssh keys for ec2 instances 
+
+All autogenerated ssh keys gets saved to directory corresponding to the selected profile name under user home 
+directory at `$HOME/.enscalator`, thus:
+
+* when no profile option was given, keys would be saved to `$HOME/.enscalator/default`
+* for specific profile, directory will be created automatically and all keys gets saved under `$HOME/.enscalator/%profile_name%`
+
+### How to write a template
+
+All enscalator templates are stored in `lib/enscalator/templates/`.
+Application specific templates can be saved in any file and deployed by enscalator using `--template-file`.
+
+You'll find the list of helpers you can use in:
+
+* `lib/enscalator/richtemplate.rb`
+* `lib/enscalator/core/cf_parameters.rb`
+* `lib/enscalator/core/cf_resources.rb`
+* `lib/enscalator/enapp.rb`
+* `lib/enscalator/helpers.rb` (and more generic helpers)
+
+Note: for each template based on `EnAppTemplateDSL` you'll automatically get autogenerated 
+`ResourceSecurityGroup`, `ApplicationSecurityGroup` and load balancer along with `ResourceSubnet` and `ApplicationSubnet` 
+for each availability zone (for example, in case of zone `a` it would be `ResourceSubnetA` and `ApplicationSubnetA` and so on).
+Since this setup relies on presence of `VPC` of specific setup it is required to deploy `VPC` template prior to
+deploying any template based on `EnAppTemplateDSL`.
+
+Check [lib/enscalator/templates/vpc_peering.rb](lib/enscalator/templates/vpc_peering.rb) for an example.
+
+
+### How to write a plugin and include it?
+
+Plugins are modules and stored in `lib/enscalator/plugins/`.  
+When you want to use your plugin you just have to `include PluginName` inside your template.
+See `lib/enscalator/plugins/vpc_peering_connection.rb` for an example.  
+Don't forget to `require_relative` your new plugin in `lib/enscalator/plugins.rb`.
+
+Plugins supported out of the box:
+
+* [AmazonLinux](lib/enscalator/plugins/amazon_linux.rb)
+* [AutoScale](lib/enscalator/plugins/auto_scale.rb)
+* [CoreOS](lib/enscalator/plugins/core_os.rb)
+* [Couchbase](lib/enscalator/plugins/couchbase.rb)
+* [Debian](lib/enscalator/plugins/debian.rb)
+* [ElasticBeanstalk](lib/enscalator/plugins/elastic_beanstalk.rb)
+* [Elasticache](lib/enscalator/plugins/elasticache.rb)
+* [ElasticsearchAmazon](lib/enscalator/plugins/elasticsearch_amazon.rb)
+* [ElasticsearchBitnami](lib/enscalator/plugins/elasticsearch_bitnami.rb)
+* [ElasticsearchOpsworks](lib/enscalator/plugins/elasticsearch_opsworks.rb)
+* [Elb](lib/enscalator/plugins/elb.rb)
+* [NATGateway](lib/enscalator/plugins/nat_gateway.rb)
+* [RDS](lib/enscalator/plugins/rds.rb)
+* [Redis](lib/enscalator/plugins/redis.rb)
+* [RethinkDB](lib/enscalator/plugins/rethink_db.rb)
+* [Route53](lib/enscalator/plugins/route53.rb)
+* [Ubuntu](lib/enscalator/plugins/ubuntu.rb)
+* [VPCPeeringConnection](lib/enscalator/plugins/vpc_peering_connection.rb)
+
+
+#### What's pre_run and post_run?
+
+**pre_run** is a method called **BEFORE** the template generation. It's a good place to make some calls to the AWS SDK for instance.  
+**post_run** is a method called **AFTER** the stack is created.
+
+
+## Development
+
+To install this gem onto your local machine, run `bundle && 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).
+
+
+## Documentation
+
+To generate documentation run `rake doc` ( or `bundle exec rake doc` )
+
+
+## Contributing
+
+1. Fork it ( https://github.com/en-japan-air/enscalator/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. Check if tests failing (`rake spec` or `bundle exec rake spec`)
+6. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,43 @@
+require 'rspec/core/rake_task'
+require 'bundler/gem_tasks'
+require 'yard'
+require 'rubocop/rake_task'
+
+# Testing with rspec
+RSpec::Core::RakeTask.new(:spec) do |task|
+  task.rspec_opts = %w(--color --format documentation)
+end
+task test: :spec
+
+# Generate documentation with yard
+YARD::Rake::YardocTask.new do |t|
+  t.files = %w(lib/*.rb lib/enscalator/*.rb lib/enscalator/plugins/*.rb)
+  t.stats_options = %w(--list-undoc --compact)
+end
+desc 'Generate gem documentation (same as running "rake yard")'
+task doc: :yard
+
+# Print all available plugins
+namespace :enscalator do
+  namespace :plugins do
+    desc 'Show all available plugins'
+    task :show do
+      require 'enscalator'
+      root_dir = Pathname.new('lib/enscalator')
+      plugins = Enscalator::Plugins.constants
+      # print pairs of plugin module name / filename
+      root_dir.join('plugins').children.select { |p| p.to_s.end_with?('.rb') }.each do |plugin_file|
+        plugin_module = plugins.find { |p| p.to_s.underscore == File.basename(plugin_file, '.rb').to_s }
+        STDOUT.puts "Enscalator::Plugins::#{plugin_module} (#{plugin_file})"
+      end
+    end
+  end
+end
+
+# Use RuboCop to check for code/style offenses
+desc 'Run RuboCop on the lib directory'
+RuboCop::RakeTask.new(:rubocop) do |task|
+  # don't abort rake on failure
+  task.fail_on_error = false
+end
+task default: [:rubocop, :spec]

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'enscalator'
+
+# 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.
+
+# Use Pry by default
+require 'pry'
+Pry.start

data/bin/setup

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

data/enscalator.gemspec

@@ -0,0 +1,57 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'enscalator/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'enscalator'
+  spec.version = Enscalator::VERSION
+  spec.description = 'Webscale applications from AIR at en-japan inc.'
+  spec.summary = 'Make apps created by AIR at en-japan inc. really webscale.'
+  spec.license = 'MIT'
+  spec.authors = ['Ugo Bataillard', 'Denis Vazhenin', 'David Hagege', 'Yongyu Lee', 'Junji Watanabe']
+  spec.email = ['ugo@bataillard.me',
+                'denis.vazhenin@me.com',
+                'david.hagege@gmail.com',
+                'aleeyyu+01@gmail.com',
+                'watanabe0621@gmail.com']
+  spec.required_ruby_version = '~> 2.0'
+  spec.homepage = 'https://www.github.com/en-japan-air/enscalator'
+
+  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.8'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'pry', '~> 0.10.1'
+  spec.add_development_dependency 'pry-byebug', '~> 3.4.0'
+  spec.add_development_dependency 'awesome_print', '~> 1.6.1'
+  spec.add_development_dependency 'looksee', '~> 3.1.0'
+  spec.add_development_dependency 'yard', '~> 0.8.7.6'
+  spec.add_development_dependency 'vcr', '~> 2.9.3'
+  spec.add_development_dependency 'webmock', '~> 1.21.0'
+  spec.add_development_dependency 'rspec', '~> 3.2.0'
+  spec.add_development_dependency 'rspec-expectations', '~> 3.2.0'
+  spec.add_development_dependency 'rspec-mocks', '~> 3.2.1'
+  spec.add_development_dependency 'rubocop', '~> 0.47.1'
+  spec.add_development_dependency 'rubocop-rspec', '~> 1.10.0'
+  spec.add_development_dependency 'coveralls', '~> 0.8.19'
+
+  spec.add_runtime_dependency 'aws-sdk', '2.1.36'
+  spec.add_runtime_dependency 'cloudformation-ruby-dsl', '~> 1.0'
+  spec.add_runtime_dependency 'nokogiri', '~> 1.6.6.2'
+  spec.add_runtime_dependency 'trollop', '~> 2.1'
+  spec.add_runtime_dependency 'activesupport', '~> 4.2'
+  spec.add_runtime_dependency 'ipaddress', '~> 0.8'
+  spec.add_runtime_dependency 'semantic', '~> 1.4.0'
+  spec.add_runtime_dependency 'ruby-progressbar', '~> 1.7.5'
+
+  # Create pre-release version unless it is a tag
+  if ENV['TRAVIS']
+    if ENV['TRAVIS_TAG'].nil? || ENV['TRAVIS_TAG'].empty?
+      spec.version = "#{spec.version}-alpha-#{ENV['TRAVIS_BUILD_NUMBER']}"
+    end
+  end
+end

data/exe/enscalator

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+# TODO: remove once enscalator can be used as standalone gem
+# Workaround to keep this script working, i.e. when it
+# executed directly from codebase like './exe/enscalator'
+begin
+  Object.const_get('Enscalator')
+rescue NameError
+  require 'bundler/setup'
+end
+require 'enscalator'
+
+Enscalator.run!(ARGV)

data/lib/enscalator/core/cf_parameters.rb

@@ -0,0 +1,146 @@
+module Enscalator
+  module Core
+    # Parameters for cloudformation template dsl
+    module CfParameters
+      # Key name parameter
+      #
+      # @param [String] instance_name for which ssh key was created
+      def parameter_key_name(instance_name)
+        parameter "#{instance_name}KeyName",
+                  Description: "Name of the #{instance_name} ssh key pair",
+                  Type: 'String',
+                  MinLength: '1',
+                  MaxLength: '64',
+                  AllowedPattern: '[a-zA-Z][-_a-zA-Z0-9]*',
+                  ConstraintDescription: 'can contain only alphanumeric characters, dashes and underscores.'
+      end
+
+      # Name parameter
+      #
+      # @param [String] instance_name instance name
+      # @param [String] default default name
+      # @param [Integer] min_length minimum length
+      # @param [Integer] max_length maximum length
+      def parameter_name(instance_name, default: nil, min_length: 1, max_length: 64)
+        parameter "#{instance_name}Name",
+                  Default: default ? default.to_s : "#{instance_name}",
+                  Description: "#{instance_name} name",
+                  Type: 'String',
+                  MinLength: min_length,
+                  MaxLength: max_length,
+                  AllowedPattern: '[a-zA-Z][a-zA-Z0-9]*',
+                  ConstraintDescription: 'must begin with a letter and contain only alphanumeric characters.'
+      end
+
+      # Username parameter
+      #
+      # @param [String] instance_name instance name
+      # @param [String] default default username
+      # @param [Integer] min_length minimum length
+      # @param [Integer] max_length maximum length
+      def parameter_username(instance_name, default: 'root', min_length: 1, max_length: 16)
+        parameter "#{instance_name}Username",
+                  Default: default,
+                  NoEcho: 'true',
+                  Description: "Username for #{instance_name} access",
+                  Type: 'String',
+                  MinLength: min_length,
+                  MaxLength: max_length,
+                  AllowedPattern: '[a-zA-Z][a-zA-Z0-9]*',
+                  ConstraintDescription: 'must begin with a letter and contain only alphanumeric characters.'
+      end
+
+      # Password parameter
+      #
+      # @param [String] instance_name instance name
+      # @param [String] default default value
+      # @param [Integer] min_length minimum length
+      # @param [Integer] max_length maximum length
+      def parameter_password(instance_name, default: 'password', min_length: 8, max_length: 41)
+        parameter "#{instance_name}Password",
+                  Default: default,
+                  NoEcho: 'true',
+                  Description: "Password for #{instance_name} access",
+                  Type: 'String',
+                  MinLength: min_length,
+                  MaxLength: max_length,
+                  AllowedPattern: '[a-zA-Z0-9]*',
+                  ConstraintDescription: 'must contain only alphanumeric characters.'
+      end
+
+      # Allocated storage parameter
+      #
+      # @param [String] instance_name instance name
+      # @param [String] default size of instance primary storage
+      # @param [Integer] min minimal allowed value
+      # @param [Integer] max maximum allowed value
+      def parameter_allocated_storage(instance_name, default: 5, min: 5, max: 1024)
+        parameter "#{instance_name}AllocatedStorage",
+                  Default: default.to_s,
+                  Description: "The size of the #{instance_name} (Gb)",
+                  Type: 'Number',
+                  MinValue: min.to_s,
+                  MaxValue: max.to_s,
+                  ConstraintDescription: "must be between #{min} and #{max}Gb."
+      end
+
+      # Ami image parameter
+      #
+      # @param [String] name ami of the ami
+      # @param [String] ami_id id of the ami
+      # @return [String] parameter name
+      def parameter_ami(name, ami_id)
+        parameter_name = "#{name}AMIId"
+        parameter parameter_name,
+                  Default: ami_id,
+                  Description: "The #{name} AMI id",
+                  Type: 'String',
+                  AllowedPattern: 'ami-[a-zA-Z0-9]*',
+                  ConstraintDescription: 'must be valid AMI id (ami-*).'
+        parameter_name
+      end
+
+      # Instance type parameter
+      #
+      # @param [String] instance_name instance name
+      # @param [String] type instance type (default: t2.micro)
+      # @param [Array] allowed_values list used to override built-in instance types
+      def parameter_instance_type(instance_name, type, allowed_values: [])
+        # check if given type is included in allowed_values and fails if none matched
+        unless allowed_values.any? { |v| v == type }
+          fail("Instance type \"#{type}\" is not in allowed values: #{allowed_values.join(' ')}")
+        end
+        name = "#{instance_name}InstanceType"
+        parameter name,
+                  Default: type,
+                  Description: "The #{instance_name} instance type",
+                  Type: 'String',
+                  AllowedValues: allowed_values,
+                  ConstraintDescription: 'must be valid EC2 instance type.'
+        name
+      end
+
+      # EC2 Instance type parameter
+      #
+      # @param [String] instance_name name of the instance
+      # @param [String] type instance type
+      def parameter_ec2_instance_type(instance_name,
+                                      type: InstanceType.ec2_instance_type.current_generation[:general_purpose].first)
+        fail("Not supported instance type: #{type}") unless InstanceType.ec2_instance_type.supported?(type)
+        warn("Using obsolete instance type: #{type}") if InstanceType.ec2_instance_type.obsolete?(type)
+        parameter_instance_type(instance_name, type, allowed_values: InstanceType.ec2_instance_type.allowed_values(type))
+      end
+
+      # RDS Instance type parameter
+      #
+      # @param [String] instance_name name of the instance
+      # @param [String] type instance type
+      def parameter_rds_instance_type(instance_name,
+                                      type: InstanceType.rds_instance_type.current_generation[:general_purpose].first)
+        fail("Not supported instance type: #{type}") unless InstanceType.rds_instance_type.supported?(type)
+        warn("Using obsolete instance type: #{type}") if InstanceType.rds_instance_type.obsolete?(type)
+        parameter_instance_type(instance_name, type, allowed_values: InstanceType.rds_instance_type.allowed_values(type))
+      end
+    end
+  end
+end