cli

Documentation

Index

• Constants
• Variables
• func CheckTerraformVersion(constraint string, terragruntOptions *options.TerragruntOptions) error
• func CheckTerragruntVersion(constraint string, terragruntOptions *options.TerragruntOptions) error
• func CreateTerragruntCli(version string, writer io.Writer, errwriter io.Writer) *cli.App
• func ParseTerragruntOptions(cliContext *cli.Context) (*options.TerragruntOptions, error)
• func PopulateTerraformVersion(terragruntOptions *options.TerragruntOptions) error
• func RunTerragrunt(terragruntOptions *options.TerragruntOptions) error
• type ArgMissingValue
  • func (err ArgMissingValue) Error() string
• type ArgumentNotAllowed
  • func (err ArgumentNotAllowed) Error() string
• type BackendNotDefined
  • func (err BackendNotDefined) Error() string
• type FileCopyGetter
  • func (g *FileCopyGetter) Get(dst string, u *url.URL) error
  • func (g *FileCopyGetter) GetFile(dst string, u *url.URL) error
• type InvalidTerraformVersion
  • func (err InvalidTerraformVersion) Error() string
• type InvalidTerraformVersionSyntax
  • func (err InvalidTerraformVersionSyntax) Error() string
• type InvalidTerragruntVersion
  • func (err InvalidTerragruntVersion) Error() string
• type MaxRetriesExceeded
  • func (err MaxRetriesExceeded) Error() string
• type MissingOverrides
  • func (err MissingOverrides) Error() string
• type ModuleIsProtected
  • func (err ModuleIsProtected) Error() string
• type NoTerraformFilesFound
  • func (path NoTerraformFilesFound) Error() string
• type RunAllDisabledErr
  • func (err RunAllDisabledErr) Error() string
• type TerraformModule
• type TerraformModulesJson
• type TerragruntInfoGroup
• type UnrecognizedCommand
  • func (commandName UnrecognizedCommand) Error() string

Constants

const (
	CMD_SPIN_UP      = "spin-up"
	CMD_TEAR_DOWN    = "tear-down"
	CMD_PLAN_ALL     = "plan-all"
	CMD_APPLY_ALL    = "apply-all"
	CMD_DESTROY_ALL  = "destroy-all"
	CMD_OUTPUT_ALL   = "output-all"
	CMD_VALIDATE_ALL = "validate-all"
)

The following commands are DEPRECATED

const CMD_AWS_PROVIDER_PATCH = "aws-provider-patch"

const CMD_HCLFMT = "hclfmt"

const CMD_INIT = "init"

const CMD_INIT_FROM_MODULE = "init-from-module"

const CMD_LOCK = "lock"

const CMD_PROVIDERS = "providers"

const CMD_RUN_ALL = "run-all"

START: Constants useful for multimodule command handling

const CMD_TERRAGRUNT_GRAPH_DEPENDENCIES = "graph-dependencies"

const CMD_TERRAGRUNT_INFO = "terragrunt-info"

const CMD_TERRAGRUNT_READ_CONFIG = "terragrunt-read-config"

const CMD_TERRAGRUNT_VALIDATE_INPUTS = "validate-inputs"

const DEFAULT_TERRAFORM_VERSION_CONSTRAINT = ">= v0.12.0"

This uses the constraint syntax from https://github.com/hashicorp/go-version This version of Terragrunt was tested to work with Terraform 0.12.0 and above only

const MODULE_MANIFEST_NAME = ".terragrunt-module-manifest"

manifest for files coped from terragrunt module folder (i.e., the folder that contains the current terragrunt.hcl)

const OPT_DOWNLOAD_DIR = "terragrunt-download-dir"

const OPT_NON_INTERACTIVE = "terragrunt-non-interactive"

const OPT_TERRAGRUNT_CHECK = "terragrunt-check"

const OPT_TERRAGRUNT_CONFIG = "terragrunt-config"

const OPT_TERRAGRUNT_DEBUG = "terragrunt-debug"

const OPT_TERRAGRUNT_EXCLUDE_DIR = "terragrunt-exclude-dir"

const OPT_TERRAGRUNT_HCLFMT_FILE = "terragrunt-hclfmt-file"

const OPT_TERRAGRUNT_IAM_ASSUME_ROLE_DURATION = "terragrunt-iam-assume-role-duration"

const OPT_TERRAGRUNT_IAM_ROLE = "terragrunt-iam-role"

const OPT_TERRAGRUNT_IGNORE_DEPENDENCY_ERRORS = "terragrunt-ignore-dependency-errors"

const OPT_TERRAGRUNT_IGNORE_DEPENDENCY_ORDER = "terragrunt-ignore-dependency-order"

const OPT_TERRAGRUNT_IGNORE_EXTERNAL_DEPENDENCIES = "terragrunt-ignore-external-dependencies"

const OPT_TERRAGRUNT_INCLUDE_DIR = "terragrunt-include-dir"

const OPT_TERRAGRUNT_INCLUDE_EXTERNAL_DEPENDENCIES = "terragrunt-include-external-dependencies"

const OPT_TERRAGRUNT_LOGLEVEL = "terragrunt-log-level"

const OPT_TERRAGRUNT_NO_AUTO_INIT = "terragrunt-no-auto-init"

const OPT_TERRAGRUNT_NO_AUTO_RETRY = "terragrunt-no-auto-retry"

const OPT_TERRAGRUNT_OVERRIDE_ATTR = "terragrunt-override-attr"

const OPT_TERRAGRUNT_PARALLELISM = "terragrunt-parallelism"

const OPT_TERRAGRUNT_SOURCE = "terragrunt-source"

const OPT_TERRAGRUNT_SOURCE_MAP = "terragrunt-source-map"

const OPT_TERRAGRUNT_SOURCE_UPDATE = "terragrunt-source-update"

const OPT_TERRAGRUNT_STRICT_INCLUDE = "terragrunt-strict-include"

const OPT_TERRAGRUNT_TFPATH = "terragrunt-tfpath"

const OPT_WORKING_DIR = "terragrunt-working-dir"

const SOURCE_MANIFEST_NAME = ".terragrunt-source-manifest"

manifest for files copied from the URL specified in the terraform { source = "<URL>" } config

const TERRAFORM_EXTENSION_GLOB = "*.tf"

const TFVarPrefix = "TF_VAR"

Prefix to use for terraform variables set with environment variables.

const TerragruntTFVarsFile = "terragrunt-debug.tfvars.json"

Variables

var ALL_TERRAGRUNT_BOOLEAN_OPTS = []string{
	OPT_NON_INTERACTIVE,
	OPT_TERRAGRUNT_SOURCE_UPDATE,
	OPT_TERRAGRUNT_IGNORE_DEPENDENCY_ERRORS,
	OPT_TERRAGRUNT_IGNORE_DEPENDENCY_ORDER,
	OPT_TERRAGRUNT_IGNORE_EXTERNAL_DEPENDENCIES,
	OPT_TERRAGRUNT_INCLUDE_EXTERNAL_DEPENDENCIES,
	OPT_TERRAGRUNT_NO_AUTO_INIT,
	OPT_TERRAGRUNT_NO_AUTO_RETRY,
	OPT_TERRAGRUNT_CHECK,
	OPT_TERRAGRUNT_STRICT_INCLUDE,
	OPT_TERRAGRUNT_DEBUG,
}

var ALL_TERRAGRUNT_STRING_OPTS = []string{
	OPT_TERRAGRUNT_CONFIG,
	OPT_TERRAGRUNT_TFPATH,
	OPT_WORKING_DIR,
	OPT_DOWNLOAD_DIR,
	OPT_TERRAGRUNT_SOURCE,
	OPT_TERRAGRUNT_SOURCE_MAP,
	OPT_TERRAGRUNT_IAM_ROLE,
	OPT_TERRAGRUNT_IAM_ASSUME_ROLE_DURATION,
	OPT_TERRAGRUNT_EXCLUDE_DIR,
	OPT_TERRAGRUNT_INCLUDE_DIR,
	OPT_TERRAGRUNT_PARALLELISM,
	OPT_TERRAGRUNT_HCLFMT_FILE,
	OPT_TERRAGRUNT_OVERRIDE_ATTR,
	OPT_TERRAGRUNT_LOGLEVEL,
}

var CUSTOM_USAGE_TEXT = `` /* 3956-byte string literal not displayed */

Since Terragrunt is just a thin wrapper for Terraform, and we don't want to repeat every single Terraform command in its definition, we don't quite fit into the model of any Go CLI library. Fortunately, urfave/cli allows us to override the whole template used for the Usage Text.

TODO: this description text has copy/pasted versions of many Terragrunt constants, such as command names and file names. It would be easy to make this code DRY using fmt.Sprintf(), but then it's hard to make the text align nicely. Write some code to take generate this help text automatically, possibly leveraging code that's part of urfave/cli.

var DEPRECATED_ARGUMENTS = map[string]string{}

DEPRECATED_ARGUMENTS is a map of deprecated arguments to the argument that replace them.

var MODULE_REGEX = regexp.MustCompile(`module[[:blank:]]+".+"`)

var MULTI_MODULE_COMMANDS = []string{
	CMD_RUN_ALL,

	CMD_APPLY_ALL,
	CMD_DESTROY_ALL,
	CMD_OUTPUT_ALL,
	CMD_PLAN_ALL,
	CMD_VALIDATE_ALL,
}

var TERRAFORM_COMMANDS_THAT_DO_NOT_NEED_INIT = []string{
	"version",
	"terragrunt-info",
	"graph-dependencies",
}

var TERRAFORM_COMMANDS_THAT_USE_STATE = []string{
	"init",
	"apply",
	"destroy",
	"env",
	"import",
	"graph",
	"output",
	"plan",
	"push",
	"refresh",
	"show",
	"taint",
	"untaint",
	"validate",
	"force-unlock",
	"state",
}

var TERRAFORM_HELP_FLAGS = []string{
	"--help",
	"-help",
	"-h",
}

The supported flags to show help of terraform commands

var TerraformVersionRegex = regexp.MustCompile(`Terraform (v?\d+\.\d+\.\d+).*`)

TerraformVersionRegex verifies that terraform --version output is in one of the following formats: - Terraform v0.9.5-dev (cad024a5fe131a546936674ef85445215bbc4226+CHANGES) - Terraform v0.13.0-beta2 - Terraform v0.12.27 We only make sure the "v#.#.#" part is present in the output.

Functions

func CheckTerraformVersion

func CheckTerraformVersion(constraint string, terragruntOptions *options.TerragruntOptions) error

Check that the currently installed Terraform version works meets the specified version constraint and return an error if it doesn't

func CheckTerragruntVersion

func CheckTerragruntVersion(constraint string, terragruntOptions *options.TerragruntOptions) error

Check that the currently running Terragrunt version meets the specified version constraint and return an error if it doesn't

func CreateTerragruntCli

func CreateTerragruntCli(version string, writer io.Writer, errwriter io.Writer) *cli.App

Create the Terragrunt CLI App

func ParseTerragruntOptions

func ParseTerragruntOptions(cliContext *cli.Context) (*options.TerragruntOptions, error)

Parse command line options that are passed in for Terragrunt

func PopulateTerraformVersion

func PopulateTerraformVersion(terragruntOptions *options.TerragruntOptions) error

Populate the currently installed version of Terraform into the given terragruntOptions

func RunTerragrunt

func RunTerragrunt(terragruntOptions *options.TerragruntOptions) error

Downloads terraform source if necessary, then runs terraform with the given options and CLI args. This will forward all the args and extra_arguments directly to Terraform.

Types

type ArgMissingValue

type ArgMissingValue string

func (ArgMissingValue) Error

func (err ArgMissingValue) Error() string

type ArgumentNotAllowed

type ArgumentNotAllowed struct {
	Argument string
	Message  string
}

func (ArgumentNotAllowed) Error

func (err ArgumentNotAllowed) Error() string

type BackendNotDefined

type BackendNotDefined struct {
	Opts        *options.TerragruntOptions
	BackendType string
}

func (BackendNotDefined) Error

func (err BackendNotDefined) Error() string

type FileCopyGetter

type FileCopyGetter struct {
	getter.FileGetter
}

A custom getter.Getter implementation that uses file copying instead of symlinks. Symlinks are faster and use less disk space, but they cause issues in Windows and with infinite loops, so we copy files/folders instead.

func (*FileCopyGetter) Get

func (g *FileCopyGetter) Get(dst string, u *url.URL) error

The original FileGetter does NOT know how to do folder copying (it only does symlinks), so we provide a copy implementation here

func (*FileCopyGetter) GetFile

func (g *FileCopyGetter) GetFile(dst string, u *url.URL) error

The original FileGetter already knows how to do file copying so long as we set the Copy flag to true, so just delegate to it

type InvalidTerraformVersion

type InvalidTerraformVersion struct {
	CurrentVersion     *version.Version
	VersionConstraints version.Constraints
}

func (InvalidTerraformVersion) Error

func (err InvalidTerraformVersion) Error() string

type InvalidTerraformVersionSyntax

type InvalidTerraformVersionSyntax string

func (InvalidTerraformVersionSyntax) Error

func (err InvalidTerraformVersionSyntax) Error() string

type InvalidTerragruntVersion

type InvalidTerragruntVersion struct {
	CurrentVersion     *version.Version
	VersionConstraints version.Constraints
}

func (InvalidTerragruntVersion) Error

func (err InvalidTerragruntVersion) Error() string

type MaxRetriesExceeded

type MaxRetriesExceeded struct {
	Opts *options.TerragruntOptions
}

func (MaxRetriesExceeded) Error

func (err MaxRetriesExceeded) Error() string

type MissingOverrides

type MissingOverrides string

func (MissingOverrides) Error

func (err MissingOverrides) Error() string

type ModuleIsProtected

type ModuleIsProtected struct {
	Opts *options.TerragruntOptions
}

func (ModuleIsProtected) Error

func (err ModuleIsProtected) Error() string

type NoTerraformFilesFound

type NoTerraformFilesFound string

func (NoTerraformFilesFound) Error

func (path NoTerraformFilesFound) Error() string

type RunAllDisabledErr

type RunAllDisabledErr struct {
	// contains filtered or unexported fields
}

func (RunAllDisabledErr) Error

func (err RunAllDisabledErr) Error() string

type TerraformModule

type TerraformModule struct {
	Key    string
	Source string
	Dir    string
}

type TerraformModulesJson

type TerraformModulesJson struct {
	Modules []TerraformModule
}

The format we expect in the .terraform/modules/modules.json file

type TerragruntInfoGroup

type TerragruntInfoGroup struct {
	ConfigPath       string
	DownloadDir      string
	IamRole          string
	TerraformBinary  string
	TerraformCommand string
	WorkingDir       string
}

Struct is output as JSON by 'terragrunt-info':

type UnrecognizedCommand

type UnrecognizedCommand string

func (UnrecognizedCommand) Error

func (commandName UnrecognizedCommand) Error() string