formatron 0.1.0

data/lib/formatron/generators/util/gitignore.rb

@@ -0,0 +1,16 @@
+class Formatron
+  module Generators
+    module Util
+      # generates placeholder README.md
+      module Gitignore
+        def self.write(directory)
+          FileUtils.mkdir_p directory
+          readme = File.join directory, '.gitignore'
+          File.write readme, <<-EOH.gsub(/^ {12}/, '')
+            /.formatron/
+          EOH
+        end
+      end
+    end
+  end
+end

data/lib/formatron/generators/util/readme.rb

@@ -0,0 +1,18 @@
+class Formatron
+  module Generators
+    module Util
+      # generates placeholder README.md
+      module Readme
+        def self.write(directory, name)
+          FileUtils.mkdir_p directory
+          readme = File.join directory, 'README.md'
+          File.write readme, <<-EOH.gsub(/^ {12}/, '')
+            # #{name}
+
+            Formatron configuration
+          EOH
+        end
+      end
+    end
+  end
+end

data/lib/formatron/logger.rb

@@ -0,0 +1,8 @@
+require 'logger'
+
+# add logger to class
+class Formatron
+  LOG = Logger.new($stdout).tap do |log|
+    log.progname = 'Formatron'
+  end
+end

data/lib/formatron/s3/chef_server_cert.rb

@@ -0,0 +1,85 @@
+require_relative 'path'
+require 'formatron/logger'
+
+class Formatron
+  module S3
+    # manage the Chef Server SSL certificate and key stored on S3
+    module ChefServerCert
+      CERT_NAME = 'ssl.cert'
+      KEY_NAME = 'ssl.key'
+
+      # rubocop:disable Metrics/ParameterLists
+      # rubocop:disable Metrics/MethodLength
+      def self.deploy(
+        aws:,
+        kms_key:,
+        bucket:,
+        name:,
+        target:,
+        guid:,
+        cert:,
+        key:
+      )
+        cert_key = self.cert_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          "Upload Chef Server SSL certifcate to #{bucket}/#{cert_key}"
+        end
+        aws.upload_file(
+          kms_key: kms_key,
+          bucket: bucket,
+          key: cert_key,
+          content: cert
+        )
+        key_key = self.key_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          "Upload Chef Server SSL key to #{bucket}/#{key_key}"
+        end
+        aws.upload_file(
+          kms_key: kms_key,
+          bucket: bucket,
+          key: key_key,
+          content: key
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+      # rubocop:enable Metrics/ParameterLists
+
+      # rubocop:disable Metrics/MethodLength
+      def self.destroy(aws:, bucket:, name:, target:, guid:)
+        cert_key = self.cert_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          "Delete Chef Server SSL certificate from #{bucket}/#{cert_key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: cert_key
+        )
+        key_key = self.key_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          "Delete Chef Server SSL key from #{bucket}/#{key_key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: key_key
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def self.cert_key(name:, target:, guid:)
+        Path.key(
+          name: name,
+          target: target,
+          sub_key: "#{guid}/#{CERT_NAME}"
+        )
+      end
+
+      def self.key_key(name:, target:, guid:)
+        Path.key(
+          name: name,
+          target: target,
+          sub_key: "#{guid}/#{KEY_NAME}"
+        )
+      end
+    end
+  end
+end

data/lib/formatron/s3/chef_server_keys.rb

@@ -0,0 +1,103 @@
+require_relative 'path'
+require 'formatron/logger'
+
+class Formatron
+  module S3
+    # manage the Chef Server user and organization keys
+    module ChefServerKeys
+      USER_PEM_NAME = 'user.pem'
+      ORGANIZATION_PEM_NAME = 'organization.pem'
+
+      # rubocop:disable Metrics/MethodLength
+      # rubocop:disable Metrics/ParameterLists
+      def self.get(
+        aws:,
+        bucket:,
+        name:,
+        target:,
+        guid:,
+        directory:
+      )
+        user_pem_key = self.user_pem_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          'Download Chef Server user key from ' \
+          "#{bucket}/#{user_pem_key}"
+        end
+        aws.download_file(
+          bucket: bucket,
+          key: user_pem_key,
+          path: user_pem_path(directory: directory)
+        )
+        organization_pem_key = self.organization_pem_key(
+          name: name, target: target, guid: guid
+        )
+        Formatron::LOG.info do
+          'Download Chef Server organization key ' \
+          "from #{bucket}/#{organization_pem_key}"
+        end
+        aws.download_file(
+          bucket: bucket,
+          key: organization_pem_key,
+          path: organization_pem_path(directory: directory)
+        )
+      end
+      # rubocop:enable Metrics/ParameterLists
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def self.destroy(
+        aws:,
+        bucket:,
+        name:,
+        target:,
+        guid:
+      )
+        user_pem_key = self.user_pem_key name: name, target: target, guid: guid
+        Formatron::LOG.info do
+          'Delete Chef Server user key from ' \
+          "#{bucket}/#{user_pem_key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: user_pem_key
+        )
+        organization_pem_key = self.organization_pem_key(
+          name: name, target: target, guid: guid
+        )
+        Formatron::LOG.info do
+          'Delete Chef Server organization key ' \
+          "from #{bucket}/#{organization_pem_key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: organization_pem_key
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def self.user_pem_key(name:, target:, guid:)
+        Path.key(
+          name: name,
+          target: target,
+          sub_key: "#{guid}/#{USER_PEM_NAME}"
+        )
+      end
+
+      def self.user_pem_path(directory:)
+        File.join directory, USER_PEM_NAME
+      end
+
+      def self.organization_pem_key(name:, target:, guid:)
+        Path.key(
+          name: name,
+          target: target,
+          sub_key: "#{guid}/#{ORGANIZATION_PEM_NAME}"
+        )
+      end
+
+      def self.organization_pem_path(directory:)
+        File.join directory, ORGANIZATION_PEM_NAME
+      end
+    end
+  end
+end

data/lib/formatron/s3/cloud_formation_template.rb

@@ -0,0 +1,61 @@
+require_relative 'path'
+require 'formatron/logger'
+
+class Formatron
+  module S3
+    # manage the CloudFormation template stored on S3
+    module CloudFormationTemplate
+      FILE_NAME = 'cloud_formation_template.json'
+
+      # rubocop:disable Metrics/ParameterLists
+      # rubocop:disable Metrics/MethodLength
+      def self.deploy(
+        aws:, kms_key:, bucket:, name:, target:, cloud_formation_template:
+      )
+        key = Path.key(
+          name: name,
+          target: target,
+          sub_key: FILE_NAME
+        )
+        Formatron::LOG.info do
+          "Upload CloudFormation template to #{bucket}/#{key}"
+        end
+        aws.upload_file(
+          kms_key: kms_key,
+          bucket: bucket,
+          key: key,
+          content: cloud_formation_template
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+      # rubocop:enable Metrics/ParameterLists
+
+      # rubocop:disable Metrics/MethodLength
+      def self.destroy(aws:, bucket:, name:, target:)
+        key = Path.key(
+          name: name,
+          target: target,
+          sub_key: FILE_NAME
+        )
+        Formatron::LOG.info do
+          "Delete CloudFormation template from #{bucket}/#{key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: key
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def self.url(region:, bucket:, name:, target:)
+        Path.url(
+          region: region,
+          bucket: bucket,
+          name: name,
+          target: target,
+          sub_key: FILE_NAME
+        )
+      end
+    end
+  end
+end

data/lib/formatron/s3/configuration.rb

@@ -0,0 +1,58 @@
+require_relative 'path'
+require 'formatron/logger'
+
+class Formatron
+  module S3
+    # manage the configuration stored on S3
+    module Configuration
+      FILE_NAME = 'configuration.json'
+
+      # rubocop:disable Metrics/ParameterLists
+      def self.deploy(aws:, kms_key:, bucket:, name:, target:, configuration:)
+        key = self.key name: name, target: target
+        Formatron::LOG.info do
+          "Upload configuration to #{bucket}/#{key}"
+        end
+        aws.upload_file(
+          kms_key: kms_key,
+          bucket: bucket,
+          key: key,
+          content: "#{JSON.pretty_generate(configuration)}\n"
+        )
+      end
+      # rubocop:enable Metrics/ParameterLists
+
+      def self.get(aws:, bucket:, name:, target:)
+        key = self.key name: name, target: target
+        Formatron::LOG.info do
+          "Get configuration from #{bucket}/#{key}"
+        end
+        JSON.parse(
+          aws.get_file(
+            bucket: bucket,
+            key: key
+          )
+        )
+      end
+
+      def self.destroy(aws:, bucket:, name:, target:)
+        key = self.key name: name, target: target
+        Formatron::LOG.info do
+          "Delete configuration from #{bucket}/#{key}"
+        end
+        aws.delete_file(
+          bucket: bucket,
+          key: key
+        )
+      end
+
+      def self.key(name:, target:)
+        Path.key(
+          name: name,
+          target: target,
+          sub_key: FILE_NAME
+        )
+      end
+    end
+  end
+end

data/lib/formatron/s3/path.rb

@@ -0,0 +1,30 @@
+class Formatron
+  module S3
+    # defines the S3 bucket keys for consistency
+    module Path
+      def self.key(name:, target:, sub_key:)
+        File.join _base_path(
+          name: name,
+          target: target
+        ), sub_key
+      end
+
+      def self.url(region:, bucket:, name:, target:, sub_key:)
+        key = key(
+          name: name,
+          target: target,
+          sub_key: sub_key
+        )
+        "https://s3-#{region}.amazonaws.com/#{bucket}/#{key}"
+      end
+
+      def self._base_path(name:, target:)
+        File.join target, name
+      end
+
+      private_class_method(
+        :_base_path
+      )
+    end
+  end
+end

data/lib/formatron/util/dsl.rb

@@ -0,0 +1,107 @@
+class Formatron
+  module Util
+    # utilities for generating DSL classes
+    module DSL
+      def dsl_initialize_block(&block)
+        define_method :initialize do |**params|
+          instance_exec(**params, &block) unless block.nil?
+        end
+      end
+
+      def dsl_initialize_hash(&block)
+        define_method :initialize do |dsl_key, **params|
+          instance_exec(
+            dsl_key,
+            **params,
+            &block
+          ) unless block.nil?
+        end
+      end
+
+      def dsl_property(symbol)
+        iv = "@#{symbol}"
+        define_method symbol do |value = nil|
+          instance_variable_set iv, value unless value.nil?
+          instance_variable_get iv
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def dsl_block(symbol, cls, &params_block)
+        iv = "@#{symbol}"
+        define_method symbol do |&block|
+          value = instance_variable_get(iv)
+          if value.nil?
+            params = {}
+            params = instance_eval(
+              &params_block
+            ) unless params_block.nil?
+            value = self.class.const_get(cls).new(**params)
+            instance_variable_set iv, value
+          end
+          block.call value unless block.nil?
+          instance_variable_get iv
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def dsl_hash(symbol, cls, &params_block)
+        iv = "@#{symbol}"
+        define_method symbol do |dsl_key = nil, &block|
+          hash = instance_variable_get(iv)
+          if hash.nil?
+            hash = {}
+            instance_variable_set iv, hash
+          end
+          unless dsl_key.nil?
+            params = {}
+            params = instance_exec(
+              dsl_key, &params_block
+            ) unless params_block.nil?
+            value = self.class.const_get(cls).new(
+              dsl_key,
+              **params
+            )
+            hash[dsl_key] = value
+            block.call value unless block.nil?
+          end
+          hash
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def dsl_array(symbol)
+        iv = "@#{symbol}"
+        define_method symbol do |value = nil|
+          array = instance_variable_get(iv)
+          if array.nil?
+            array = []
+            instance_variable_set iv, array
+          end
+          array.push value unless value.nil?
+          array
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def dsl_block_array(symbol, cls)
+        iv = "@#{symbol}"
+        define_method symbol do |&block|
+          array = instance_variable_get(iv)
+          if array.nil?
+            array = []
+            instance_variable_set iv, array
+          end
+          unless block.nil?
+            value = self.class.const_get(cls).new
+            array.push value
+            block.call value
+          end
+          array
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+    end
+  end
+end