terraform-wrapper 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c1c8efca42bd473f3bbfa5c0e97f2782b8cc2652f96fa17b213c8fa87d4b0ae
-  data.tar.gz: df46cad597ad4101afc53b242a94e11452e9bd14b722a1e76eb91ad9a02909a3
+  metadata.gz: b0f59fe60b44165f5771d0e20fe31b8e6d9f4dd05646a7a32ee5cb41de1c94ce
+  data.tar.gz: 268a408964acce9c9bc9745fea9c5ef154f7aee861f3245c4ea668a43548cc1c
 SHA512:
-  metadata.gz: 97be709f764c69cd868834dfa6d6ffbe1917d40ede4ef0ceaf2a01fc26fdf84f9d5da0a45c8ac02f017f29eb42071cbf8ce50e3d8862123c2a96f4ce9adfcc04
-  data.tar.gz: e1f8420bc2165a6819bc08a85fbf5d3290d3e40154866d5d6e47ddabd51eb8124ad748668cae8dfb6fd4e7964b4d6cb68eec747d32aa92fc29991166713b7192
+  metadata.gz: a9f91604fe4042be3b34dcb59cc2049808a28dd0ccfef2f8998518fbb4d6ed3c62801472bd4e8c1d9e0d035697b9e9ec0542e464c9e15bafbe3ed6047d2c9177
+  data.tar.gz: 5fc7cd614aa04419fa0a09c8843bd20e1b2a78f684926ddd5a98b4a1d4e429ceca8cee92be0ad0cbf837d8dc49b8dfd61faed176c547e3c2561676d8d2c0d9af

data/.gitlab-ci.yml

@@ -31,5 +31,7 @@ deploy:
     - hash gem
     - echo "-- Publishing Gem --"
     - rake release
+    - echo "-- Listing Sums --
+    - sha256sum *.gem
 
 ###############################################################################

data/lib/terraform-wrapper.rb

@@ -14,7 +14,7 @@ module TerraformWrapper
 
 ###############################################################################
 
-  @logger = Shared::Logging.logger_for("TerraformWrapper")
+  @logger = TerraformWrapper::Shared::Logging.logger_for("TerraformWrapper")
 
 ###############################################################################
 
@@ -51,6 +51,7 @@ module TerraformWrapper
     tasks << TerraformWrapper::Tasks::Binary.new(binary: binary)
     tasks << TerraformWrapper::Tasks::Clean.new(code: code)
     tasks << TerraformWrapper::Tasks::Destroy.new(binary: binary, code: code, options: config_options)
+    tasks << TerraformWrapper::Tasks::Import.new(binary: binary, code: code, options: config_options)
     tasks << TerraformWrapper::Tasks::Init.new(binary: binary, code: code, options: config_options)
     tasks << TerraformWrapper::Tasks::Plan.new(binary: binary, code: code, options: config_options)
     tasks << TerraformWrapper::Tasks::PlanDestroy.new(binary: binary, code: code, options: config_options)

data/lib/terraform-wrapper/shared/backends/aws.rb

@@ -29,6 +29,7 @@ module TerraformWrapper
 ###############################################################################
 
         attr_reader :bucket
+        attr_reader :encrypt
         attr_reader :key
         attr_reader :region
 
@@ -41,11 +42,17 @@ module TerraformWrapper
 ###############################################################################
 
         def hash()
-          return {
-            "bucket" => @bucket,
-            "key"    => @key,
-            "region" => @region
-          }
+          result = Hash.new
+
+          result["bucket"]  = @bucket
+          result["region"]  = @region
+          result["key"]     = @key
+          result["encrypt"] = @encrypt.to_s
+
+          result["kms_key_id"] = @kms  unless @kms.nil?
+          result["role_arn"]   = @role unless @role.nil?
+
+          return result
         end
 
 ###############################################################################
@@ -55,6 +62,9 @@ module TerraformWrapper
 ###############################################################################
 
         def specific()
+          kms  = nil
+          role = nil
+
           logger.fatal("AWS backend mandatory option 'bucket' has not been set!") unless @options.key?("bucket")
           logger.fatal("AWS backend mandatory option 'region' has not been set!") unless @options.key?("region")
 
@@ -73,6 +83,24 @@ module TerraformWrapper
           logger.fatal("AWS backend S3 bucket key must be a String!") unless key.kind_of?(String)
           logger.fatal("AWS backend S3 bucket key must not be blank!") if key.strip.empty?
 
+          encrypt = @options.key?("encrypt") ? @options["encrypt"] : true
+
+          logger.fatal("AWS backend S3 bucket encryption enabled must be a Boolean!") unless [ true, false ].include?(encrypt)
+
+          if @options.key?("kms") then
+            kms = @options["kms"]
+
+            logger.fatal("AWS backend S3 bucket encryption KMS key ARN must be a String if specified!") unless kms.kind_of?(String)
+            logger.fatal("AWS backend S3 bucket encryption KMS key ARN must not be blank if specified!") if kms.strip.empty?
+          end
+
+          if @options.key?("role") then
+            role = @options["role"]
+
+            logger.fatal("AWS backend role to assume ARN must be a String if specified!") unless role.kind_of?(String)
+            logger.fatal("AWS backend role to assume ARN must not be blank if specified!") if role.strip.empty?
+          end
+
           logger.fatal("AWS backend S3 bucket name or key must include %{service}.") unless (bucket.include?("%{service}") or key.include?("%{service}"))
           logger.fatal("AWS backend S3 bucket name or key must include %{config}.") unless (bucket.include?("%{config}") or key.include?("%{config}"))
           logger.fatal("AWS backend S3 bucket name or key must include %{component}.") unless  (bucket.include?("%{component}") or key.include?("%{component}"))
@@ -81,15 +109,20 @@ module TerraformWrapper
             bucket = bucket % @variables
             region = region % @variables
             key    = key    % @variables
+            kms    = kms    % @variables unless kms.nil?
+            role   = role   % @variables unless role.nil?
           rescue
             logger.fatal("AWS backend options contain variables that are not included in the configuration file!")
           end
 
           logger.fatal("Key: #{key} is too long for backend of type: #{@@type}") if key.length > 1024
 
-          @bucket = bucket
-          @region = region
-          @key    = key
+          @bucket  = bucket
+          @region  = region
+          @key     = key
+          @encrypt = encrypt
+          @kms     = kms
+          @role    = role
         end
 
 ###############################################################################

data/lib/terraform-wrapper/shared/logger.rb

@@ -39,19 +39,19 @@ module TerraformWrapper
 ###############################################################################
 
       def warn(message)
-        warn(format(colour: 33, message: message))
+        super(format(colour: 33, message: message))
       end
 
 ###############################################################################
 
       def error(message)
-        error(format(colour: 31, message: message))
+        super(format(colour: 31, message: message))
       end
 
 ###############################################################################
 
       def fatal(message)
-        fatal(format(colour: 31, message: message))
+        super(format(colour: 31, message: message))
         exit(1)
       end
 

data/lib/terraform-wrapper/shared/runner.rb

@@ -43,6 +43,28 @@ module TerraformWrapper
         logger.fatal("Failed to download Terraform modules.") unless @downloaded
       end
 
+###############################################################################
+
+      def import(address: nil, id: nil)
+        logger.fatal("Cannot Terraform import before initialising backend!") unless initialised
+
+        logger.fatal("Terraform state address for import must be a String!") unless address.kind_of?(String)
+        logger.fatal("Terraform state address for import must be a String!") unless address.kind_of?(String)
+        logger.fatal("Terraform state address for import must not be blank!") if address.strip.empty?
+
+        logger.fatal("Identification for infrastructure to import must be a String!") unless id.kind_of?(String)
+        logger.fatal("Identification for infrastructure to import must not be blank!") if id.strip.empty?
+
+        parameters = Array.new
+        parameters.concat(variable_files)
+        parameters.concat(variable_strings)
+        
+        parameters.append("\"#{address}\"")
+        parameters.append("\"#{id}\"")
+
+        logger.fatal("Terraform import failed!") unless run(action: "import", parameters: parameters)
+      end
+
 ###############################################################################
 
       def init(config:, upgrade: true)

data/lib/terraform-wrapper/tasks.rb

@@ -4,6 +4,7 @@ require_relative 'tasks/apply'
 require_relative 'tasks/binary'
 require_relative 'tasks/clean'
 require_relative 'tasks/destroy'
+require_relative 'tasks/import'
 require_relative 'tasks/init'
 require_relative 'tasks/plan'
 require_relative 'tasks/plandestroy'

data/lib/terraform-wrapper/tasks/import.rb

@@ -0,0 +1,70 @@
+###############################################################################
+
+require 'rake/tasklib'
+
+###############################################################################
+
+module TerraformWrapper
+
+###############################################################################
+
+  module Tasks
+
+###############################################################################
+
+    class Import < ::Rake::TaskLib
+
+###############################################################################
+
+      include TerraformWrapper::Shared::Logging
+
+###############################################################################
+
+      @binary
+      @code
+      @options
+
+###############################################################################
+
+      def initialize(binary:, code:, options:)
+        @binary  = binary
+        @code    = code
+        @options = options
+
+        yield self if block_given?
+
+        import_task
+      end
+
+###############################################################################
+
+      def import_task
+        desc "Import a piece of existing infrastructure into Terraform state for a given configuration on an infrastructure component."
+        task :import, [:config, :address, :id] => :binary do |t, args|
+          options = @options.merge({"name" => args[:config]})
+
+          logger.info("Processing configuration for Terraform import...")
+
+          config = TerraformWrapper::Shared::Config.new(code: @code, options: options)
+          runner = TerraformWrapper::Shared::Runner.new(binary: @binary, code: @code)
+
+          logger.info("Running Terraform import for service: #{config.service}, component: #{@code.name}...")
+
+          runner.init(config: config)
+          runner.import(address: args[:address], id: args[:id])
+        end
+      end
+
+###############################################################################
+
+    end
+
+###############################################################################
+
+  end
+
+###############################################################################
+
+end
+
+###############################################################################

data/lib/terraform-wrapper/version.rb

@@ -4,7 +4,7 @@ module TerraformWrapper
 
 ###############################################################################
 
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 
 ###############################################################################
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: terraform-wrapper
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Richard Lees
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-02-15 00:00:00.000000000 Z
+date: 2021-02-17 00:00:00.000000000 Z
 dependencies: []
 description: A ruby wrapper for managing Terraform binaries and remote state. Each
   Terraform command (plan, apply, etc) is wrapped so that the correct binary is used
@@ -50,6 +50,7 @@ files:
 - lib/terraform-wrapper/tasks/binary.rb
 - lib/terraform-wrapper/tasks/clean.rb
 - lib/terraform-wrapper/tasks/destroy.rb
+- lib/terraform-wrapper/tasks/import.rb
 - lib/terraform-wrapper/tasks/init.rb
 - lib/terraform-wrapper/tasks/plan.rb
 - lib/terraform-wrapper/tasks/plandestroy.rb