tfexec

package
v0.14.1-0...-61dac8c Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 26, 2021 License: MPL-2.0 Imports: 18 Imported by: 0

Documentation

Overview

Package tfexec exposes functionality for constructing and running Terraform CLI commands. Structured return values use the data types defined in the github.com/hashicorp/terraform-json package.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func CleanEnv

func CleanEnv(dirty map[string]string) map[string]string

CleanEnv removes any prohibited environment variables from an environment map.

func FormatString

func FormatString(ctx context.Context, execPath string, content string) (string, error)

FormatString formats a passed string, given a path to Terraform.

func ProhibitedEnv

func ProhibitedEnv(env map[string]string) []string

ProhibitedEnv returns a slice of environment variable keys that are not allowed to be set manually from the passed environment.

Types

type AllowMissingConfigOption

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

AllowMissingConfigOption represents the -allow-missing-config flag.

func AllowMissingConfig

func AllowMissingConfig(allowMissingConfig bool) *AllowMissingConfigOption

AllowMissingConfig represents the -allow-missing-config flag.

type ApplyOption

type ApplyOption interface {
	// contains filtered or unexported methods
}

ApplyOption represents options used in the Apply method.

type BackendConfigOption

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

BackendConfigOption represents the -backend-config flag.

func BackendConfig

func BackendConfig(backendConfig string) *BackendConfigOption

BackendConfig represents the -backend-config flag.

type BackendOption

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

BackendOption represents the -backend flag.

func Backend

func Backend(backend bool) *BackendOption

Backend represents the -backend flag.

type BackupOption

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

BackupOption represents the -backup flag.

func Backup

func Backup(path string) *BackupOption

Backup represents the -backup flag.

func DisableBackup

func DisableBackup() *BackupOption

DisableBackup is a convenience method for Backup("-"), indicating backup state should be disabled.

type BackupOutOption

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

func BackupOut

func BackupOut(path string) *BackupOutOption

BackupOutOption represents the -backup-out flag.

type ConfigOption

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

ConfigOption represents the -config flag.

func Config

func Config(path string) *ConfigOption

Config represents the -config flag.

type CopyStateOption

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

CopyStateOption represents the -state flag for terraform workspace new. This flag is used to copy an existing state file in to the new workspace.

func CopyState

func CopyState(path string) *CopyStateOption

CopyState represents the -state flag for terraform workspace new. This flag is used to copy an existing state file in to the new workspace.

type DestroyFlagOption

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

DestroyFlagOption represents the -destroy flag.

func Destroy

func Destroy(destroy bool) *DestroyFlagOption

Destroy represents the -destroy flag.

type DestroyOption

type DestroyOption interface {
	// contains filtered or unexported methods
}

DestroyOption represents options used in the Destroy method.

type DirOption

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

func Dir

func Dir(path string) *DirOption

type DirOrPlanOption

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

func DirOrPlan

func DirOrPlan(path string) *DirOrPlanOption

type DryRunOption

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

func DryRun

func DryRun(dryRun bool) *DryRunOption

DryRun represents the -dry-run flag.

type ErrCLIUsage

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

ErrCLIUsage is returned when the combination of flags or arguments is incorrect.

CLI indicates usage errors in three different ways: either

1. Exit 1, with a custom error message on stderr. 2. Exit 1, with command usage logged to stderr. 3. Exit 127, with command usage logged to stdout. Currently cases 1 and 2 are handled. TODO KEM: Handle exit 127 case. How does this work on non-Unix platforms?

func (*ErrCLIUsage) Error

func (e *ErrCLIUsage) Error() string

func (*ErrCLIUsage) Is

func (u *ErrCLIUsage) Is(target error) bool

func (*ErrCLIUsage) Unwrap

func (u *ErrCLIUsage) Unwrap() error

type ErrConfigInvalid

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

func (*ErrConfigInvalid) Error

func (e *ErrConfigInvalid) Error() string

type ErrManualEnvVar

type ErrManualEnvVar struct {
	Name string
}

ErrManualEnvVar is returned when an env var that should be set programatically via an option or method is set via the manual environment passing functions.

func (*ErrManualEnvVar) Error

func (err *ErrManualEnvVar) Error() string

type ErrMissingVar

type ErrMissingVar struct {
	VariableName string
	// contains filtered or unexported fields
}

func (*ErrMissingVar) Error

func (err *ErrMissingVar) Error() string

func (*ErrMissingVar) Is

func (u *ErrMissingVar) Is(target error) bool

func (*ErrMissingVar) Unwrap

func (u *ErrMissingVar) Unwrap() error

type ErrNoConfig

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

func (*ErrNoConfig) Error

func (e *ErrNoConfig) Error() string

func (*ErrNoConfig) Is

func (u *ErrNoConfig) Is(target error) bool

func (*ErrNoConfig) Unwrap

func (u *ErrNoConfig) Unwrap() error

type ErrNoInit

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

func (*ErrNoInit) Error

func (e *ErrNoInit) Error() string

func (*ErrNoInit) Is

func (u *ErrNoInit) Is(target error) bool

func (*ErrNoInit) Unwrap

func (u *ErrNoInit) Unwrap() error

type ErrNoSuitableBinary

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

func (*ErrNoSuitableBinary) Error

func (e *ErrNoSuitableBinary) Error() string

func (*ErrNoSuitableBinary) Unwrap

func (e *ErrNoSuitableBinary) Unwrap() error

type ErrNoWorkspace

type ErrNoWorkspace struct {
	Name string
	// contains filtered or unexported fields
}

func (*ErrNoWorkspace) Error

func (err *ErrNoWorkspace) Error() string

func (*ErrNoWorkspace) Is

func (u *ErrNoWorkspace) Is(target error) bool

func (*ErrNoWorkspace) Unwrap

func (u *ErrNoWorkspace) Unwrap() error

type ErrTFVersionMismatch

type ErrTFVersionMismatch struct {
	TFVersion string

	// Constraint is not returned in the error messaging on 0.12
	Constraint string
	// contains filtered or unexported fields
}

ErrTFVersionMismatch is returned when the running Terraform version is not compatible with the value specified for required_version in the terraform block.

func (*ErrTFVersionMismatch) Error

func (e *ErrTFVersionMismatch) Error() string

func (*ErrTFVersionMismatch) Is

func (u *ErrTFVersionMismatch) Is(target error) bool

func (*ErrTFVersionMismatch) Unwrap

func (u *ErrTFVersionMismatch) Unwrap() error

type ErrVersionMismatch

type ErrVersionMismatch struct {
	MinInclusive string
	MaxExclusive string
	Actual       string
}

ErrVersionMismatch is returned when the detected Terraform version is not compatible with the command or flags being used in this invocation.

func (*ErrVersionMismatch) Error

func (e *ErrVersionMismatch) Error() string

type ErrWorkspaceExists

type ErrWorkspaceExists struct {
	Name string
	// contains filtered or unexported fields
}

ErrWorkspaceExists is returned when creating a workspace that already exists

func (*ErrWorkspaceExists) Error

func (err *ErrWorkspaceExists) Error() string

func (*ErrWorkspaceExists) Is

func (u *ErrWorkspaceExists) Is(target error) bool

func (*ErrWorkspaceExists) Unwrap

func (u *ErrWorkspaceExists) Unwrap() error

type ForceCopyOption

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

func ForceCopy

func ForceCopy(forceCopy bool) *ForceCopyOption

type ForceOption

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

func Force

func Force(force bool) *ForceOption

type FormatOption

type FormatOption interface {
	// contains filtered or unexported methods
}

type FromModuleOption

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

func FromModule

func FromModule(source string) *FromModuleOption

type GetCmdOption

type GetCmdOption interface {
	// contains filtered or unexported methods
}

GetCmdOption represents options used in the Get method.

type GetOption

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

func Get

func Get(get bool) *GetOption

type GetPluginsOption

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

func GetPlugins

func GetPlugins(getPlugins bool) *GetPluginsOption

type ImportOption

type ImportOption interface {
	// contains filtered or unexported methods
}

ImportOption represents options used in the Import method.

type InitOption

type InitOption interface {
	// contains filtered or unexported methods
}

InitOption represents options used in the Init method.

type LockOption

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

LockOption represents the -lock flag.

func Lock

func Lock(lock bool) *LockOption

Lock represents the -lock flag.

type LockTimeoutOption

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

LockTimeoutOption represents the -lock-timeout flag.

func LockTimeout

func LockTimeout(lockTimeout string) *LockTimeoutOption

LockTimeout represents the -lock-timeout flag.

type OutOption

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

func Out

func Out(path string) *OutOption

type OutputMeta

type OutputMeta struct {
	Sensitive bool            `json:"sensitive"`
	Type      json.RawMessage `json:"type"`
	Value     json.RawMessage `json:"value"`
}

OutputMeta represents the JSON output of 'terraform output -json', which resembles state format version 3 due to a historical accident. Please see hashicorp/terraform/command/output.go. TODO KEM: Should this type be in terraform-json?

type OutputOption

type OutputOption interface {
	// contains filtered or unexported methods
}

OutputOption represents options used in the Output method.

type ParallelismOption

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

func Parallelism

func Parallelism(n int) *ParallelismOption

type PlanOption

type PlanOption interface {
	// contains filtered or unexported methods
}

PlanOption represents options used in the Plan method.

type PluginDirOption

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

func PluginDir

func PluginDir(pluginDir string) *PluginDirOption

type ReattachConfig

type ReattachConfig struct {
	Protocol        string
	ProtocolVersion int
	Pid             int
	Test            bool
	Addr            ReattachConfigAddr
}

ReattachConfig holds the information Terraform needs to be able to attach itself to a provider process, so it can drive the process.

type ReattachConfigAddr

type ReattachConfigAddr struct {
	Network string
	String  string
}

ReattachConfigAddr is a JSON-encoding friendly version of net.Addr.

type ReattachInfo

type ReattachInfo map[string]ReattachConfig

type ReattachOption

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

func Reattach

func Reattach(info ReattachInfo) *ReattachOption

type ReconfigureOption

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

func Reconfigure

func Reconfigure(reconfigure bool) *ReconfigureOption

type RecursiveOption

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

func Recursive

func Recursive(r bool) *RecursiveOption

type RefreshCmdOption

type RefreshCmdOption interface {
	// contains filtered or unexported methods
}

RefreshCmdOption represents options used in the Refresh method.

type RefreshOption

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

func Refresh

func Refresh(refresh bool) *RefreshOption

type ShowOption

type ShowOption interface {
	// contains filtered or unexported methods
}

type StateMvCmdOption

type StateMvCmdOption interface {
	// contains filtered or unexported methods
}

StateMvCmdOption represents options used in the Refresh method.

type StateOption

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

func State deprecated

func State(path string) *StateOption

State represents the -state flag.

Deprecated: The -state CLI flag is a legacy flag and should not be used. If you need a different state file for every run, you can instead use the local backend. See https://github.com/hashicorp/terraform/issues/25920#issuecomment-676560799

type StateOutOption

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

func StateOut

func StateOut(path string) *StateOutOption

type StateRmCmdOption

type StateRmCmdOption interface {
	// contains filtered or unexported methods
}

StateRmCmdOption represents options used in the Refresh method.

type TargetOption

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

func Target

func Target(resource string) *TargetOption

type Terraform

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

Terraform represents the Terraform CLI executable and working directory.

Typically this is constructed against the root module of a Terraform configuration but you can override paths used in some commands depending on the available options.

All functions that execute CLI commands take a context.Context. It should be noted that exec.Cmd.Run will not return context.DeadlineExceeded or context.Canceled by default, we have augmented our wrapped errors to respond true to errors.Is for context.DeadlineExceeded and context.Canceled if those are present on the context when the error is parsed. See https://github.com/golang/go/issues/21880 for more about the Go limitations.

By default, the instance inherits the environment from the calling code (using os.Environ) but it ignores certain environment variables that are managed within the code and prohibits setting them through SetEnv:

  • TF_APPEND_USER_AGENT
  • TF_IN_AUTOMATION
  • TF_INPUT
  • TF_LOG
  • TF_LOG_PATH
  • TF_REATTACH_PROVIDERS
  • TF_DISABLE_PLUGIN_TLS
  • TF_SKIP_PROVIDER_VERIFY

func NewTerraform

func NewTerraform(workingDir string, execPath string) (*Terraform, error)

NewTerraform returns a Terraform struct with default values for all fields. If a blank execPath is supplied, NewTerraform will attempt to locate an appropriate binary on the system PATH.

func (*Terraform) Apply

func (tf *Terraform) Apply(ctx context.Context, opts ...ApplyOption) error

Apply represents the terraform apply subcommand.

func (*Terraform) Destroy

func (tf *Terraform) Destroy(ctx context.Context, opts ...DestroyOption) error

Destroy represents the terraform destroy subcommand.

func (*Terraform) ExecPath

func (tf *Terraform) ExecPath() string

ExecPath returns the path to the Terraform executable.

func (*Terraform) Format

func (tf *Terraform) Format(ctx context.Context, unformatted io.Reader, formatted io.Writer) error

Format performs formatting on the unformatted io.Reader (as stdin to the CLI) and returns the formatted result on the formatted io.Writer.

func (*Terraform) FormatCheck

func (tf *Terraform) FormatCheck(ctx context.Context, opts ...FormatOption) (bool, []string, error)

FormatCheck returns true if the config files in the working or selected (via DirOption) directory are already formatted.

func (*Terraform) FormatString

func (tf *Terraform) FormatString(ctx context.Context, content string) (string, error)

FormatString formats a passed string.

func (*Terraform) FormatWrite

func (tf *Terraform) FormatWrite(ctx context.Context, opts ...FormatOption) error

FormatWrite attempts to format and modify all config files in the working or selected (via DirOption) directory.

func (*Terraform) Get

func (tf *Terraform) Get(ctx context.Context, opts ...GetCmdOption) error

Get represents the terraform get subcommand.

func (*Terraform) Import

func (tf *Terraform) Import(ctx context.Context, address, id string, opts ...ImportOption) error

Import represents the terraform import subcommand.

func (*Terraform) Init

func (tf *Terraform) Init(ctx context.Context, opts ...InitOption) error

Init represents the terraform init subcommand.

func (*Terraform) Output

func (tf *Terraform) Output(ctx context.Context, opts ...OutputOption) (map[string]OutputMeta, error)

Output represents the terraform output subcommand.

func (*Terraform) Plan

func (tf *Terraform) Plan(ctx context.Context, opts ...PlanOption) (bool, error)

Plan executes `terraform plan` with the specified options and waits for it to complete.

The returned boolean is false when the plan diff is empty (no changes) and true when the plan diff is non-empty (changes present).

The returned error is nil if `terraform plan` has been executed and exits with either 0 or 2.

func (*Terraform) ProvidersSchema

func (tf *Terraform) ProvidersSchema(ctx context.Context) (*tfjson.ProviderSchemas, error)

ProvidersSchema represents the terraform providers schema -json subcommand.

func (*Terraform) Refresh

func (tf *Terraform) Refresh(ctx context.Context, opts ...RefreshCmdOption) error

Refresh represents the terraform refresh subcommand.

func (*Terraform) SetAppendUserAgent

func (tf *Terraform) SetAppendUserAgent(ua string) error

SetAppendUserAgent sets the TF_APPEND_USER_AGENT environment variable for Terraform CLI execution.

func (*Terraform) SetDisablePluginTLS

func (tf *Terraform) SetDisablePluginTLS(disabled bool) error

SetDisablePluginTLS sets the TF_DISABLE_PLUGIN_TLS environment variable for Terraform CLI execution.

func (*Terraform) SetEnv

func (tf *Terraform) SetEnv(env map[string]string) error

SetEnv allows you to override environment variables, this should not be used for any well known Terraform environment variables that are already covered in options. Pass nil to copy the values from os.Environ. Attempting to set environment variables that should be managed manually will result in ErrManualEnvVar being returned.

func (*Terraform) SetLogPath

func (tf *Terraform) SetLogPath(path string) error

SetLogPath sets the TF_LOG_PATH environment variable for Terraform CLI execution.

func (*Terraform) SetLogger

func (tf *Terraform) SetLogger(logger printfer)

SetLogger specifies a logger for tfexec to use.

func (*Terraform) SetSkipProviderVerify

func (tf *Terraform) SetSkipProviderVerify(skip bool) error

SetSkipProviderVerify sets the TF_SKIP_PROVIDER_VERIFY environment variable for Terraform CLI execution. This is no longer used in 0.13.0 and greater.

func (*Terraform) SetStderr

func (tf *Terraform) SetStderr(w io.Writer)

SetStderr specifies a writer to stream stderr to for every command.

This should be used for information or logging purposes only, not control flow. Any parsing necessary should be added as functionality to this package.

func (*Terraform) SetStdout

func (tf *Terraform) SetStdout(w io.Writer)

SetStdout specifies a writer to stream stdout to for every command.

This should be used for information or logging purposes only, not control flow. Any parsing necessary should be added as functionality to this package.

func (*Terraform) Show

func (tf *Terraform) Show(ctx context.Context, opts ...ShowOption) (*tfjson.State, error)

Show reads the default state path and outputs the state. To read a state or plan file, ShowState or ShowPlan must be used instead.

func (*Terraform) ShowPlanFile

func (tf *Terraform) ShowPlanFile(ctx context.Context, planPath string, opts ...ShowOption) (*tfjson.Plan, error)

ShowPlanFile reads a given plan file and outputs the plan.

func (*Terraform) ShowPlanFileRaw

func (tf *Terraform) ShowPlanFileRaw(ctx context.Context, planPath string, opts ...ShowOption) (string, error)

ShowPlanFileRaw reads a given plan file and outputs the plan in a human-friendly, opaque format.

func (*Terraform) ShowStateFile

func (tf *Terraform) ShowStateFile(ctx context.Context, statePath string, opts ...ShowOption) (*tfjson.State, error)

ShowStateFile reads a given state file and outputs the state.

func (*Terraform) StateMv

func (tf *Terraform) StateMv(ctx context.Context, source string, destination string, opts ...StateMvCmdOption) error

StateMv represents the terraform state mv subcommand.

func (*Terraform) StateRm

func (tf *Terraform) StateRm(ctx context.Context, address string, opts ...StateRmCmdOption) error

StateRm represents the terraform state rm subcommand.

func (*Terraform) Upgrade012

func (tf *Terraform) Upgrade012(ctx context.Context, opts ...Upgrade012Option) error

Upgrade012 represents the terraform 0.12upgrade subcommand.

func (*Terraform) Upgrade013

func (tf *Terraform) Upgrade013(ctx context.Context, opts ...Upgrade013Option) error

Upgrade013 represents the terraform 0.13upgrade subcommand.

func (*Terraform) Validate

func (tf *Terraform) Validate(ctx context.Context) (*tfjson.ValidateOutput, error)

Validate represents the validate subcommand to the Terraform CLI. The -json flag support was added in 0.12.0, so this will not work on earlier versions.

func (*Terraform) Version

func (tf *Terraform) Version(ctx context.Context, skipCache bool) (tfVersion *version.Version, providerVersions map[string]*version.Version, err error)

Version returns structured output from the terraform version command including both the Terraform CLI version and any initialized provider versions. This will read cached values when present unless the skipCache parameter is set to true.

func (*Terraform) WorkingDir

func (tf *Terraform) WorkingDir() string

WorkingDir returns the working directory for Terraform.

func (*Terraform) WorkspaceList

func (tf *Terraform) WorkspaceList(ctx context.Context) ([]string, string, error)

WorkspaceList represents the workspace list subcommand to the Terraform CLI.

func (*Terraform) WorkspaceNew

func (tf *Terraform) WorkspaceNew(ctx context.Context, workspace string, opts ...WorkspaceNewCmdOption) error

WorkspaceNew represents the workspace new subcommand to the Terraform CLI.

func (*Terraform) WorkspaceSelect

func (tf *Terraform) WorkspaceSelect(ctx context.Context, workspace string) error

WorkspaceSelect represents the workspace select subcommand to the Terraform CLI.

type UpdateOption

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

func Update

func Update(update bool) *UpdateOption

type Upgrade012Option

type Upgrade012Option interface {
	// contains filtered or unexported methods
}

Upgrade012Option represents options used in the Destroy method.

type Upgrade013Option

type Upgrade013Option interface {
	// contains filtered or unexported methods
}

Upgrade013Option represents options used in the Destroy method.

type UpgradeOption

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

func Upgrade

func Upgrade(upgrade bool) *UpgradeOption

type VarFileOption

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

func VarFile

func VarFile(path string) *VarFileOption

type VarOption

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

func Var

func Var(assignment string) *VarOption

type VerifyPluginsOption

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

func VerifyPlugins

func VerifyPlugins(verifyPlugins bool) *VerifyPluginsOption

type WorkspaceNewCmdOption

type WorkspaceNewCmdOption interface {
	// contains filtered or unexported methods
}

WorkspaceNewCmdOption represents options that are applicable to the WorkspaceNew method.

Directories

Path Synopsis
internal
e2etest
Package e2etest contains end-to-end acceptance tests for the tfexec package.
Package e2etest contains end-to-end acceptance tests for the tfexec package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL