terraspace 0.2.4 → 0.3.4

data/lib/terraspace/cli/all.rb

@@ -0,0 +1,63 @@
+class Terraspace::CLI
+  class All < Terraspace::Command
+    class_option :yes, aliases: :y, type: :boolean, desc: "auto approve all batch commands"
+    class_option :exit_on_fail, type: :boolean, desc: "whether or not to exit when one of the batch commands fails"
+
+    desc "down", "Destroy all or multiple stacks."
+    long_desc Help.text("all/down")
+    option :destroy_workspace, type: :boolean, desc: "Also destroy the Cloud workspace. Only applies when using Terraform Cloud remote backend."
+    def down(*stacks)
+      Terraspace::All::Runner.new("down", @options.merge(stacks: stacks)).run
+    end
+
+    desc "graph", "Draw a dependency graph."
+    long_desc Help.text("all/graph")
+    option :format, default: "png", desc: "format: text or diagram"
+    option :full,type: :boolean, desc: "draw the full graph with highlighted nodes or draw the subgraph. text format defaults to false, graph format defaults to true"
+    def graph(*stacks)
+      Terraspace::All::Grapher.new(@options.merge(stacks: stacks)).run
+    end
+
+    desc "refresh", "Refresh all or multiple stacks."
+    long_desc Help.text("all/refresh")
+    def refresh(*stacks)
+      Terraspace::All::Runner.new("refresh", @options.merge(stacks: stacks)).run
+    end
+
+    desc "output", "Show output for all or multiple stacks."
+    long_desc Help.text("all/output")
+    def output(*stacks)
+      Terraspace::All::Runner.new("output", @options.merge(stacks: stacks)).run
+    end
+
+    desc "plan", "Run plan for all or multiple stacks."
+    long_desc Help.text("all/plan")
+    def plan(*stacks)
+      Terraspace::All::Runner.new("plan", @options.merge(stacks: stacks)).run
+    end
+
+    desc "providers", "Show providers for all or multiple stacks."
+    long_desc Help.text("all/providers")
+    def providers(*stacks)
+      Terraspace::All::Runner.new("providers", @options.merge(stacks: stacks)).run
+    end
+
+    desc "show", "Run show for all or multiple stacks."
+    long_desc Help.text("all/show")
+    def show(*stacks)
+      Terraspace::All::Runner.new("show", @options.merge(stacks: stacks)).run
+    end
+
+    desc "up", "Deploy all or multiple stacks."
+    long_desc Help.text("all/up")
+    def up(*stacks)
+      Terraspace::All::Runner.new("up", @options.merge(stacks: stacks)).run
+    end
+
+    desc "validate", "Validate all or multiple stacks."
+    long_desc Help.text("all/validate")
+    def validate(*stacks)
+      Terraspace::All::Runner.new("validate", @options.merge(stacks: stacks)).run
+    end
+  end
+end

data/lib/terraspace/cli/build/placeholder.rb

@@ -16,7 +16,7 @@ module Terraspace::CLI::Build
       return if ENV['TS_SUMMARY_BUILD'] == '0'
 
       mod = @options[:mod]
-      if !mod or mod == "placeholder"
+      if !mod or %w[placeholder].include?(mod)
         logger.info "Building one of the modules to get backend.tf info"
         mod = find_mod
       end
@@ -28,10 +28,7 @@ module Terraspace::CLI::Build
     def find_mod
       mod_path = Dir.glob("{app,vendor}/{modules,stacks}/*").last
       unless mod_path
-        logger.info <<~EOL
-          No modules or stacks found.
-          Unable to determine the backend state path without at least one module.
-        EOL
+        logger.info "No modules or stacks found."
         exit 0
       end
       File.basename(mod_path) # mod name

data/lib/terraspace/cli/bundle.rb

@@ -1,5 +1,5 @@
 require "terraspace-bundler"
-TerraspaceBundler.logger = Terraspace.logger
+TerraspaceBundler.config.logger = Terraspace.logger
 
 class Terraspace::CLI
   class Bundle

data/lib/terraspace/cli/check_setup.rb

@@ -40,6 +40,10 @@ class Terraspace::CLI
 
     def ok?
       version = terraform_version_message.sub(/.*v/,'') # => 0.12.24
+      unless version.match(/\d+\.\d+\.\d+/) # just parse did not find the version number
+        puts "WARN: Unable to get the terraform version".color(:yellow)
+        return true
+      end
       major, minor, _ = version.split('.')
       required_major, required_minor = REQUIRED_TERRAFORM_VERSION.split('.')
       x = major.to_i >= required_major.to_i
@@ -62,6 +66,7 @@ class Terraspace::CLI
     #     Your version of Terraform is out of date! The latest version
     #     is 0.12.26. You can update by downloading from https://www.terraform.io/downloads.html
     #
+    # Note: The -json option is only available in v0.13+
     def terraform_version_message
       `terraform --version`.split("\n").find { |l| l =~ /^Terraform / }.strip
     end

data/lib/terraspace/cli/cloud.rb

@@ -1,24 +1,34 @@
 class Terraspace::CLI
   class Cloud < Terraspace::Command
+    Syncer = Terraspace::Terraform::Cloud::Syncer
     Workspace = Terraspace::Terraform::Cloud::Workspace
 
+    yes_option = Proc.new {
+      option :yes, aliases: :y, type: :boolean, desc: "bypass are you sure prompt"
+    }
+
     desc "list", "List workspaces"
     long_desc Help.text("cloud:list")
+    yes_option.call
     def list
       Workspace.new(options).list
     end
 
-    desc "destroy STACK", "Destroy workspace"
+    desc "destroy STACK", "Destroy workspace by specifying the stack"
     long_desc Help.text("cloud:destroy")
-    option :yes, aliases: :y, type: :boolean, desc: "bypass are you sure prompt"
     def destroy(mod)
       Workspace.new(options.merge(mod: mod)).destroy
     end
 
-    desc "setup STACK", "Setup workspace"
-    long_desc Help.text("cloud:setup")
-    def setup(mod)
-      Workspace.new(options.merge(mod: mod)).setup
+    desc "sync [STACK]", "Sync all or multiple workspaces."
+    long_desc Help.text("cloud:sync")
+    yes_option.call
+    def sync(*stacks)
+      Syncer.new(options.merge(stacks: stacks, override_auto_sync: true)).run
     end
+
+    desc "runs SUBCOMMAND", "runs subcommands"
+    long_desc Help.text(:runs)
+    subcommand "runs", Runs
   end
 end

data/lib/terraspace/cli/cloud/runs.rb

@@ -0,0 +1,22 @@
+class Terraspace::CLI::Cloud
+  class Runs < Terraspace::Command
+    Help = Terraspace::CLI::Help
+    Runs = Terraspace::Terraform::Cloud::Runs
+
+    desc "list STACK", "List runs."
+    long_desc Help.text("cloud:runs:list")
+    option :format, desc: "Output formats: #{CliFormat.formats.join(', ')}"
+    option :status, default: %w[pending planned], type: :array, desc: "Filter by statuses: pending, planned, all"
+    def list(mod)
+      Runs.new(options.merge(mod: mod)).list
+    end
+
+    desc "prune STACK", "Prune runs that are possible to cancel or discard."
+    long_desc Help.text("cloud:runs:prune")
+    option :noop, type: :boolean, desc: "Shows what would be cancelled/discarded."
+    option :yes, aliases: :y, type: :boolean, desc: "bypass are you sure prompt"
+    def prune(mod)
+      Runs.new(options.merge(mod: mod)).prune
+    end
+  end
+end

data/lib/terraspace/cli/commander.rb

@@ -5,17 +5,10 @@ class Terraspace::CLI
       super(options)
     end
 
-    # Commander always runs Build#run
     def run
-      Terraspace::Builder.new(@options).run # generate and init
-      auto_create_backend
+      Terraspace::Builder.new(@options).run unless @options[:build] # Up already ran build
       Init.new(@options.merge(calling_command: @name)).run
       Terraspace::Terraform::Runner.new(@name, @options).run
     end
-
-    def auto_create_backend
-      return unless @name == "apply"
-      Terraspace::Compiler::Backend.new(@mod).create
-    end
   end
 end

data/lib/terraspace/cli/down.rb

@@ -0,0 +1,20 @@
+class Terraspace::CLI
+  class Down < Base
+    include TfcConcern
+
+    def run
+      plan if @options[:yes] && !tfc?
+      destroy
+    end
+
+  private
+    def plan
+      Commander.new("plan", @options.merge(destroy: true)).run
+    end
+
+    def destroy
+      Commander.new("destroy", @options.merge(command: "down")).run
+      Terraspace::Terraform::Cloud::Workspace.new(@options).destroy if @options[:destroy_workspace]
+    end
+  end
+end

data/lib/terraspace/cli/help/all/down.md

@@ -0,0 +1,32 @@
+## Example
+
+    $ terraspace all down
+    Will run:
+       terraspace down a1 # batch 1
+       terraspace down b1 # batch 2
+       terraspace down b2 # batch 2
+       terraspace down c1 # batch 3
+    Are you sure? (y/N)
+
+Once you confirm, Terraspace destroys the infrastructure.
+
+    Are you sure? (y/N) y
+    Batch Run 1:
+    Running: terraspace down a1 Logs: log/down/a1.log
+    terraspace down a1:  Changes to Outputs:
+    terraspace down a1:  Destroy complete! Resources: 2 destroyed.
+    Batch Run 2:
+    Running: terraspace down b1 Logs: log/down/b1.log
+    Running: terraspace down b2 Logs: log/down/b2.log
+    terraspace down b1:  Changes to Outputs:
+    terraspace down b1:  Destroy complete! Resources: 2 destroyed.
+    terraspace down b2:  Changes to Outputs:
+    terraspace down b2:  Destroy complete! Resources: 1 destroyed.
+    Batch Run 3:
+    Running: terraspace down c1 Logs: log/down/c1.log
+    terraspace down c1:  Changes to Outputs:
+    terraspace down c1:  Destroy complete! Resources: 1 destroyed.
+    Time took: 15s
+    $
+
+Terraspace provides a reduced-noise summary of the runs. The full logs are also written for further inspection and debugging. The [terraspace log](https://terraspace.cloud/reference/terraspace-log/) command is useful for viewing the logs.

data/lib/terraspace/cli/help/all/graph.md

@@ -0,0 +1,21 @@
+## Example
+
+    $ terraspace all graph
+    Building graph...
+    Graph saved to .terraspace-cache/graph/dependencies-20200919192103.png
+    $
+
+The graph will auto-open on macosx and cloud9.
+
+![](https://img.boltops.com/boltops/tools/terraspace/graphs/example-a1.png)
+
+## Text Form
+
+You can also generate a graph in text, tree-like form
+
+    $ terraspace all graph --format text
+    a1
+    ├── b2
+    │   └── c1
+    └── b1
+        └── c1

data/lib/terraspace/cli/help/all/output.md

@@ -0,0 +1,22 @@
+## Example
+
+    $ terraspace all output
+    Running:
+       terraspace output c1 # batch 1
+       terraspace output b1 # batch 2
+       terraspace output b2 # batch 2
+       terraspace output a1 # batch 3
+    Batch Run 1:
+    Running: terraspace output c1 Logs: log/output/c1.log
+    terraspace output c1:  length = 1
+    Batch Run 2:
+    Running: terraspace output b1 Logs: log/output/b1.log
+    Running: terraspace output b2 Logs: log/output/b2.log
+    terraspace output b1:  length = 1
+    terraspace output b1:  length2 = 1
+    terraspace output b2:  length = 1
+    Batch Run 3:
+    Running: terraspace output a1 Logs: log/output/a1.log
+    terraspace output a1:  Warning: No outputs found
+    Time took: 12s
+    $

data/lib/terraspace/cli/help/all/plan.md

@@ -0,0 +1,25 @@
+## Example
+
+    $ terraspace all plan
+    Running:
+       terraspace plan c1 # batch 1
+       terraspace plan b1 # batch 2
+       terraspace plan b2 # batch 2
+       terraspace plan a1 # batch 3
+    Batch Run 1:
+    Running: terraspace plan c1 Logs: log/plan/c1.log
+    terraspace plan c1:  Plan: 1 to add, 0 to change, 0 to destroy.
+    terraspace plan c1:  Changes to Outputs:
+    Batch Run 2:
+    Running: terraspace plan b1 Logs: log/plan/b1.log
+    Running: terraspace plan b2 Logs: log/plan/b2.log
+    terraspace plan b1:  Plan: 2 to add, 0 to change, 0 to destroy.
+    terraspace plan b1:  Changes to Outputs:
+    terraspace plan b2:  Plan: 1 to add, 0 to change, 0 to destroy.
+    terraspace plan b2:  Changes to Outputs:
+    Batch Run 3:
+    Running: terraspace plan a1 Logs: log/plan/a1.log
+    terraspace plan a1:  Plan: 2 to add, 0 to change, 0 to destroy.
+    terraspace plan a1:  Changes to Outputs:
+    Time took: 11s
+    $

data/lib/terraspace/cli/help/all/providers.md

@@ -0,0 +1,21 @@
+## Example
+
+    $ terraspace all providers
+    Running:
+       terraspace providers c1 # batch 1
+       terraspace providers b1 # batch 2
+       terraspace providers b2 # batch 2
+       terraspace providers a1 # batch 3
+    Batch Run 1:
+    Running: terraspace providers c1 Logs: log/providers/c1.log
+    terraspace providers c1:  └── provider[registry.terraform.io/hashicorp/random]
+    Batch Run 2:
+    Running: terraspace providers b1 Logs: log/providers/b1.log
+    Running: terraspace providers b2 Logs: log/providers/b2.log
+    terraspace providers b1:  └── provider[registry.terraform.io/hashicorp/random]
+    terraspace providers b2:  └── provider[registry.terraform.io/hashicorp/random]
+    Batch Run 3:
+    Running: terraspace providers a1 Logs: log/providers/a1.log
+    terraspace providers a1:  └── provider[registry.terraform.io/hashicorp/random]
+    Time took: 9s
+    $

data/lib/terraspace/cli/help/all/refresh.md

@@ -0,0 +1,17 @@
+## Example
+
+    $ terraspace all refresh
+    Running:
+       terraspace refresh c1 # batch 1
+       terraspace refresh b1 # batch 2
+       terraspace refresh b2 # batch 2
+       terraspace refresh a1 # batch 3
+    Batch Run 1:
+    Running: terraspace refresh c1 Logs: log/refresh/c1.log
+    Batch Run 2:
+    Running: terraspace refresh b1 Logs: log/refresh/b1.log
+    Running: terraspace refresh b2 Logs: log/refresh/b2.log
+    Batch Run 3:
+    Running: terraspace refresh a1 Logs: log/refresh/a1.log
+    Time took: 11s
+    $

data/lib/terraspace/cli/help/all/show.md

@@ -0,0 +1,21 @@
+## Example
+
+    $ terraspace all show
+    Running:
+       terraspace show c1 # batch 1
+       terraspace show b1 # batch 2
+       terraspace show b2 # batch 2
+       terraspace show a1 # batch 3
+    Batch Run 1:
+    Running: terraspace show c1 Logs: log/show/c1.log
+    terraspace show c1: Resources: 0 Outputs: 1
+    Batch Run 2:
+    Running: terraspace show b1 Logs: log/show/b1.log
+    Running: terraspace show b2 Logs: log/show/b2.log
+    terraspace show b1: Resources: 0 Outputs: 2
+    terraspace show b2: Resources: 0 Outputs: 1
+    Batch Run 3:
+    Running: terraspace show a1 Logs: log/show/a1.log
+    terraspace show a1: Resources: 0 Outputs: 0
+    Time took: 12s
+    $

data/lib/terraspace/cli/help/all/up.md

@@ -0,0 +1,27 @@
+## Example
+
+    $ terraspace all up
+    Will run:
+       terraspace up c1 # batch 1
+       terraspace up b1 # batch 2
+       terraspace up b2 # batch 2
+       terraspace up a1 # batch 3
+    Are you sure? (y/N)
+
+Once you confirm, Terraspace deploys the batches in parallel. Essentially, Terraspace handles the orchestration.
+
+    Are you sure? (y/N) y
+    Batch Run 1:
+    Running: terraspace up c1 Logs: log/up/c1.log
+    terraspace up c1:  Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
+    Batch Run 2:
+    Running: terraspace up b1 Logs: log/up/b1.log
+    Running: terraspace up b2 Logs: log/up/b2.log
+    terraspace up b1:  Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
+    terraspace up b2:  Apply complete! Resources: 1 added, 0 changed, 0 destroyed.
+    Batch Run 3:
+    Running: terraspace up a1 Logs: log/up/a1.log
+    terraspace up a1:  Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
+    Time took: 25s
+
+Terraspace provides a reduced-noise summary of the runs. The full logs are also written for further inspection and debugging. The [terraspace log](https://terraspace.cloud/reference/terraspace-log/) command is useful for viewing the logs.

data/lib/terraspace/cli/help/all/validate.md

@@ -0,0 +1,21 @@
+## Example
+
+    $ terraspace all validate
+    Running:
+       terraspace validate c1 # batch 1
+       terraspace validate b1 # batch 2
+       terraspace validate b2 # batch 2
+       terraspace validate a1 # batch 3
+    Batch Run 1:
+    Running: terraspace validate c1 Logs: log/validate/c1.log
+    terraspace validate c1:  Success! The configuration is valid.
+    Batch Run 2:
+    Running: terraspace validate b1 Logs: log/validate/b1.log
+    Running: terraspace validate b2 Logs: log/validate/b2.log
+    terraspace validate b1:  Success! The configuration is valid.
+    terraspace validate b2:  Success! The configuration is valid.
+    Batch Run 3:
+    Running: terraspace validate a1 Logs: log/validate/a1.log
+    terraspace validate a1:  Success! The configuration is valid.
+    Time took: 13s
+    $

data/lib/terraspace/cli/help/build.md

@@ -0,0 +1,6 @@
+## Example
+
+    $ terraspace build
+    Building .terraspace-cache/us-west-2/dev/stacks/demo
+    Built in .terraspace-cache/us-west-2/dev/stacks/demo
+    $