terraspace 0.2.4 → 0.3.4

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

@@ -4,11 +4,15 @@
 
 ## More commands
 
-    terraspace bundle install # same as bundle
-    terraspace bundle update  # Updates Terrafile.lock
-    terraspace bundle clean   # removes /tmp terraspace bundler folder
+    terraspace bundle install     # same as bundle
+    terraspace bundle update      # Updates Terrafile.lock
+    terraspace bundle purge_cache # removes /tmp terraspace bundler folder
 
 ## Update a single module
 
-    terraspace bundle update MOD_NAME
-    terraspace bundle update demo
+    terraspace bundle update MODULE
+    terraspace bundle update demo
+
+## Info on a module
+
+    terraspace bundle info MODULE

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

@@ -0,0 +1,9 @@
+## Example
+
+    $ terraspace check_setup
+    Detected Terrspace version: 0.3.3
+    Detected Terraform bin: /home/ec2-user/.tfenv/bin/terraform
+    Detected Terraform v0.13.2
+    Terraspace requires Terraform v0.12.x and above
+    You're all set!
+    $

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

@@ -0,0 +1,5 @@
+## Example
+
+    $ terraspace clean
+    Removed .terraspace-cache
+    $

data/lib/terraspace/cli/help/cloud/destroy.md

@@ -0,0 +1,16 @@
+## Example
+
+    $ terraspace cloud destroy demo
+    You are about to delete the workspace: demo-dev-us-west-2
+    All variables, settings, run history, and state history will be removed.
+    This cannot be undone.
+
+    This will NOT remove any infrastructure managed by this workspace.
+    If needed, destroy the infrastructure prior to deleting the workspace with:
+
+        terraspace down demo
+
+    This will delete the workspace: demo-dev-us-west-2.
+    Are you sure? (y/N) y
+    Destroying workspace demo-dev-us-west-2
+    $

data/lib/terraspace/cli/help/cloud/list.md

@@ -0,0 +1,7 @@
+## Example
+
+    $ terraspace cloud list
+    Workspaces for boltops:
+    demo-dev-us-west-2
+    demo2-dev-us-west-2
+    $

data/lib/terraspace/cli/help/cloud/runs/list.md

@@ -0,0 +1,36 @@
+## Example
+
+Statuses of pending and planned are shown by default.
+
+    $ terraspace cloud runs list demo
+    +----------------------+---------+---------------------------------+---------------------+
+    |          Id          | Status  |             Message             |     Created At      |
+    +----------------------+---------+---------------------------------+---------------------+
+    | run-AuTXsYU1svQEzQVg | pending | Queued manually using Terraform | 2020-09-18T11:30:41 |
+    | run-LuwMibh3ebiG7KQZ | planned | test                            | 2020-09-17T23:16:36 |
+    +----------------------+---------+---------------------------------+---------------------+
+    $
+
+To see all most recent runs, use `--status all`.
+
+    $ terraspace cloud runs list demo --status all
+    +----------------------+-----------+--------------------------------+---------------------+
+    |          Id          |  Status   |            Message             |     Created At      |
+    +----------------------+-----------+--------------------------------+---------------------+
+    | run-LuwMibh3ebiG7KQZ | planned   | test 3                         | 2020-09-17T23:16:36 |
+    | run-z9f67TNMRamZiGMR | canceled  | test 2                         | 2020-09-17T23:15:55 |
+    | run-cN3CKT5po29p35Ta | discarded | test                           | 2020-09-17T22:24:31 |
+    | run-rXMd7dm3fHvVsA36 | discarded | Queued from Terraform Cloud UI | 2020-09-17T20:00:20 |
+    +----------------------+-----------+--------------------------------+---------------------+
+    $
+
+You can provide a list of statuses to the `--status` filter option.
+
+    $ terraspace cloud runs list demo --status canceled discarded
+    +----------------------+-----------+--------------------------------+---------------------+
+    |          Id          |  Status   |            Message             |     Created At      |
+    +----------------------+-----------+--------------------------------+---------------------+
+    | run-gS2m1avc3U4j1fip | canceled  | test                           | 2020-09-17T23:15:43 |
+    | run-ojwQ4r7MxuzyK3d9 | discarded | test                           | 2020-09-17T22:33:00 |
+    | run-dczeLQsMc3ya4XnY | canceled  | test                           | 2020-09-17T22:32:55 |
+    +----------------------+-----------+--------------------------------+---------------------+

data/lib/terraspace/cli/help/cloud/runs/prune.md

@@ -0,0 +1,25 @@
+This leaves the top run alone. The top run usually starts immediately planning once the other runs are pruned. Runs that are also in "Needs Confirmation" will be cancelled.
+
+## Examples
+
+    terraspace cloud runs prune demo --noop
+    terraspace cloud runs prune demo # live run
+
+## Example with Output
+
+    $ terraspace cloud runs prune demo
+    Will keep:
+
+        run-9muMrjrd22vhsP4u pending test 2020-09-18T12:47:11
+
+    Will prune:
+
+        run-fYTDzmKfCQf558UN pending test 2020-09-18T12:46:34
+        run-6bgSTattJGpaRn9X pending test 2020-09-18T12:46:28
+        run-jDHEtZb3vuFnuXqJ planned test 2020-09-18T12:38:35
+
+    Are you sure? (y/N) y
+    Cancelled run-fYTDzmKfCQf558UN test
+    Cancelled run-6bgSTattJGpaRn9X test
+    Discarded run-jDHEtZb3vuFnuXqJ test
+    $

data/lib/terraspace/cli/help/cloud/sync.md

@@ -0,0 +1,43 @@
+## Examples
+
+Sync all stacks:
+
+    $ terraspace cloud sync
+    About to sync these project stacks with Terraform Cloud workspaces:
+
+        Stack => Workspace
+        demo => demo-dev-us-west-2
+        demo2 => demo2-dev-us-west-2
+
+    A sync does the following for each workspace:
+
+      1. Create or update workspace, including the VCS settings.
+      2. Set the working dir.
+      3. Set env and terraform variables.
+
+    Are you sure? (y/N) y
+    Syncing to Terraform Cloud: demo => demo-dev-us-west-2
+    Syncing to Terraform Cloud: demo2 => demo2-dev-us-west-2
+    $
+
+Sync specific stacks:
+
+    $ terraspace cloud sync demo
+    About to sync these project stacks with Terraform Cloud workspaces:
+
+        Stack => Workspace
+        demo => demo-dev-us-west-2
+
+    A sync does the following for each workspace:
+
+      1. Create or update workspace, including the VCS settings.
+      2. Set the working dir.
+      3. Set env and terraform variables.
+
+    Are you sure? (y/N) y
+    Syncing to Terraform Cloud: demo => demo-dev-us-west-2
+    $
+
+Can also specify multiple stacks:
+
+    terraspace cloud sync demo demo2

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

@@ -0,0 +1,8 @@
+## Example
+
+    $ terraspace console demo
+    Building .terraspace-cache/us-west-2/dev/stacks/demo
+    Built in .terraspace-cache/us-west-2/dev/stacks/demo
+    Current directory: .terraspace-cache/us-west-2/dev/stacks/demo
+    => terraform console
+    >

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

@@ -0,0 +1,26 @@
+## Example
+
+    $ terraspace down demo
+    Building .terraspace-cache/us-west-2/dev/stacks/demo
+    Built in .terraspace-cache/us-west-2/dev/stacks/demo
+    Current directory: .terraspace-cache/us-west-2/dev/stacks/demo
+    => terraform destroy
+    # ...
+    Plan: 0 to add, 0 to change, 2 to destroy.
+
+    Changes to Outputs:
+      - bucket_name = "bucket-trusty-marmoset" -> null
+
+    Do you really want to destroy all resources?
+      Terraform will destroy all your managed infrastructure, as shown above.
+      There is no undo. Only 'yes' will be accepted to confirm.
+      Enter a value: yes
+
+    module.bucket.aws_s3_bucket.this: Destroying... [id=bucket-trusty-marmoset]
+    module.bucket.aws_s3_bucket.this: Destruction complete after 0s
+    random_pet.this: Destroying... [id=trusty-marmoset]
+    random_pet.this: Destruction complete after 0s
+
+    Destroy complete! Resources: 2 destroyed.
+    Time took: 21s
+    $

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

@@ -0,0 +1,43 @@
+## Example
+
+    $ terraspace info demo
+    +-----------+---------------------------------------------+
+    |   Name    |                    Value                    |
+    +-----------+---------------------------------------------+
+    | build_dir | stacks/demo                                 |
+    | cache_dir | .terraspace-cache/us-west-2/dev/stacks/demo |
+    | name      | demo                                        |
+    | root      | app/stacks/demo                             |
+    | type      | stack                                       |
+    | type_dir  | stacks                                      |
+    +-----------+---------------------------------------------+
+
+You can also format the output in json:
+
+    $ terraspace info demo --format json
+    [
+      {
+        "Name": "build_dir",
+        "Value": "stacks/demo"
+      },
+      {
+        "Name": "cache_dir",
+        "Value": ".terraspace-cache/us-west-2/dev/stacks/demo"
+      },
+      {
+        "Name": "name",
+        "Value": "demo"
+      },
+      {
+        "Name": "root",
+        "Value": "app/stacks/demo"
+      },
+      {
+        "Name": "type",
+        "Value": "stack"
+      },
+      {
+        "Name": "type_dir",
+        "Value": "stacks"
+      }
+    ]

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

@@ -0,0 +1,37 @@
+Typically, Terrasapce auto init should handle initialization. You can run init if you need to though.
+
+## Example
+
+    $ terraspace init demo
+    Building .terraspace-cache/us-west-2/dev/stacks/demo
+    Built in .terraspace-cache/us-west-2/dev/stacks/demo
+    Current directory: .terraspace-cache/us-west-2/dev/stacks/demo
+    => terraform init -get
+    Initializing modules...
+
+    Initializing the backend...
+
+    Initializing provider plugins...
+    - Using previously-installed hashicorp/aws v3.7.0
+    - Using previously-installed hashicorp/random v2.3.0
+
+    The following providers do not have any version constraints in configuration,
+    so the latest version was installed.
+
+    To prevent automatic upgrades to new major versions that may contain breaking
+    changes, we recommend adding version constraints in a required_providers block
+    in your configuration, with the constraint strings suggested below.
+
+    * hashicorp/aws: version = "~> 3.7.0"
+    * hashicorp/random: version = "~> 2.3.0"
+
+    Terraform has been successfully initialized!
+
+    You may now begin working with Terraform. Try running "terraform plan" to see
+    any changes that are required for your infrastructure. All Terraform commands
+    should now work.
+
+    If you ever set or change modules or backend configuration for Terraform,
+    rerun this command to reinitialize your working directory. If you forget, other
+    commands will detect it and remind you to do so if necessary.
+    $

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

@@ -0,0 +1,20 @@
+## Examples
+
+List both modules and stacks.
+
+    $ terraspace list
+    app/modules/example
+    app/stacks/demo
+    $
+
+List only stacks.
+
+    $ terraspace list -t stack
+    app/stacks/demo
+    $
+
+List only modules.
+
+    $ terraspace list -t module
+    app/modules/example
+    $

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

@@ -0,0 +1,48 @@
+The log commands will filter out the logs for the last ran terraspace command. It does this by filtering for the last found PID in the log files.
+
+## Quick Start
+
+Follow all the logs as you're running `terraspace all up`:
+
+    terraspace log -f
+
+Note, Terraspace automatically checks every second for new logs and adds them to be followed.
+
+## View Logs
+
+View last 10 lines of each log file.
+
+    terraspace log up network # view up log on specific stack
+    terraspace log up         # view all up logs
+    terraspace log down       # view all down logs
+    terraspace log            # view all logs: up, down, etc
+
+By default, the log command shows the last 10 lines of the logs for each log file. You can use the `-n` option to adjust this.
+
+    terraspace log -n 2       # view last 2 lines of all logs: up, down, etc
+
+To show all logs, use the `-a` option.
+
+    terraspace log up -a
+
+Note, if both an action and stack is specified, then it defaults to showing all logs. If you want not to show all logs, use `--no-all`.
+
+## Tail Logs
+
+To tail logs, use the `-f` option.
+
+    terraspace log up network -f # view up log on specific stack
+    terraspace log up -f         # view all up logs
+    terraspace log down -f       # view all down logs
+    terraspace log -f            # view all logs: up, down, etc
+
+## Timestamps
+
+The timestamps are shown by default when you are looking for multiple files.  When you specify both the action and stack for a single log file, then timestamps are not shown.
+
+    terraspace log up         # timestamps will be shown in this case
+    terraspace log up network # timestamps not be shown in this case
+
+To show timestamps:
+
+    terraspace up up network --timestamps

data/lib/terraspace/cli/help/logs/remove.md

@@ -0,0 +1,5 @@
+## Example
+
+    $ terraspace logs remove
+    Removing all files in log/
+    $

data/lib/terraspace/cli/help/logs/truncate.md

@@ -0,0 +1,5 @@
+## Example
+
+    $ terraspace logs truncate
+    Truncating log files in log/
+    $

data/lib/terraspace/cli/help/new/bootstrap_test.md

@@ -0,0 +1,8 @@
+## Example
+
+    $ terraspace new bootstrap_test
+    => Creating test bootstrap structure
+           exist
+          create  .rspec
+          create  spec/spec_helper.rb
+    $

data/lib/terraspace/cli/help/new/example.md

@@ -0,0 +1,8 @@
+## Example
+
+    => Creating test for new module: example
+          create  app/modules/example
+          create  app/modules/example/main.tf
+          create  app/modules/example/outputs.tf
+          create  app/modules/example/variables.tf
+    $

data/lib/terraspace/cli/help/new/git_hook.md

@@ -0,0 +1,6 @@
+## Example
+
+    $ terraspace new git_hook
+          create  .git/hooks/pre-push
+           chmod  .git/hooks/pre-push
+    $

data/lib/terraspace/cli/help/new/module.md

@@ -0,0 +1,9 @@
+## Example
+
+    $ terraspace new module example
+    => Creating test for new module: example
+          create  app/modules/example
+          create  app/modules/example/main.tf
+          create  app/modules/example/outputs.tf
+          create  app/modules/example/variables.tf
+    $

data/lib/terraspace/cli/help/new/module_test.md

@@ -0,0 +1,12 @@
+## Example
+
+    $ terraspace new module_test example
+    => Creating module test: example
+           exist  app/modules/example
+          create  app/modules/example/test/.rspec
+          create  app/modules/example/test/Gemfile
+          create  app/modules/example/test/spec/fixtures/stack/main.tf
+          create  app/modules/example/test/spec/fixtures/stack/outputs.tf
+          create  app/modules/example/test/spec/main_spec.rb
+          create  app/modules/example/test/spec/spec_helper.rb
+    $

data/lib/terraspace/cli/help/new/plugin.md

@@ -0,0 +1,49 @@
+## Example
+
+    $ terraspace new plugin mycloud
+    => Creating new plugin: mycloud
+          create  terraspace_plugin_mycloud
+          create  terraspace_plugin_mycloud/.gitignore
+          create  terraspace_plugin_mycloud/.rspec
+          create  terraspace_plugin_mycloud/CHANGELOG.md
+          create  terraspace_plugin_mycloud/Gemfile
+          create  terraspace_plugin_mycloud/LICENSE.txt
+          create  terraspace_plugin_mycloud/README.md
+          create  terraspace_plugin_mycloud/Rakefile
+          create  terraspace_plugin_mycloud/bin/console
+          create  terraspace_plugin_mycloud/bin/setup
+          create  terraspace_plugin_mycloud/lib/templates/hcl/module/main.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/module/outputs.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/module/variables.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/project/config/terraform/backend.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/project/config/terraform/provider.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/stack/main.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/stack/outputs.tf
+          create  terraspace_plugin_mycloud/lib/templates/hcl/stack/variables.tf
+          create  terraspace_plugin_mycloud/lib/templates/ruby/module/main.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/module/outputs.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/module/variables.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/project/config/terraform/backend.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/project/config/terraform/provider.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/stack/main.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/stack/outputs.rb
+          create  terraspace_plugin_mycloud/lib/templates/ruby/stack/variables.rb
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/.rspec
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/Gemfile
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/spec/fixtures/stack/main.tf
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/spec/fixtures/stack/outputs.tf
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/spec/fixtures/stack/variables.tf
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/spec/main_spec.rb
+          create  terraspace_plugin_mycloud/lib/templates/test/rspec/module/test/spec/spec_helper.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/autoloader.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/clients.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/interfaces/backend.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/interfaces/config.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/interfaces/expander.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/interfaces/layer.rb
+          create  terraspace_plugin_mycloud/lib/terraspace_plugin_mycloud/version.rb
+          create  terraspace_plugin_mycloud/spec/spec_helper.rb
+          create  terraspace_plugin_mycloud/spec/terraspace_provider_mycloud_spec.rb
+          create  terraspace_plugin_mycloud/terraspace_plugin_mycloud.gemspec
+    $