terradactyl 0.13.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0bcbb7e3e6b90e0099b5e9619a58e804382de149a01b8125eb66b05a2124e7f
-  data.tar.gz: 33653dc380bc7177bc32de91cf1e1c1d87a668d33a28e06d3cdd6c3bfaf77f72
+  metadata.gz: a7426368caebddb37fb99a029fe1868678b88e0fce83bcd57237ec6cd2b78436
+  data.tar.gz: 66d09971c29d06d319217b8bc9f42e1ad0af72e368e305a3903d140336f56e6d
 SHA512:
-  metadata.gz: 88ab36f3422ecb3ce7e4898d94de40fdb745e725ecefbf9c01bda7b9324e68b049fa872072cada1d3ca942ed909798032be310cc8c01dc1d333de26e4c4abfce
-  data.tar.gz: 5e20eb83847c02b02a5d92029135232906abd40ffb4327ce4fde71f7b038361e0da49b463a665298bf7d40683829edc3c8b8c2ddde36632be924299880e2281b
+  metadata.gz: 5782c0b917da8da15b6dab9dbe539de241b72b692ef52a9c9c328b34fd3a79999cac64ad0420db3fa4eaff9b208f5eddccdc201829164ff98f985d52e2a5afb2
+  data.tar.gz: 986f5d0e48a595ff800fa98cc542c7d337be11cf6bc22fdca6c1f4419938e88da4e54b64f2d8002abdc87d0c423417b2745f3c536c4c38f642476249f6c07766

data/.rubocop.yml

@@ -10,6 +10,8 @@ Metrics/CyclomaticComplexity:
   Max: 10
 Metrics/ClassLength:
   Max: 115
+Naming/ClassAndModuleCamelCase:
+  Enabled: false
 Naming/UncommunicativeMethodParamName:
   MinNameLength: 2
 Style/IfUnlessModifier:

data/CHANGELOG.md

@@ -1,5 +1,61 @@
 # CHANGELOG
 
+## 1.0.0 (2021-06-09)
+
+NEW FEATURES:
+
+* add support for Terraform version `~> 1.0.0`
+
+BUG FIXES:
+
+* fix bad test matrix
+
+## 0.15.3 (2021-05-14)
+
+BUG FIXES:
+
+* fix `auto-approve` on `destroy` subcommand for Terraform version 0.15
+* update all tests to use latest minor rev
+
+## 0.15.2 (2021-05-02)
+
+NEW FEATURES:
+
+* make all stacks upgradeable, regardless of binary version
+* add warning after upgrading to Terrafrom version 0.13
+* expanded testing
+
+BUG FIXES:
+
+* do not init backend during upgrade
+* fix edge case on stacks with no `versions.tf` file
+
+## 0.15.1 (2021-04-28)
+
+BUG FIXES:
+
+* repair broken `upgrade` subcommand
+  * fix malformed HCL substitution
+  * fix regex match order of operations bug
+  * make the feature more robust
+  * add better feedback
+
+## 0.15.0 (2021-04-27)
+
+NEW FEATURES:
+
+* add support for Terraform version `0.14.x`
+* add support for Terraform version `0.15.x`
+* add new subcommand `install`
+  * generic component installation; presently only supports `terraform`
+    - permits on-demand installation of any available Terraform binary
+* add new subcommand `upgrade`
+  * performs a Terraform upgrade of the target stack
+* add support for native HCL Terraform contraints
+  * terradactyl will now search for Terraform version contraints in the following files: `settings.tf`, `versions.tf` and `backend.tf`
+* update version expression parsing to match Terraform's own
+  * terradactyl version expression parsing should now operate the same way Terraform's own does, including support for version ranges
+
 ## 0.13.2 (2020-12-09)
 
 BUG FIXES:

data/README.md

@@ -19,7 +19,7 @@ Terradactyl simplifies managing large heterogeneous Terraform monorepos by intro
 
 Requires Ruby 2.5 or greater.
 
-NOTE: Terraform sub-command operations are only supported between stable versions `~> 0.11.x` and `~> 0.13.x`.
+NOTE: Terraform sub-command operations are only supported between stable versions `>= 0.11.x` to `~> 0.15.x`.
 
 ## Installation
 
@@ -83,6 +83,14 @@ The Terradactyl CLI is installed with a symlink so it may be called by its full
     $ terradactyl help
     $ td help
 
+#### install terraform
+
+##### NOTE: You do not need to explicitly install Terraform, it will be downloaded and installed automatically, if your stack is configured to do so -- this is just to demonstrate on-demand installs ...
+
+This is optional!
+
+    $ terradactyl install terraform --version=0.15.1
+
 #### quickplan a single stack
 
 You can specify the relative path to the stack OR the just the stack name. These two commands are equivalent:
@@ -110,6 +118,18 @@ When complete, you should have a JSON report that you can pass to other processe
 
     $ terradactyl smartapply
 
+#### upgrade a legacy stack
+
+Running this one time will upgrade it to next minor revision of Terraform ...
+
+    # Take me to Terraform v12
+    $ terradactyl upgrade stacks/tfv11
+
+Running it again will bump it again!
+
+    # Take me to Terraform v13
+    $ terradactyl upgrade stacks/tfv11
+
 #### clean all the stacks
 
     $ terradactyl clean-all
@@ -122,7 +142,7 @@ See the [Configuration](#configuration) section for more info on how to control
 
 ## Operation
 
-NOTE: `terradactyl` (symlinked as `td`) ONLY operates in the root of your monorepo. In order to execute any sub-commands, your working directory must contain your project-level configuration file, otherwise you will receive this:
+NOTE: `terradactyl` (symlinked as `td`) ONLY operates in the root of your monorepo. In order to execute any subcommands, your working directory must contain your project-level configuration file, otherwise you will receive this:
 
     FATAL: Could not load project file: `terradactyl.yaml`, No such file or directory @ rb_sysopen - terradactyl.yaml
 
@@ -135,9 +155,9 @@ Generally speaking, Terradactyl operates on the principle of **plan file** (`*.t
 
 In some cases, this might seem onerous, but it pays dividends in team workflow and CI/CD contexts.
 
-### Supported sub-commands
+### Supported subcommands
 
-Terradactyl was created to facilitate the using Terraform in a CI environment. As such, some of the more exotic ad hoc user-focused sub-commands have not received any effort in integration. The following is a list of the supported Terraform sub-commands:
+Terradactyl was created to facilitate the using Terraform in a CI environment. As such, some of the more exotic ad hoc user-focused subcommands have not received any effort in integration. The following is a list of the supported Terraform subcommands:
 
 * apply
 * destroy
@@ -147,6 +167,32 @@ Terradactyl was created to facilitate the using Terraform in a CI environment. A
 * refresh
 * validate
 
+### Special utility subcommands
+
+Terradactyl add some unique utility commands that permit you to more readily manage your Terraform stacks.
+
+#### install
+
+Installs supporting components, namely Terraform itself...
+
+    # Install the latest terraform binary
+    terradactly install terraform
+
+    # Install pessimistic version
+    terradactyl install terraform --version="~> 0.13.0"
+
+    # Install ranged version
+    terradactyl install terraform --version=">= 0.14.5, <= 0.14.7"
+
+    # Install explicit version
+    terradactyl install terraform --version=0.15.0-beta2
+
+#### upgrade
+
+Upgrade abstracts the various Terraform subcommands related to upgrading individual stacks.
+
+    terradactyl upgrade <stack>
+
 ### Meta-commands
 
 Terradactyl provides a few useful meta-commands that can help you avoid repetitive multi-phase Terraform operations. Here are a few ...
@@ -166,7 +212,7 @@ Apply or Refresh _ANY_ stack containing a plan file.
 
 ### Getting Help
 
-For a list of available sub-commands do:
+For a list of available subcommands do:
 
     $ terradactyl help
 
@@ -195,7 +241,7 @@ You can dump the compiled configuration for your project using the `defaults` su
 ```yaml
 terradactyl:              <Object, Terradactyl config>
   base_folder:            <String, the sub-directory for all your Terraform stacks, default=stacks>
-  terraform:              <Object, configuration to Terraform sub-commands and binaries>
+  terraform:              <Object, configuration to Terraform subcommands and binaries>
     binary:               <String, path to the Terraform binary you wish to use, default=nil>
     version:              <String, explicit or implict Terraform version, default=nil>
     autoinstall:          <Bool, perform automatic Terraform installations, default=true>
@@ -228,7 +274,7 @@ terradactyl:              <Object, Terradactyl config>
 
 ### Terraform sub-command arguments
 
-Note that the config above contains config for Terraform sub-commands. for example:
+Note that the config above contains config for Terraform subcommands. for example:
 
 ```yaml
 terradactyl:
@@ -243,12 +289,12 @@ Each of the keys in the `plan` object correspond to an argument passed to the `t
 
     terraform -lock=false -parallelism=5 -detailed-exitcode
 
-There are two conventions to keep in mind when configuring sub-commands:
+There are two conventions to keep in mind when configuring subcommands:
 
 1. any sub-command option which toggles behaviour (i.e. `-detailed-exitcode`) requires a specific Boolean value of `true` OR `false`
 2. any sub-command option that is hyphenated (i.e. `-detailed-exitcode`) is set in the config using an **underscore** (i.e `detailed_exitcode`)
 
-If you need to tweak or augment any of the default arguments passed to any of the supported Terraform sub-commands, you can do so by adding them to the config.
+If you need to tweak or augment any of the default arguments passed to any of the supported Terraform subcommands, you can do so by adding them to the config.
 
 Example:
 
@@ -260,7 +306,7 @@ terradactyl:
       backup: /tmp/tfbackup
 ```
 
-In addition, you can override the `echo` and `quiet` settings for any of the Terraform sub-commands:
+In addition, you can override the `echo` and `quiet` settings for any of the Terraform subcommands:
 
 ```yaml
 terradactyl:
@@ -279,9 +325,29 @@ This can assist in debugging.
 
 ### Terraform version management
 
+Terradactyl gives you some powerful ways to manage which versions of Terraform you support and where.
+
+You may set **project-wide** OR **stack-explicit** versions, by using a config file (`terradactyl.yaml`, see [Configuration](#configuration)).
+
+In addition, Terradactyl will also, search for a stack's desired Terraform version from one of **your HCL files**.
+
+    terraform {
+      required_version = "~> 0.13.0"
+    }
+
+If a configuration like the one above is discovered in your stack's ...
+
+  * `settings.tf`
+  * `versions.tf`
+  * `backend.tf`
+
+... file, Terradactyl will download and use that version as required.
+
+NOTE: These files are searched in the order you see above. If you specify `required_version` multiple times, the last one discovered is used.
+
 #### Explicit versions
 
-By default, Terradactyl will always use the **latest** stable version of Terraform. If you do not specify a version, you will always get the latest stable version of Terraform available.
+By default, Terradactyl will always use the **latest** stable version of Terraform. So, if you don't specify a version, you will always get the latest stable version of Terraform available.
 
 But, as part of Terradactyl's configuration, you can specify a **project** Terraform version, making it the default for _your_ monorepo:
 
@@ -291,7 +357,9 @@ terradactyl:
     version: 0.12.29
 ```
 
-Still, because Terradactyl's configuration is hierarchic, in addition the default version you specify at the project level, **each stack** may also specify a different version of Terraform.
+Still, because Terradactyl's configuration is hierarchic, you can also specify a version at the project level ...
+
+Yes! **Each stack may use a different version of Terradactyl independent of any other.**
 
 See [examples/multi-tf-version](examples/multi-tf-version) for this setup.
 

data/examples/multi-tf-version/stacks/tfv11/terradactyl.yaml

@@ -1,3 +1,3 @@
 terradactyl:
   terraform:
-    version: '0.11.14' # an explicit version
+    version: ~> 0.11.14

data/examples/multi-tf-version/stacks/tfv12/example.tf

@@ -1 +1,3 @@
-resource "null_resource" "bar" {}
+resource "null_resource" "bar" {
+}
+

data/examples/multi-tf-version/stacks/tfv12/versions.tf

@@ -0,0 +1,3 @@
+terraform {
+  required_version = "~> 0.12.0"
+}

data/examples/multi-tf-version/stacks/tfv13/versions.tf

@@ -0,0 +1,8 @@
+terraform {
+  required_providers {
+    null = {
+      source = "hashicorp/null"
+    }
+  }
+  required_version = "~> 0.13.0"
+}

data/examples/multi-tf-version/stacks/tfv14/example.tf

@@ -0,0 +1 @@
+resource "null_resource" "baz" {}

data/examples/multi-tf-version/stacks/tfv14/versions.tf

@@ -0,0 +1,8 @@
+terraform {
+  required_providers {
+    null = {
+      source = "hashicorp/null"
+    }
+  }
+  required_version = "~> 0.14.0"
+}

data/examples/multi-tf-version/stacks/tfv15/example.tf

@@ -0,0 +1 @@
+resource "null_resource" "baz" {}

data/examples/multi-tf-version/stacks/tfv15/versions.tf

@@ -0,0 +1,8 @@
+terraform {
+  required_providers {
+    null = {
+      source = "hashicorp/null"
+    }
+  }
+  required_version = "~> 0.15.0"
+}

data/examples/multi-tf-version/terradactyl.yaml

@@ -1,3 +1,3 @@
 terradactyl:
   terraform:
-    version: 0.12.29
+    version: 0.15.1

data/lib/terradactyl/cli.rb

@@ -1,5 +1,24 @@
 # frozen_string_literal: true
 
+# Fix for https://github.com/erikhuda/thor/issues/398
+class Thor
+  module Shell
+    class Basic
+      def print_wrapped(message, options = {})
+        indent = (options[:indent] || 0).to_i
+        if indent.zero?
+          stdout.puts message
+        else
+          message.each_line do |message_line|
+            stdout.print ' ' * indent
+            stdout.puts message_line.chomp
+          end
+        end
+      end
+    end
+  end
+end
+
 module Terradactyl
   # rubocop:disable Metrics/ClassLength
   class CLI < Thor
@@ -14,6 +33,7 @@ module Terradactyl
       super
     end
 
+    # rubocop:disable Metrics/BlockLength
     no_commands do
       # Monkey-patch Thor internal method to break out of nested calls
       def invoke_command(command, *args)
@@ -43,7 +63,27 @@ module Terradactyl
         File.write data_file, JSON.pretty_generate(report)
         print_ok 'Done!'
       end
+
+      def terraform_latest
+        Terradactyl::Terraform::VersionManager.latest
+      end
+
+      def upgrade_stack(name)
+        @stack ||= Stack.new(name)
+        print_warning "Upgrading: #{@stack.name}"
+        if @stack.upgrade.zero?
+          print_ok "Upgraded: #{@stack.name}"
+        else
+          Stacks.error!(@stack)
+          print_crit "Failed to upgrade: #{@stack.name}"
+          throw :error
+        end
+      rescue Terradactyl::Terraform::VersionManager::VersionManagerError => e
+        print_crit "Error: #{e.message}"
+        exit 1
+      end
     end
+    # rubocop:enable Metrics/BlockLength
 
     #################################################################
     # GENERIC TASKS
@@ -128,6 +168,14 @@ module Terradactyl
     # the `quickplan` task is an exception to this rule.
     #################################################################
 
+    desc 'upgrade NAME', 'Cleans, inits, upgrades and formats an individual stack, by name'
+    def upgrade(name)
+      clean(name)
+      init(name, backend: false)
+      upgrade_stack(name)
+      fmt(name)
+    end
+
     desc 'quickplan NAME', 'Clean, init and plan a stack, by name'
     def quickplan(name)
       print_header "Quick planning #{name} ..."
@@ -224,8 +272,10 @@ module Terradactyl
     end
 
     desc 'init NAME', 'Init an individual stack, by name'
-    def init(name)
+    def init(name, backend: true)
       @stack ||= Stack.new(name)
+      @stack.config.terraform.init.backend = backend
+
       print_ok "Initializing: #{@stack.name}"
       if @stack.init.zero?
         print_ok "Initialized: #{@stack.name}"
@@ -247,7 +297,7 @@ module Terradactyl
       when 1
         Stacks.error!(@stack)
         print_crit "Plan failed: #{@stack.name}"
-        @stack.print_plan
+        @stack.print_error
         throw :error
       when 2
         Stacks.dirty!(@stack)
@@ -289,13 +339,7 @@ module Terradactyl
       print_ok "Cleaned: #{@stack.name}"
     end
 
-    #################################################################
-    # HIDDEN TARGETED STACK TASKS
-    # * These tasks are destructive in nature and do not require
-    # regular use.
-    #################################################################
-
-    desc 'apply NAME', 'Apply an individual stack, by name', hide: true
+    desc 'apply NAME', 'Apply an individual stack, by name'
     def apply(name)
       @stack ||= Stack.new(name)
       print_warning "Applying: #{@stack.name}"
@@ -307,7 +351,7 @@ module Terradactyl
       end
     end
 
-    desc 'refresh NAME', 'Refresh state on an individual stack, by name', hide: true
+    desc 'refresh NAME', 'Refresh state on an individual stack, by name'
     def refresh(name)
       @stack ||= Stack.new(name)
       print_crit "Refreshing: #{@stack.name}"
@@ -319,7 +363,7 @@ module Terradactyl
       end
     end
 
-    desc 'destroy NAME', 'Destroy an individual stack, by name', hide: true
+    desc 'destroy NAME', 'Destroy an individual stack, by name'
     def destroy(name)
       @stack ||= Stack.new(name)
       print_crit "Destroying: #{@stack.name}"
@@ -330,6 +374,53 @@ module Terradactyl
         print_crit "Failed to apply changes: #{@stack.name}"
       end
     end
+
+    #################################################################
+    # PROJECT-LEVEL UTILITY TASKS
+    # * These tasks are managing project-wide characteristics or
+    # invoking useful commands.
+    #################################################################
+
+    desc 'install COMPONENT', 'Installs specified component'
+    long_desc <<~LONGDESC
+      The `terradactyl install COMPONENT` subcommand perfoms installations of
+      prerequisties. At present, only Terraform binaries are supported.
+
+      Here are a few examples:
+
+      # Install latest
+      `terradactyl install terraform`
+
+      # Install pessimistic version
+      `terradactyl install terraform --version="~> 0.13.0"`
+
+      # Install ranged version
+      `terradactyl install terraform --version=">= 0.14.5, <= 0.14.7"`
+
+      # Install explicit version
+      `terradactyl install terraform --version=0.15.0-beta2`
+
+    LONGDESC
+    option :version, type: :string, default: 'latest'
+    # rubocop:disable Metrics/AbcSize
+    def install(component)
+      case component.to_sym
+      when :terraform
+        print_warning "Installing: #{component}, version: #{options[:version]}"
+        version = options[:version] == 'latest' ? terraform_latest : options[:version]
+        Terradactyl::Terraform::VersionManager.reset!
+        Terradactyl::Terraform::VersionManager.version = version
+        Terradactyl::Terraform::VersionManager.install
+        if Terradactyl::Terraform::VersionManager.binary
+          print_ok "Installed: #{Terradactyl::Terraform::VersionManager.binary}"
+        end
+      else
+        msg = %(Operation not supported -- I don't know how to install: #{component})
+        print_crit msg
+        exit 1
+      end
+    end
+    # rubocop:enable Metrics/AbcSize
   end
   # rubocop:enable Metrics/ClassLength
 end

data/lib/terradactyl/commands.rb

@@ -1,13 +1,70 @@
 # frozen_string_literal: true
 
 module Terradactyl
+  module Terraform
+    module Subcommands
+      module Upgrade
+        def defaults
+          {
+            'yes' => false
+          }
+        end
+
+        def switches
+          %w[
+            yes
+          ]
+        end
+      end
+    end
+
+    module Commands
+      class Upgrade < Base
+        def execute
+          VersionManager.install
+          return 0 unless revision.upgradeable?
+
+          super
+        end
+
+        def next_version
+          @next_version ||= compute_upgrade
+        end
+
+        private
+
+        def revision
+          Terradactyl::Stack.revision
+        end
+
+        def compute_upgrade
+          maj, min, _rev = version.split('.')
+          resolution = VersionManager.resolve("~> #{maj}.#{min.to_i + 1}.0")
+          VersionManager.version = resolution
+          VersionManager.version
+        end
+
+        def subcmd
+          pre = version.slice(/\d+\.\d+/)
+          sig = self.class.name.split('::').last.downcase
+          sig == 'base' ? '' : "#{pre}#{sig}"
+        end
+      end
+    end
+  end
+
+  # rubocop:disable Metrics/ModuleLength
   module Commands
     class << self
       def extend_by_revision(tf_version, object)
         anon_module = revision_module
+        revision    = revision_constant(tf_version)
 
         anon_module.include(self)
-        anon_module.prepend(revision_constant(tf_version))
+        anon_module.prepend(revision)
+
+        object.class.define_singleton_method(:revision) { revision }
+        object.define_singleton_method(:revision) { revision }
 
         object.extend(anon_module)
       end
@@ -41,8 +98,8 @@ module Terradactyl
       end
 
       def revision_constant(tf_version)
-        revision_name = ['Rev', *tf_version.split('.').take(2)].join
-        const_get(revision_name)
+        revision = Terradactyl::Terraform.calc_revision(tf_version)
+        const_get(revision)
       end
     end
 
@@ -63,18 +120,17 @@ module Terradactyl
                               options: options,
                               capture: true)
 
-      output = case captured.exitstatus
-               when 0
-                 'No changes. Infrastructure is up-to-date.'
-               when 1
-                 captured.stderr
-               when 2
-                 captured.stdout
-               end
+      @plan_file_obj = load_plan_file
 
-      @plan_file_obj             = load_plan_file
-      @plan_file_obj.plan_output = output
-      @plan_file_obj.save
+      case captured.exitstatus
+      when 0
+        'No changes. Infrastructure is up-to-date.'
+      when 1
+        @plan_file_obj.error_output = captured.stderr
+      when 2
+        @plan_file_obj.plan_output = captured.stdout
+        @plan_file_obj.save
+      end
 
       captured.exitstatus
     end
@@ -118,19 +174,149 @@ module Terradactyl
     end
     # rubocop:enable Metrics/AbcSize
 
+    def upgrade
+      perform_upgrade
+    end
+
     private
 
+    def versions_file
+      'versions.tf'
+    end
+
+    def settings_files
+      Dir.glob('*.tf').each_with_object([]) do |file, memo|
+        File.open(file, 'r').each_line do |line|
+          if line.match(Common.required_versions_re)
+            memo << file
+            break
+          end
+        end
+      end
+    end
+
+    def sanitize_terraform_settings
+      settings_files.each do |file|
+        next if file == versions_file
+
+        write_stream = Tempfile.new(Common.tag)
+        File.open(file, 'r').each_line do |line|
+          write_stream.puts line unless line.match(Common.required_versions_re)
+        end
+        write_stream.close
+        FileUtils.mv(write_stream.path, file)
+      end
+    end
+
+    def update_required_version(upgrade_version)
+      if File.exist?(versions_file)
+        settings = File.read(versions_file)
+        if (req_version = settings.match(Common.required_versions_re))
+          substitution = %(#{req_version[:assignment]}"~> #{upgrade_version}")
+          settings.sub!(Common.required_versions_re, substitution)
+        end
+      else
+        # This is ugly, so let's explain ...
+        #
+        # When the versions.tf is present, but the stack is ~> 0.11.0, the
+        # `terraform 0.12upgrade` subcommand will FAIL because it uses the
+        # presence of this file as the sole gauge as to whether or not
+        # the stack can be upgraded. So, why not just use `-force`? Haha yes ...
+        #
+        # When the `versions.tf` file exists and the `-force` flag is passed,
+        # it will create a `versions-1.tf` file ... FML :facepalm:
+        #
+        # So, make the creation of a de facto versions.tf contingent upon the
+        # Terraform upgrade_version. Yay.
+        unless upgrade_version =~ /0\.12/
+          settings = <<~VERSIONS
+            terraform {
+              required_version = "~> #{upgrade_version}"
+            }
+          VERSIONS
+        end
+      end
+
+      File.write(versions_file, settings) if settings
+    end
+
+    def upgrade_notice
+      output = File.read('versions.tf')
+      insert = output.strip.split("\n").map { |l| "    #{l}" }.join($INPUT_RECORD_SEPARATOR)
+
+      <<~NOTICE
+        This stack has been upgraded to version the described below and its
+        Terradactly config file (if it existed) has been removed.
+
+        #{insert}
+
+        NOTES:
+
+         • ALL Terraform version constraints are now specified in `versions.tf` using
+          the `required_version` directive.
+
+         • If your stack already contained one or more `required_version` directives,
+          they have been consolidated into a single directive in `versions.tf`.
+
+         • Terraform provider version contraints ARE NOT upgraded automatically. You
+          will need to edit these MANUALLY.
+
+         • Before proceeding. please perform a `terradactyl quickplan` on your stack
+          to ensure the upgraded stack functions as intended.
+      NOTICE
+    end
+
+    def upgrade_notice_rev013
+      <<~NOTICE
+        STOP UPGRADING!
+
+              Upgrading from Terraform 0.12 to 0.13 requires an apply to be performed
+              before continuing ...
+
+              DO NOT attempt to upgrade any further without first committing the existing
+              changes and seeing they are applied.
+
+              See the documentation here if you require more infomation ...
+
+              https://www.terraform.io/upgrade-guides/0-13.html
+      NOTICE
+    end
+
+    # rubocop:disable  Metrics/AbcSize
+    def perform_upgrade
+      options = command_options.tap { |dat| dat.yes = true }
+      upgrade = Upgrade.new(dir_or_plan: nil, options: options)
+
+      sanitize_terraform_settings
+
+      update_required_version(upgrade.next_version)
+
+      if (result = upgrade.execute).zero?
+        update_required_version(upgrade.next_version)
+        FileUtils.rm_rf('terradactyl.yaml') if File.exist?('terradactyl.yaml')
+      end
+
+      print_content(upgrade_notice) if result.zero?
+
+      print_crit(upgrade_notice_rev013) if upgrade.next_version =~ /0\.13/
+
+      result
+    end
+    # rubocop:enable  Metrics/AbcSize
+
     def load_plan_file
       Terraform::PlanFile.new(plan_path: plan_file, parser: parser)
     end
 
     module Rev011
-      include Terraform::Commands
-
-      def checklist
-        Checklist.execute(dir_or_plan: nil, options: command_options)
+      class << self
+        def upgradeable?
+          true
+        end
       end
 
+      include Terraform::Commands
+
       private
 
       def parser
@@ -139,6 +325,12 @@ module Terradactyl
     end
 
     module Rev012
+      class << self
+        def upgradeable?
+          true
+        end
+      end
+
       include Terraform::Commands
 
       private
@@ -149,13 +341,68 @@ module Terradactyl
     end
 
     module Rev013
+      class << self
+        def upgradeable?
+          false
+        end
+      end
+
       include Terraform::Commands
 
       private
 
       def parser
-        Terraform::Rev012::PlanFileParser
+        Terraform::Rev013::PlanFileParser
+      end
+    end
+
+    module Rev014
+      class << self
+        def upgradeable?
+          false
+        end
+      end
+
+      include Terraform::Commands
+
+      private
+
+      def parser
+        Terraform::Rev014::PlanFileParser
+      end
+    end
+
+    module Rev015
+      class << self
+        def upgradeable?
+          false
+        end
+      end
+
+      include Terraform::Commands
+
+      private
+
+      def parser
+        Terraform::Rev015::PlanFileParser
+      end
+    end
+
+    module Rev1_00
+      class << self
+        def upgradeable?
+          false
+        end
+      end
+
+      include Terraform::Commands
+
+      private
+
+      def parser
+        Terraform::Rev1_00::PlanFileParser
       end
     end
   end
+  # rubocop:enable Metrics/ModuleLength
 end

data/lib/terradactyl/common.rb

@@ -7,6 +7,14 @@ module Terradactyl
 
     module_function
 
+    def required_versions_re
+      /(?<assignment>(?:\n\s)*required_version\s+=\s+)(?<value>".*?")/m
+    end
+
+    def supported_revisions
+      Terradactyl::Commands.constants.select { |c| c =~ /Rev/ }.sort
+    end
+
     def config
       @config ||= ConfigProject.instance
     end

data/lib/terradactyl/config.rb

@@ -26,7 +26,7 @@ module Terradactyl
             input: false
           destroy:
             parallelism: 5
-            force: true
+            auto_approve: true
         environment:
           TF_PLUGIN_CACHE_DIR: ~/.terraform.d/plugins
         misc:
@@ -132,6 +132,12 @@ module Terradactyl
   end
 
   class ConfigStack < ConfigApplication
+    TERRAFORM_SETTINGS_FILES = %w[
+      settings.tf
+      versions.tf
+      backend.tf
+    ].freeze
+
     attr_reader :stack_name, :stack_path, :base_folder
 
     def initialize(stack_name)
@@ -163,5 +169,50 @@ module Terradactyl
     def plan_path
       "#{stack_path}/#{plan_file}"
     end
+
+    def versions_file
+      "#{stack_path}/versions.tf"
+    end
+
+    private
+
+    def terraform_required_version
+      matches = TERRAFORM_SETTINGS_FILES.each_with_object([]) do |file, memo|
+        path = File.join(stack_path, file)
+        next unless File.exist?(path)
+
+        File.readlines(path).each do |line|
+          next if line =~ /(?:\s*#\s*)/
+
+          if (match = line.match(Common.required_versions_re))
+            memo << match
+          end
+        end
+      end
+
+      return {} unless matches.any?
+
+      {
+        'terradactyl' => {
+          'terraform' => {
+            'version' => matches.last[:value].delete('"')
+          }
+        }
+      }
+    end
+
+    def load_overlay(config_file)
+      overlay = super(config_file)
+
+      unless overlay_specifies_version?(overlay)
+        overlay.merge!(terraform_required_version)
+      end
+
+      overlay
+    end
+
+    def overlay_specifies_version?(overlay)
+      overlay['terradactyl']&.fetch('terraform', {})&.fetch('version', nil)
+    end
   end
 end

data/lib/terradactyl/stack.rb

@@ -48,6 +48,10 @@ module Terradactyl
       print_content(plan_file_obj.plan_output)
     end
 
+    def print_error
+      print_content(plan_file_obj.error_output)
+    end
+
     def plan_file_obj
       @plan_file_obj ||= load_plan_file
     end

data/lib/terradactyl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Terradactyl
-  VERSION = '0.13.2'
+  VERSION = '1.0.0'
 end

data/terradactyl.gemspec

@@ -33,11 +33,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'deep_merge', '~> 1.2'
   spec.add_dependency 'bundler', '>= 1.16'
   spec.add_dependency 'rake', '>= 10.0'
-  spec.add_dependency 'terradactyl-terraform', '>= 0.3.1'
+  spec.add_dependency 'terradactyl-terraform', '>= 1.0.0'
 
   spec.add_development_dependency 'rspec', '~> 3.0'
   spec.add_development_dependency 'pry', '~> 0.12'
   spec.add_development_dependency 'pry-remote', '~> 0.1.8'
   spec.add_development_dependency 'rubocop', '~> 0.71.0'
 end
-

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: terradactyl
 version: !ruby/object:Gem::Version
-  version: 0.13.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Brian Warsing
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-12-09 00:00:00.000000000 Z
+date: 2021-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -186,9 +186,13 @@ files:
 - examples/multi-tf-version/stacks/tfv11/example.tf
 - examples/multi-tf-version/stacks/tfv11/terradactyl.yaml
 - examples/multi-tf-version/stacks/tfv12/example.tf
-- examples/multi-tf-version/stacks/tfv12/terradactyl.yaml
+- examples/multi-tf-version/stacks/tfv12/versions.tf
 - examples/multi-tf-version/stacks/tfv13/example.tf
-- examples/multi-tf-version/stacks/tfv13/terradactyl.yaml
+- examples/multi-tf-version/stacks/tfv13/versions.tf
+- examples/multi-tf-version/stacks/tfv14/example.tf
+- examples/multi-tf-version/stacks/tfv14/versions.tf
+- examples/multi-tf-version/stacks/tfv15/example.tf
+- examples/multi-tf-version/stacks/tfv15/versions.tf
 - examples/multi-tf-version/terradactyl.yaml
 - examples/simple/stacks/demo/example.tf
 - examples/simple/terradactyl.yaml
@@ -227,7 +231,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Manage a Terraform monorepo

data/examples/multi-tf-version/stacks/tfv12/terradactyl.yaml

@@ -1,3 +0,0 @@
-terradactyl:
-  terraform:
-    version: 0.12.29

data/examples/multi-tf-version/stacks/tfv13/terradactyl.yaml

@@ -1,3 +0,0 @@
-terradactyl:
-  terraform:
-    version: '~> 0.13.5' # >= 0.13.5 && < 0.14.0