awx 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 52520a21d53d145c1da6785673db13f6f98bb927
-  data.tar.gz: fd8646cb8f06cf49a0cdda13e29a0dd64b3b7329
+  metadata.gz: 387197029107fc3f0061d3a18ed29c4cfb411540
+  data.tar.gz: 51d23676040bac0444f4ac73f261fd48e08f0e24
 SHA512:
-  metadata.gz: 5c81bba7df3c682a7b732712f610ba01de5c1d217e61a0da9fe5b4d60286353bbac987539bf36ffc48664610c25da336cd9214b4d76f8cdaa065788fdf9c4e79
-  data.tar.gz: 5b535a761bdc19a239b3eb5f8cb2a401ed9443428461fa0e8381ee701a27bb84f44c0ebf12c88faa0fb8082171c96bd97c436c3156ed164e438b7fd7e734fb9a
+  metadata.gz: f96e2cc1fe271437e8422cd3866bc4f9d9c0474a4ca4d392e0f7e15788ee02ac0fa3f5348f5611d105e39f3b3aeaaee7879f7a5ee7dbad4917c330a17e3393d1
+  data.tar.gz: f0a15ab29c5674987ebacef867fef0d0ab320e8e5d684e3d9f13b653cf03dd38a0b3b441ac1008681b1c2c3ebf901e1223efc18cbd74063f47acfce9b251e74e

data/lib/aws/aws_cloudformation.rb

@@ -5,22 +5,29 @@ module App
         # Gets the path to the root of the cloudformation templates in blufin-secrets repo.
         # @return string
         def self.get_cloudformation_path
-            # TODO AWX PROFILE - Must support S3.
-            path = App::AWSProfile::get_profile['CloudFormation']['Templates']['Local']['Path']
-            Blufin::Terminal::error("CloudFormation path not found: #{Blufin::Terminal::format_directory(path)}", 'This probably means directories got renamed or code got changed.', true) unless Blufin::Files::path_exists(path)
+            if App::AWSProfile::get_profile[App::AWSProfile::CLOUDFORMATION]['Templates'].has_key?('Local')
+                path = App::AWSProfile::get_profile['CloudFormation']['Templates']['Local']['Path']
+                Blufin::Terminal::error("CloudFormation path not found: #{Blufin::Terminal::format_directory(path)}", 'This probably means directories got renamed or code got changed.', true) unless Blufin::Files::path_exists(path)
+            else
+                path = download_s3_templates
+            end
             path
         end
 
         # Uploads a cloudformation template to S3 (so we can create a stack from it).
         # Returns the S3 URL.
         # @return string
-        def self.upload_cloudformation_template(source, category, template)
+        def self.upload_cloudformation_template(source, category, template, filename_override: nil)
             raise RuntimeError, "File does not exist: #{source}" unless Blufin::Files::file_exists(source)
             tmp_file = "/tmp/aws-cf-upload-#{category}-#{template}-#{Blufin::Strings::random_string}.yml"
             Blufin::Terminal::execute("cp #{source} #{tmp_file}", text: "Preparing template: \x1B[38;5;240m#{tmp_file}\x1B[0m")
-            template_filename = "#{category}-#{template}-#{DateTime.now.strftime('%Y%m%d-%H%M%S')}.yml"
-            bucket_path       = get_s3_bucket_path
-            bucket_path       = bucket_path == '' ? '' : "#{bucket_path}/"
+            bucket_path = get_s3_bucket_path
+            bucket_path = bucket_path == '' ? '' : "#{bucket_path}/"
+            if filename_override.nil?
+                template_filename = "#{category}-#{template}-#{DateTime.now.strftime('%Y%m%d-%H%M%S')}.yml"
+            else
+                template_filename = filename_override
+            end
             App::AWSCli::s3_upload(tmp_file, App::AWSProfile::get_profile['CloudFormation']['Uploads']['S3Bucket']['Name'], "#{bucket_path}#{template_filename}")
             # Return the S3 bucket URL.
             "#{get_s3_bucket_url}/#{template_filename}"
@@ -63,6 +70,15 @@ module App
             results
         end
 
+        # Downloads templates from S3 into /tmp folder (and returns path to /tmp folder).
+        # @return string
+        def self.download_s3_templates(use_cache = true)
+            raise RuntimeError, "Missing key in #{App::CONFIG_FILE}: #{App::AWSProfile::CLOUDFORMATION}->Templates->S3Bucket" unless App::AWSProfile::get_profile[App::AWSProfile::CLOUDFORMATION]['Templates'].has_key?('S3Bucket')
+            s3       = App::AWSProfile::get_profile[App::AWSProfile::CLOUDFORMATION]['Templates']['S3Bucket']
+            tmp_path = Blufin::AWS::download_s3_data(s3['Name'], s3['Path'], profile: App::AWSProfile::get_profile[App::AWSProfile::PROFILE], region: s3['Region'], use_cache: use_cache)
+            tmp_path
+        end
+
     end
 
 end

data/lib/aws/aws_outputter.rb

@@ -55,8 +55,12 @@ module App
                     row do
                         column('')
                         column_data.each do |title, data|
-                            color        = data[:color].nil? ? 'default' : data[:color]
-                            value        = get_value(data[:key], item)
+                            color = data[:color].nil? ? 'default' : data[:color]
+                            if data[:key] =~ /^Tags\./
+                                value = App::AWSReports::extract_tag(item, data[:key])
+                            else
+                                value = get_value(data[:key], item)
+                            end
                             value, color = get_formatter(data[:formatter], resource: resource, color: color).call(value) unless data[:formatter].nil?
                             column(value, :color => get_color(color))
                         end
@@ -110,16 +114,17 @@ module App
                     cop = 'light-green'
                     cop = 'purple' if data[:type_internal] == :autocomplete
                     cop = 'light-grey' if data[:type_internal] == :system || [
-                        AppCommand::AWSCloudFormationCreate::OPTION_STACK_NAME,
-                        AppCommand::AWSCloudFormationCreate::OPTION_PROJECT_ID,
-                        AppCommand::AWSCloudFormationCreate::OPTION_DESCRIPTION,
-                        AppCommand::AWSCloudFormationCreate::OPTION_TERM_PROTECT,
-                        AppCommand::AWSCloudFormationCreate::OPTION_TIMEOUT
+                        AppCommand::CloudFormationCreate::OPTION_STACK_NAME,
+                        AppCommand::CloudFormationCreate::OPTION_PROJECT_ID,
+                        AppCommand::CloudFormationCreate::OPTION_DESCRIPTION,
+                        AppCommand::CloudFormationCreate::OPTION_TERM_PROTECT,
+                        AppCommand::CloudFormationCreate::OPTION_TIMEOUT,
+                        AppCommand::CloudFormationCreate::OPTION_OWNER
                     ].include?(data[:parameter])
                     # In case you want to change color in future, currently this is redundant.
                     cod = data[:type_internal] == :system ? 'default' : 'default'
                     cot = data[:type_internal] == :system ? 'default' : 'default'
-                    cot = data[:type] == AppCommand::AWSCloudFormationCreate::SPECIAL ? 'light-grey' : cot
+                    cot = data[:type] == AppCommand::CloudFormationCreate::SPECIAL ? 'light-grey' : cot
                     row do
                         column('')
                         column(data[:parameter], :color => get_color(cop))
@@ -207,7 +212,7 @@ module App
                     [n, color]
                 },
                 'epoch-date'              => Proc.new { |n|
-                    [DateTime.strptime(n.to_s, '%s'), color]
+                    [DateTime.strptime(n.to_i.to_s, '%s'), color]
                 },
                 'region'                  => Proc.new { |n|
                     preferred_regions = resource.nil? ? [] : resource[App::AWSReports::KEY_REGIONS_PREFERRED]
@@ -222,8 +227,7 @@ module App
                     zone_color = color
                     ns         = n.split('/')
                     [ns[ns.length - 1], zone_color]
-                },
-
+                }
             }
             raise RuntimeError, "Key not found: #{key}" unless key.nil? || formatters.has_key?(key)
             return formatters.keys if key.nil?

data/lib/aws/aws_profile.rb

@@ -51,11 +51,12 @@ module App
 
             # Validate CloudFormation data (if exist).
             if @@profile.has_key?(CLOUDFORMATION)
-                # TODO AWX PROFILE - Must support S3.
-                cloudformation_template_path = @@profile[CLOUDFORMATION]['Templates']['Local']['Path']
+                if @@profile[CLOUDFORMATION]['Templates'].has_key?('Local')
+                    cloudformation_template_path = @@profile[CLOUDFORMATION]['Templates']['Local']['Path']
+                    errors << "Path not found: #{Blufin::Terminal::format_invalid(cloudformation_template_path)}" unless Blufin::Files::path_exists(cloudformation_template_path)
+                end
                 s3_region                    = @@profile[CLOUDFORMATION]['Uploads']['S3Bucket']['Region']
                 default_regions              = @@profile[CLOUDFORMATION]['Defaults']['Regions']
-                errors << "Path not found: #{Blufin::Terminal::format_invalid(cloudformation_template_path)}" unless Blufin::Files::path_exists(cloudformation_template_path)
                 errors << "Invalid region: #{Blufin::Terminal::format_invalid(s3_region)}" unless App::AWS::VALID_REGIONS.include?(s3_region)
                 errors << "Need atleast 1 default region for: #{Blufin::Terminal::format_invalid('Profiles[].CloudFormation.Defaults.Regions')}" if default_regions.nil? || !default_regions.any?
                 default_regions.each do |default_region|
@@ -124,20 +125,22 @@ module App
             @@ssh_users.each do |user, pub_key|
                 Blufin::Terminal::error("Public key not found for user: #{Blufin::Terminal::format_invalid(user)}", "Expected file to exist: #{Blufin::Terminal::format_directory("#{user}.pub", false)}", true) if pub_key.nil?
             end
+            raise RuntimeError, 'SSHUser Hash is empty. Atleast one user is required.' unless @@ssh_users.is_a?(Hash) && @@ssh_users.any?
             @@ssh_users
         end
 
         # Gets Users from S3.
         # Can be called multiple times (which you might do if you want to invalidate the cache).
-        # @return void
+        # @return string
         def self.download_s3_ssh_users(use_cache = true)
             if @@profile.has_key?(SSH_KEYS)
-                s3       = @@profile[SSH_KEYS]['S3Bucket']
-                tmp_path = Blufin::AWS::download_s3_data(s3['Name'], s3['Path'], profile: @@profile[PROFILE], region: s3['Region'], use_cache: use_cache)
-                users    = []
+                s3             = @@profile[SSH_KEYS]['S3Bucket']
+                tmp_path       = Blufin::AWS::download_s3_data(s3['Name'], s3['Path'], profile: @@profile[PROFILE], region: s3['Region'], use_cache: use_cache)
+                tmp_path_files = Blufin::Files::get_files_in_dir(tmp_path)
+                users          = []
                 # Gets a unique list of users (since every user has 2 files, private and public key).
-                if Blufin::Files::path_exists(tmp_path)
-                    Blufin::Files::get_files_in_dir(tmp_path).each do |file|
+                if Blufin::Files::path_exists(tmp_path) && tmp_path_files.is_a?(Array) && tmp_path_files.any?
+                    tmp_path_files.each do |file|
                         users << Blufin::Files::extract_file_name(file, false).gsub(/\.pub$/i, '')
                     end
                 end
@@ -148,6 +151,7 @@ module App
                     pub_key           = "#{tmp_path}/#{user}.pub"
                     @@ssh_users[user] = Blufin::Files::file_exists(pub_key) ? pub_key : nil
                 end
+                tmp_path
 
             end
 

data/lib/aws/aws_reports.rb

@@ -63,20 +63,11 @@ module App
                             :formatter => 'region'
                         }
                         data[KEY_COLUMNS].each_with_index do |column, idx|
-                            title     = nil
-                            key       = nil
-                            width     = nil
-                            color     = 'default'
-                            formatter = nil
-                            column.each do |column_inner|
-                                column_inner.each do |k, v|
-                                    title     = v if k == 'title'
-                                    key       = v if k == 'key'
-                                    width     = v if k == 'width'
-                                    color     = v if k == 'color'
-                                    formatter = v if k == 'formatter'
-                                end
-                            end
+                            title     = column['title']
+                            key       = column['key']
+                            width     = column['width']
+                            color     = column['color'].nil? ? 'default' : column['color']
+                            formatter = column['formatter']
                             ['Region'].each do |reserved_column|
                                 raise RuntimeError, "#{resource}.#{KEY_COLUMNS}[#{idx}] \xe2\x86\x92 #{reserved_column} is a reserved column." if title.downcase == reserved_column.downcase
                             end
@@ -112,7 +103,8 @@ module App
                         # Make sure formatter exists.
                         App::AWSOutputter::get_formatter(export['valueFormatter']) if export.has_key?('valueFormatter')
                         export.each { |key, val| raise RuntimeError, "Unexpected key: #{key} (#{val})" unless %w(id value valueFormatter description).include?(key) }
-                        export_map[export['id']] = resource
+                        export_map[resource] = [] unless export_map.has_key?(resource)
+                        export_map[resource] << export['id']
                     end
                 end
             end
@@ -216,7 +208,7 @@ module App
             results.each do |result|
                 value = result[export['value']]
                 value = App::AWSOutputter::get_formatter(export['valueFormatter']).call(value)[0] if export.has_key?('valueFormatter')
-                sort  = result[export['description']] # Used for sorting.
+                sort  = export['description'] =~ /^Tags\.[A-Za-z0-9]+$/ ? extract_tag(result, export['description']) : result[export['description']] # Used for sorting.
                 if export.has_key?('description')
                     text = "#{value.rjust(values.max_by(&:length).length.to_i, ' ')} \x1B[38;5;246m\xe2\x80\x94 \x1B[38;5;240m#{sort}\x1B[0m"
                 else
@@ -287,6 +279,16 @@ module App
             Blufin::Terminal::error("Root key not found in AWS response: #{Blufin::Terminal::format_invalid(root_key)}", data.to_yaml.split("\n"), true) unless data.has_key?(root_key)
         end
 
+        # If sort/description is => 'Tags.XXX' this will extract that tag.
+        # @return String
+        def self.extract_tag(data, tag_name)
+            return 'N/A' unless data.is_a?(Hash)
+            return 'N/A' unless data.has_key?('Tags')
+            tag_name = tag_name.gsub(/^Tags\./, '')
+            data['Tags'].each { |tag| return tag['Value'] if tag['Key'] == tag_name }
+            return 'N/A'
+        end
+
     end
 
 end

data/lib/awx.rb

@@ -14,11 +14,11 @@ Dir["#{File.dirname(__FILE__)}/routes/**/*.rb"].each { |file| load(file) }
 
 module App
 
-    GEM_NAME = 'awx'
-    SCHEMA_FILE = "#{App::Opt::get_base_path}#{App::Opt::OPT_PATH}/config/schema.yml"
+    GEM_NAME      = 'awx'
+    SCHEMA_FILE   = "#{App::Opt::get_base_path}#{App::Opt::OPT_PATH}/config/schema.yml"
     TEMPLATE_FILE = "#{App::Opt::get_base_path}#{App::Opt::OPT_PATH}/config/template.yml"
-    CONFIG_FILE = '~/.awx.yml'
-    SECRET = 'gts8cxeCn1EkzxH3ASXwnz7nboOnf6AjnQhqdjQp8kzxH7q7Ne'
+    CONFIG_FILE   = '~/.awx.yml'
+    SECRET        = 'gts8cxeCn1EkzxH3ASXwnz7nboOnf6AjnQhqdjQp8kzxH7q7Ne'
 
     def self.execute
 
@@ -44,38 +44,36 @@ module App
 TEMPLATE
                 awx.description 'An abstraction layer built around the AWS-cli (written by: Albert Rannetsperger)'
 
-                # c - AWS CLOUD FORMATION
-                if ARGV[0] != 'setup' && ARGV[0] != 'x' && App::AWSProfile::get_profile.has_key?('CloudFormation')
+                # c - CLOUD FORMATION
+                if ARGV[0] != 'setup' && ARGV[0] != 'x' && App::AWSProfile::get_profile.has_key?(App::AWSProfile::CLOUDFORMATION)
                     awx.command :cloudformation, :aliases => [:c] do |awx_cloudformation|
                         awx_cloudformation.summary 'Create, list and delete cloud-formation stacks'
-                        # c - AWS CLOUD FORMATION CREATE
+                        # c - CLOUD FORMATION CREATE
                         awx_cloudformation.command :create, :aliases => [:c] do |awx_cloudformation_create|
                             awx_cloudformation_create.summary 'Create stack'
                             awx_cloudformation_create.options do |opts|
                                 opts.opt :clear_cache, 'Clear cache', :short => '-c', :long => '--clear-cache', :type => :boolean
                                 opts.opt :rerun, "Re-run previous with cached values (if exists) \xe2\x80\x94 #{Blufin::Terminal::format_invalid('@NotImplemented')}", :short => '-r', :long => '--re-run', :type => :boolean
-
-                                # TODO AWX PROFILE - Must support S3.
-                                if Blufin::Files::path_exists("#{File.expand_path(App::AWSProfile::get_profile['CloudFormation']['Templates']['Local']['Path'])}/test")
+                                if Blufin::Files::path_exists("#{File.expand_path(App::AWSCloudFormation::get_cloudformation_path)}/test")
                                     opts.opt :test, 'Run through test-template.', :short => '-t', :long => '--test', :type => :boolean
                                 end
                             end
                             awx_cloudformation_create.action do |opts, args|
-                                AppCommand::AWSCloudFormationCreate.new(opts, args).execute
+                                AppCommand::CloudFormationCreate.new(opts, args).execute
                             end
                         end
-                        # d - AWS CLOUD FORMATION DETECT-DRIFT
+                        # d - CLOUD FORMATION DETECT-DRIFT
                         awx_cloudformation.command :detect_drift, :aliases => [:d] do |awx_cloudformation_detect_drift|
                             awx_cloudformation_detect_drift.summary 'Detect drift (currently for all stacks)'
                             awx_cloudformation_detect_drift.action do |opts, args|
-                                AppCommand::AWSCloudFormationDetectDrift.new(opts, args).execute
+                                AppCommand::CloudFormationDetectDrift.new(opts, args).execute
                             end
                         end
-                        # D - AWS CLOUD FORMATION DELETE
+                        # D - CLOUD FORMATION DELETE
                         awx_cloudformation.command :delete, :aliases => [:D] do |awx_cloudformation_delete|
                             awx_cloudformation_delete.summary 'Delete stack'
                             awx_cloudformation_delete.action do |opts, args|
-                                AppCommand::AWSCloudFormationDelete.new(opts, args).execute
+                                AppCommand::CloudFormationDelete.new(opts, args).execute
                             end
                         end
                         awx_cloudformation.action do
@@ -86,28 +84,38 @@ TEMPLATE
 
                 # d - DYNAMO-DB
                 if ARGV[0] != 'setup' && ARGV[0] != 'x' && Blufin::Config::get.has_key?('DynamoDBPath')
-                    awx.command :dynamodb, :aliases => [:db] do |db|
-                        db.summary 'Run a local instance of DynamoDB'
-                        db.action do |opts, args|
-                            AppCommand::AWSDynamoDB.new(opts, args).execute
+                    awx.command :dynamodb, :aliases => [:d] do |dynamodb|
+                        dynamodb.summary 'Run a local instance of DynamoDB'
+                        dynamodb.action do |opts, args|
+                            AppCommand::DynamoDB.new(opts, args).execute
                         end
                     end
                 end
 
-                # D - DEPLOY
+                # d - DEPLOY (DEPRECATED)
                 if ARGV[0] != 'setup' && ARGV[0] != 'x' && (App::AWSProfile::get_profile.has_key?('Projects'))
-                    awx.command :deploy, :aliases => [:D] do |deploy|
-                        deploy.summary 'Deploy application(s) to AWS'
-                        deploy.options do |opts|
+                    awx.command :deploy_deprecated, :aliases => [:d] do |deploy_deprecated|
+                        deploy_deprecated.summary "Deploy application(s) to AWS #{Blufin::Terminal::format_invalid('@deprecated')}"
+                        deploy_deprecated.options do |opts|
                             opts.opt :skip_build, 'Skip build', :short => '-S', :long => '--skip-build', :type => :boolean
                         end
-                        deploy.action do |opts, args|
-                            AppCommand::AWSDeploy.new(opts, args).execute
+                        deploy_deprecated.action do |opts, args|
+                            AppCommand::DeployDeprecated.new(opts, args).execute
+                        end
+                    end
+                end
+
+                # i - INFRASTRUCTURE
+                if ARGV[0] != 'setup' && ARGV[0] != 'x' && (App::AWSProfile::get_profile.has_key?('Projects')) && (App::AWSProfile::get_profile.has_key?('Deployments'))
+                    awx.command :infrastructure, :aliases => [:i] do |infrastructure|
+                        infrastructure.summary 'View, modify & deploy application(s) to pre-defined infrastructure'
+                        infrastructure.action do |opts, args|
+                            AppCommand::Infrastructure.new(opts, args).execute
                         end
                     end
                 end
 
-                # l - AWS LIST
+                # l - LIST
                 awx.command :list, :aliases => [:l] do |awx_list|
                     awx_list.summary 'List AWS instances/resources'
                     awx_list.options do |opts|
@@ -124,17 +132,55 @@ TEMPLATE
                         opts.opt :project, "Specify a project \xe2\x80\x94 #{Blufin::Terminal::format_invalid('@NotImplemented')}", :short => '-p', :long => '--project', :type => :string
                     end
                     awx_list.action do |opts, args|
-                        AppCommand::AWSList.new(opts, args).execute
+                        AppCommand::List.new(opts, args).execute
                     end
                 end
 
-                # s - SWITCH
+                # s - SSH
+                    awx.command :ssh, :aliases => [:s] do |ssh|
+                        ssh.summary 'SSH into EC2 instances'
+                        ssh.action do |opts, args|
+                            AppCommand::SSH.new(opts, args).execute
+                        end
+                    end
+
+                # S - SWITCH
                 if ARGV[0] != 'setup' && ARGV[0] != 'x' && App::AWSProfile::get_profile_names.length > 1
                     # Only show if we have multiple profiles.
-                    awx.command :switch, :aliases => [:s] do |switch|
+                    awx.command :switch, :aliases => [:S] do |switch|
                         switch.summary 'Switch Profiles'
                         switch.action do |opts, args|
-                            AppCommand::AWSSwitch.new(opts, args).execute
+                            AppCommand::Switch.new(opts, args).execute
+                        end
+                    end
+                end
+
+                # u - UPLOAD
+                if ARGV[0] != 'setup' && ARGV[0] != 'x' && (App::AWSProfile::get_profile.has_key?(App::AWSProfile::CLOUDFORMATION) || App::AWSProfile::get_profile.has_key?('Projects'))
+                    awx.command :upload, :aliases => [:u] do |upload|
+                        upload.summary 'Upload configuration(s) to S3'
+                        # p - UPLOAD PROJECTS
+                        if App::AWSProfile::get_profile.has_key?('Projects')
+                            upload.command :projects, :aliases => [:p] do |upload_projects|
+                                upload_projects.summary 'Upload Projects'
+                                upload_projects.action do |opts, args|
+                                    args = args.unshift(AppCommand::Upload::PROJECTS)
+                                    AppCommand::Upload.new(opts, args).execute
+                                end
+                            end
+                        end
+                        # t - UPLOAD TEMPLATE
+                        if App::AWSProfile::get_profile.has_key?(App::AWSProfile::CLOUDFORMATION)
+                            upload.command :templates, :aliases => [:t] do |upload_templates|
+                                upload_templates.summary 'Upload Templates'
+                                upload_templates.action do |opts, args|
+                                    args = args.unshift(AppCommand::Upload::TEMPLATES)
+                                    AppCommand::Upload.new(opts, args).execute
+                                end
+                            end
+                        end
+                        upload.action do
+                            system("#{App::GEM_NAME} u -h")
                         end
                     end
                 end

data/lib/core/deployments.rb

@@ -0,0 +1,65 @@
+module App
+
+    class Deployments
+
+        SCHEMA_FILE              = "#{App::Opt::get_base_path}#{App::Opt::OPT_PATH}/awx/deployment-schema.yml"
+
+        @@deployments = nil
+
+        # Takes a Hash that will have all the deployment info.
+        # @return void
+        def self.init(deployments)
+            raise RuntimeError, 'Cannot run App::Deployments::init() more than once.' unless @@deployments.nil?
+            raise RuntimeError, "Need either a Local or S3Bucket key, found neither: #{deployments.keys}" unless deployments.has_key?('Local') || deployments.has_key?('S3Bucket')
+            @@deployments = {}
+
+            if deployments.has_key?('Local')
+                source_file = File.expand_path(deployments['Local']['File'])
+                # Throw error if source file doesn't exist.
+                Blufin::Terminal::error("Cannot find source file: #{Blufin::Terminal::format_directory(source_file)}") unless Blufin::Files::file_exists(source_file)
+                # Validate the source file against the expected schema.
+                process_source_file(source_file)
+            elsif deployments.has_key?('S3Bucket')
+
+                # TODO - Finish this once we start running this on an EC2 instance (build/deploy server).
+                # TODO - Whatever file we validate should be available on disk locally.
+                # TODO - If the source is an S3 bucket, pull it down into a /tmp folder (on EC2 instance) and validate from there.
+
+            end
+
+
+
+
+        end
+
+        private
+
+        # Validate the Deployment YML.
+        # @return void
+        def self.process_source_file(source_file)
+            # Skip empty file.
+            return if Blufin::Files::is_empty(source_file)
+            # Otherwise, validate file.
+            document, errors = Blufin::Config::validate_file(source_file, SCHEMA_FILE)
+            if errors && !errors.empty?
+                errors_output = []
+                errors.each { |e| errors_output << "[#{e.path}] #{e.message}" }
+                Blufin::Terminal::error("Your configuration file is invalid. Please fix: #{Blufin::Terminal::format_directory(source_file)}", errors)
+            else
+                begin
+                    file_parsed = YAML.load_file(source_file)
+                rescue => e
+                    Blufin::Terminal::error("Failed to parse config file: #{Blufin::Terminal::format_directory(source_file)}", e.message)
+                end
+
+                # TODO NOW - FINISH THIS...
+                puts file_parsed.to_yaml
+                exit
+
+            end
+
+        end
+
+    end
+
+end