aws-rails-provisioner 0.0.0.rc1

data/lib/aws-rails-provisioner/service.rb

@@ -0,0 +1,90 @@
+require 'set'
+
+module Aws::RailsProvisioner
+  # @api private
+  class Service
+    
+    def initialize(name, options = {})
+      @name = name.to_s 
+      @file_path = options[:file_path] || 'aws-rails-provisioner.yml'
+      @stack_prefix = _camel_case(@name)
+      @path_prefix = _path_prefix(@name)
+      @const_prefix = _const_prefix(@stack_prefix)
+      @enable_cicd = !!options[:enable_cicd]
+      @profile = options[:profile]
+      @packages = Set.new
+
+      # fargate stack
+      @source_path = options.fetch(:source_path)
+      @fargate = options[:fargate] || {}
+
+      @db_cluster = options[:db_cluster]
+      @scaling = options[:scaling]
+
+      # pipeline stack
+      @cicd = options[:cicd] || {}
+    end
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [String]
+    attr_reader :stack_prefix
+
+    # @return [String]
+    attr_reader :path_prefix
+
+    # @return [String]
+    attr_reader :const_prefix
+
+    # @return [Boolean]
+    attr_reader :enable_cicd
+
+    # @return [Set]
+    attr_reader :packages
+
+    def fargate_stack
+      stack = Aws::RailsProvisioner::Views::FargateStack.new(
+        file_path: @file_path,
+        service_name: @name,
+        path_prefix: @path_prefix,
+        stack_prefix: @stack_prefix,
+        profile: @profile,
+        source_path: @source_path,
+        db_cluster: @db_cluster,
+        fargate: @fargate,
+        scaling: @scaling,
+      )
+      @packages.merge(stack.packages)
+      stack.render
+    end
+
+    def pipeline_stack
+      if @db_cluster.nil? || @db_cluster.empty?
+        @cicd[:skip_migration] = true
+      end
+      @cicd[:source_path] = @source_path
+      @cicd[:stack_prefix] = @stack_prefix
+      stack = Aws::RailsProvisioner::Views::PipelineStack.new(@cicd)
+      @packages.merge(stack.packages)
+      stack.render
+    end
+
+    private
+
+    def _camel_case(str)
+      str.split('_').collect(&:capitalize).join
+    end
+
+    def _path_prefix(str)
+      str.downcase.gsub('_', '-')
+    end
+
+    def _const_prefix(str)
+      dup = str.dup
+      dup[0] = dup[0].downcase
+      dup
+    end
+
+  end
+end

data/lib/aws-rails-provisioner/services.rb

@@ -0,0 +1,44 @@
+module Aws::RailsProvisioner
+  # @api private
+  class ServiceEnumerator
+    
+    include Enumerable
+
+    def initialize(options = {})
+      @configs = options || {}      
+    end
+
+    # @param [String] name 
+    def [](name)
+      if services.key?(name)
+        services[name]
+      else
+        msg = "unknown service #{identifier.inspect} under :services"
+        raise Aws::RailsProvisioner::ValidationError, msg
+      end
+    end
+    alias service []
+
+    def each(&block)
+      services.values.each(&block)
+    end
+
+    private
+
+    def services
+      @service ||= begin
+        @configs.inject({}) do |hash, (name, config)|
+          hash[name] = build_service(name, config)
+          hash
+        end
+      end
+    end
+
+    def build_service(name, config)
+      Aws::RailsProvisioner::Service.new(name, config)
+    end
+
+  end
+
+  Services = ServiceEnumerator.new
+end

data/lib/aws-rails-provisioner/subnet_selection.rb

@@ -0,0 +1,20 @@
+module Aws::RailsProvisioner 
+  class SubnetSelection
+
+    def initialize(options = {})
+      @name = options[:name]
+      @type = Aws::RailsProvisioner::Util.subnet_type(options[:type]) if options[:type]
+      if @name && @type
+        msg = "At most one of :type and :name can be supplied."
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    # @return [String]
+    attr_reader :name
+
+    # @return [String]
+    attr_reader :type
+
+  end
+end

data/lib/aws-rails-provisioner/utils.rb

@@ -0,0 +1,89 @@
+require 'yaml'
+
+module Aws::RailsProvisioner
+  # @api private
+  module Utils
+
+    def self.ip_address_type(str)
+      types = %w(ipv4, dualstack)
+      if types.include?(str.downcase)
+        str.upcase
+      else
+        msg = "Unsupported ip address type, please choose from #{types}"
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    def self.subnet_type(str)
+      types = %w(isolated private public)
+      if types.include?(str.downcase)
+        str.upcase
+      else
+        msg = "Unsupported subnet type, please choose from #{types}" 
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    def self.removal_policy(str)
+      types = %w(retain destroy)
+      if types.include?(str.downcase)
+        str.upcase
+      else
+        msg = "Unsupported removal policy, please choose from #{types}"
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    def self.protocol(str)
+      types = %w(https http tcp tls)
+      if types.include?(str.downcase)
+        str.upcase
+      else
+        msg = "Unsupported protocol type, please choose from #{types}"
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    def self.adjustment_type(str)
+      types = %w(change_in_capacity percent_change_in_capacity exact_capacity)
+      if types.include?(str.downcase)
+        str.upcase
+      else
+        msg = "Unsupported adjustment type, please choose from #{types}"
+        raise Aws::RailsProvisioner::Errors::ValidationError, msg
+      end
+    end
+
+    def self.parse(file_path)
+      config = YAML.load(File.read(file_path))
+      symbolize_keys(config)
+    rescue
+      raise Aws::RailsProvisioner::Errors::InvalidYAMLFile.new
+    end
+
+    def self.to_pairs(hash)
+      hash.inject([]) do |arr, (key, value)|
+        arr << "'#{key}': '#{value}',"
+        arr
+      end
+    end
+
+    def self.to_pkgs(services)
+      services.inject([]) do |pkgs, svc|
+        pkgs << "@aws-cdk/aws-#{svc}"
+        pkgs
+      end
+    end
+
+    private
+
+    def self.symbolize_keys(hash)
+      hash.inject({}) do |h, (k,v)|
+        v = symbolize_keys(v) if v.respond_to?(:keys)
+        h[k.to_sym] = v
+        h
+      end
+    end
+
+  end
+end

data/lib/aws-rails-provisioner/version.rb

@@ -0,0 +1,5 @@
+module Aws
+  module RailsProvisioner
+    VERSION = '0.0.0.rc1'
+  end
+end

data/lib/aws-rails-provisioner/view.rb

@@ -0,0 +1,29 @@
+require 'mustache'
+
+module Aws::RailsProvisioner 
+  # @api private
+  class View < Mustache
+
+    TEMPLATE_DIR = File.expand_path('../../../templates', __FILE__)
+
+    def self.inherited(subclass)
+      parts = subclass.name.split('::')
+      parts.shift #=> remove AWS
+      parts.shift #=> remove RailsProvisioner 
+      parts.shift #=> remove Views
+      path = parts.map { |part| underscore(part) }.join('/')
+      subclass.template_path = TEMPLATE_DIR
+      subclass.template_file = "#{TEMPLATE_DIR}/#{path}.mustache"
+      subclass.raise_on_context_miss = true
+    end
+
+    private
+
+    def underscore(str)
+      string = str.dup
+      string.scan(/[a-z0-9]+|\d+|[A-Z0-9]+[a-z]*/).join('_'.freeze)
+      string.downcase!
+    end
+
+  end
+end

data/lib/aws-rails-provisioner/views/fargate_stack.rb

@@ -0,0 +1,100 @@
+module Aws::RailsProvisioner
+  module Views
+
+    class FargateStack < View
+
+      # Fargate Stack Generation
+      #
+      # @param [Hash] options
+      #
+      # @option options [String] :source_path relative path from `aws-rails-provisioner.yml`
+      #   to the directory containing Rails Application source
+      #
+      # @option options [Hash] :db_cluster
+      #   @see {Aws::RailsProvisioner::DBCluster}
+      #
+      # @option options [Hash] :fargate configurations for
+      #   fargate service.
+      #   @see {Aws::RailsProvisioner::Fargate}
+      #
+      # @option options [Hash] :scaling configurations for
+      #   scaling setting for Fargate service
+      #   @see {Aws::RailsProvisioner::Scaling}
+      #
+      def initialize(options = {})
+        # code gen only
+        @service_name = options[:service_name]
+        @path_prefix = options[:path_prefix]
+        @stack_prefix = options[:stack_prefix]
+        @profile = options[:profile]
+
+        dir = File.dirname(File.expand_path(options[:file_path]))
+        @source_path = File.join(dir, options[:source_path])
+        @rds_config = options[:db_cluster] || {}
+        @fargate_config = options[:fargate] || {}
+        @scaling_config = options[:scaling] || {}
+      end
+
+      # @return [String]
+      attr_reader :stack_prefix
+
+      # @return [String]
+      attr_reader :source_path
+
+      def services
+        base = [
+          { abbr: 'ec2', value: 'ec2' },
+          { abbr: 'ecs', value: 'ecs' },
+          { abbr: 'ecr', value: 'ecr' },
+          { abbr: 'ecs_patterns', value: 'ecs-patterns' },
+          { abbr: 'ecr_assets', value: 'ecr-assets' },
+          { abbr: 'rds', value: 'rds' }
+        ]
+        if @fargate_config && @fargate_config[:certificate]
+          base << { abbr: 'certificatemanager', value: 'certificatemanager' }
+        end
+        if @scaling_config &&
+          (@scaling_config[:on_metric] || @scaling_config[:on_custom_metric])
+          base << { abbr: 'cloudwatch', value: 'cloudwatch' }
+        end
+        if @rds_config && !@rds_config.empty?
+          base << { abbr: 'secretsmanager', value: 'secretsmanager' }
+          if @rds_config[:kms_key_arn]
+            base << { abbr: 'kms', value: 'kms'}
+          end
+        end
+        base
+      end
+
+      def packages
+        keys = services.map {|svc| svc[:value] }
+        Aws::RailsProvisioner::Utils.to_pkgs(keys)
+      end
+
+      def db_cluster
+        if @rds_config && !@rds_config.empty?
+          unless @rds_config[:username]
+            @rds_config[:username] = "#{stack_prefix}DBAdminUser"
+          end
+          @rds_config[:profile] = @profile if @profile
+          Aws::RailsProvisioner::DBCluster.new(@rds_config)
+        end
+      end
+
+      def fargate
+        if @rds_config && !@rds_config.empty?
+          @fargate_config[:has_db] = true
+        end
+        @fargate_config[:service_name] = @stack_prefix
+        Aws::RailsProvisioner::Fargate.new(@fargate_config)
+      end
+
+      def scaling
+        if @scaling_config && !@scaling_config.empty?
+          Aws::RailsProvisioner::Scaling.new(@scaling_config)
+        end
+      end
+
+    end
+  end
+end

data/lib/aws-rails-provisioner/views/init_stack.rb

@@ -0,0 +1,35 @@
+module Aws::RailsProvisioner 
+  module Views
+    class InitStack < View
+
+      # For InitStack Generation
+      #
+      # @param [Hash] options
+      #
+      # @option options [Hash] :vpc
+      #   @see {Aws::RailsProvisioner::Vpc}
+      #
+      def initialize(options = {})
+        @vpc_config = options[:vpc]
+        @stack_prefix = options[:stack_prefix]
+      end
+
+      # @api private
+      # @return [String]
+      attr_reader :stack_prefix
+
+      def services
+        ['ec2', 'ecs']
+      end
+
+      def packages
+        Aws::RailsProvisioner::Utils.to_pkgs(services)
+      end
+
+      def vpc
+        Aws::RailsProvisioner::Vpc.new(@vpc_config)
+      end
+
+    end
+  end
+end

data/lib/aws-rails-provisioner/views/pipeline_stack.rb

@@ -0,0 +1,107 @@
+module Aws::RailsProvisioner 
+  module Views
+    class PipelineStack < View
+
+      # Pipeline (CICD) Generation under :cicd
+      #
+      # @param [Hash] options
+      #
+      # @option options [String] :pipeline_name Name for the 
+      #   AWS CodePipeline generated
+      #
+      # @option options [String] :source_repo CodeCommit Repo
+      #   name for holding your rails app source, default to
+      #   folder name where your rails app lives
+      #  
+      # @option options [String] :source_description Description for
+      #   the CodeCommit Repo, default to 'created by aws-rails-provisioner'
+      #
+      # @option options [Hash] :build configurations for codebuild project
+      #   for building images
+      #   @see {Aws::RailsProvisioner::Build}
+      #
+      # @option options [Hash] :migration configuration for db migration
+      #   codebuild, available if :db_cluster is configured
+      #   @see {Aws::RailsProvisioner::Migration}
+      #
+      def initialize(options = {})
+        @stack_prefix = options[:stack_prefix]
+
+        @pipeline_name = options[:pipeline_name] || "#{@stack_prefix}Pipeline"
+        @source_repo = options[:source_repo] || _extract_repo_name(options[:source_path])
+        @source_description = options[:source_description] || "created by aws-rails-provisioner with AWS CDK for #{@stack_prefix}"
+
+        @build_config = options[:build] || {}
+        unless @build_config[:project_name]
+          @build_config[:project_name] = "#{@stack_prefix}ImageBuild"
+        end
+
+        @skip_migration = options[:skip_migration] || false
+        unless @skip_migration
+          @migration_config = options[:migration] || {}
+          unless @migration_config[:project_name]
+            @migration_config[:project_name] = "#{@stack_prefix}DBMigration"
+          end
+        end
+      end
+
+      def services
+        [
+          { abbr: 'iam', value: 'iam'},
+          { abbr: 'ec2', value: 'ec2'},
+          { abbr: 'ecr', value: 'ecr' },
+          { abbr: 'ecs', value: 'ecs' },
+          { abbr: 'rds', value: 'rds' },
+          { abbr: 'codebuild', value: 'codebuild'},
+          { abbr: 'codecommit', value: 'codecommit'},
+          { abbr: 'codepipeline', value: 'codepipeline' },
+          { abbr: 'pipelineactions', value: 'codepipeline-actions'}
+        ] 
+      end
+
+      def packages
+        keys = services.map {|svc| svc[:value] }
+        Aws::RailsProvisioner::Utils.to_pkgs(keys)
+      end
+
+      # @return [String]
+      attr_reader :stack_prefix
+
+      # @return [String]
+      attr_reader :pipeline_name
+
+      # @return [String]
+      attr_reader :source_repo
+
+      # @return [String]
+      attr_reader :source_description
+
+      # @return [Aws::RailsProvisioner::Build]
+      attr_reader :build
+
+      # @return [Aws::RailsProvisioner::Migration]
+      attr_reader :migration
+
+      # @return [Boolean]
+      attr_reader :skip_migration
+
+      def build
+        Aws::RailsProvisioner::Build.new(@build_config)
+      end
+
+      def migration
+        if @migration_config
+          Aws::RailsProvisioner::Migration.new(@migration_config)
+        end
+      end
+
+      private
+
+      def _extract_repo_name(path)
+        path.split('/')[-1] || 'AwsRailsProvisionerRailsAppSource'
+      end
+
+    end
+  end
+end
+