local

Documentation

Index

• Constants
• func RenderPlan(plan *plans.Plan, baseState *states.State, schemas *terraform.Schemas, ...)
• func TestLocalProvider(t *testing.T, b *Local, name string, schema *terraform.ProviderSchema) *terraform.MockProvider
• func TestNewLocalNoDefault() backend.Backend
• func TestNewLocalSingle() backend.Backend
• type CountHook
  • func (h *CountHook) PostApply(addr addrs.AbsResourceInstance, gen states.Generation, newState cty.Value, ...) (terraform.HookAction, error)
  • func (h *CountHook) PostDiff(addr addrs.AbsResourceInstance, gen states.Generation, action plans.Action, ...) (terraform.HookAction, error)
  • func (h *CountHook) PreApply(addr addrs.AbsResourceInstance, gen states.Generation, action plans.Action, ...) (terraform.HookAction, error)
  • func (h *CountHook) Reset()
• type Local
  • func New() *Local
  • func NewWithBackend(backend backend.Backend) *Local
  • func TestLocal(t *testing.T) (*Local, func())
  • func (b *Local) CLIInit(opts *backend.CLIOpts) error
  • func (b *Local) Colorize() *colorstring.Colorize
  • func (b *Local) ConfigSchema() *configschema.Block
  • func (b *Local) Configure(obj cty.Value) tfdiags.Diagnostics
  • func (b *Local) Context(op *backend.Operation) (*terraform.Context, statemgr.Full, tfdiags.Diagnostics)
  • func (b *Local) DeleteWorkspace(name string) error
  • func (b *Local) Operation(ctx context.Context, op *backend.Operation) (*backend.RunningOperation, error)
  • func (b *Local) PathsConflictWith(other *Local) bool
  • func (b *Local) PrepareConfig(obj cty.Value) (cty.Value, tfdiags.Diagnostics)
  • func (b *Local) ReportResult(op *backend.RunningOperation, diags tfdiags.Diagnostics)
  • func (b *Local) StateMgr(name string) (statemgr.Full, error)
  • func (b *Local) StatePaths(name string) (stateIn, stateOut, backupOut string)
  • func (b *Local) Workspaces() ([]string, error)
• type StateHook
  • func (h *StateHook) PostStateUpdate(new *states.State) (terraform.HookAction, error)
• type TestLocalNoDefaultState
  • func (b *TestLocalNoDefaultState) DeleteWorkspace(name string) error
  • func (b *TestLocalNoDefaultState) StateMgr(name string) (statemgr.Full, error)
  • func (b *TestLocalNoDefaultState) Workspaces() ([]string, error)
• type TestLocalSingleState
  • func (b *TestLocalSingleState) DeleteWorkspace(string) error
  • func (b *TestLocalSingleState) StateMgr(name string) (statemgr.Full, error)
  • func (b *TestLocalSingleState) Workspaces() ([]string, error)

Constants

const (
	DefaultWorkspaceDir    = "terraform.tfstate.d"
	DefaultWorkspaceFile   = "environment"
	DefaultStateFilename   = "terraform.tfstate"
	DefaultBackupExtension = ".backup"
)

Functions

func RenderPlan

func RenderPlan(plan *plans.Plan, baseState *states.State, schemas *terraform.Schemas, ui cli.Ui, colorize *colorstring.Colorize)

RenderPlan renders the given plan to the given UI.

This is exported only so that the "terraform show" command can re-use it. Ideally it would be somewhere outside of this backend code so that both can call into it, but we're leaving it here for now in order to avoid disruptive refactoring.

If you find yourself wanting to call this function from a third callsite, please consider whether it's time to do the more disruptive refactoring so that something other than the local backend package is offering this functionality.

The difference between baseState and priorState is that baseState is the result of implicitly running refresh (unless that was disabled) while priorState is a snapshot of the state as it was before we took any actions at all. priorState can optionally be nil if the caller has only a saved plan and not the prior state it was built from. In that case, changes to output values will not currently be rendered because their prior values are currently stored only in the prior state. (see the docstring for func planHasSideEffects for why this is and when that might change)

func TestLocalProvider

func TestLocalProvider(t *testing.T, b *Local, name string, schema *terraform.ProviderSchema) *terraform.MockProvider

TestLocalProvider modifies the ContextOpts of the *Local parameter to have a provider with the given name.

func TestNewLocalNoDefault

func TestNewLocalNoDefault() backend.Backend

TestNewLocalNoDefault is a factory for creating a TestLocalNoDefaultState. This function matches the signature required for backend/init.

func TestNewLocalSingle

func TestNewLocalSingle() backend.Backend

TestNewLocalSingle is a factory for creating a TestLocalSingleState. This function matches the signature required for backend/init.

Types

type CountHook

type CountHook struct {
	Added   int
	Changed int
	Removed int

	ToAdd          int
	ToChange       int
	ToRemove       int
	ToRemoveAndAdd int

	sync.Mutex
	terraform.NilHook
	// contains filtered or unexported fields
}

CountHook is a hook that counts the number of resources added, removed, changed during the course of an apply.

func (*CountHook) PostApply

func (h *CountHook) PostApply(addr addrs.AbsResourceInstance, gen states.Generation, newState cty.Value, err error) (terraform.HookAction, error)

func (*CountHook) PostDiff

func (h *CountHook) PostDiff(addr addrs.AbsResourceInstance, gen states.Generation, action plans.Action, priorState, plannedNewState cty.Value) (terraform.HookAction, error)

func (*CountHook) PreApply

func (h *CountHook) PreApply(addr addrs.AbsResourceInstance, gen states.Generation, action plans.Action, priorState, plannedNewState cty.Value) (terraform.HookAction, error)

func (*CountHook) Reset

func (h *CountHook) Reset()

type Local

type Local struct {
	// CLI and Colorize control the CLI output. If CLI is nil then no CLI
	// output will be done. If CLIColor is nil then no coloring will be done.
	CLI      cli.Ui
	CLIColor *colorstring.Colorize

	// ShowDiagnostics prints diagnostic messages to the UI.
	ShowDiagnostics func(vals ...interface{})

	// The State* paths are set from the backend config, and may be left blank
	// to use the defaults. If the actual paths for the local backend state are
	// needed, use the StatePaths method.
	//
	// StatePath is the local path where state is read from.
	//
	// StateOutPath is the local path where the state will be written.
	// If this is empty, it will default to StatePath.
	//
	// StateBackupPath is the local path where a backup file will be written.
	// Set this to "-" to disable state backup.
	//
	// StateWorkspaceDir is the path to the folder containing data for
	// non-default workspaces. This defaults to DefaultWorkspaceDir if not set.
	StatePath         string
	StateOutPath      string
	StateBackupPath   string
	StateWorkspaceDir string

	// The OverrideState* paths are set based on per-operation CLI arguments
	// and will override what'd be built from the State* fields if non-empty.
	// While the interpretation of the State* fields depends on the active
	// workspace, the OverrideState* fields are always used literally.
	OverrideStatePath       string
	OverrideStateOutPath    string
	OverrideStateBackupPath string

	// Terraform context. Many of these will be overridden or merged by
	// Operation. See Operation for more details.
	ContextOpts *terraform.ContextOpts

	// OpInput will ask for necessary input prior to performing any operations.
	//
	// OpValidation will perform validation prior to running an operation. The
	// variable naming doesn't match the style of others since we have a func
	// Validate.
	OpInput      bool
	OpValidation bool

	// Backend, if non-nil, will use this backend for non-enhanced behavior.
	// This allows local behavior with remote state storage. It is a way to
	// "upgrade" a non-enhanced backend to an enhanced backend with typical
	// behavior.
	//
	// If this is nil, local performs normal state loading and storage.
	Backend backend.Backend

	// RunningInAutomation indicates that commands are being run by an
	// automated system rather than directly at a command prompt.
	//
	// This is a hint not to produce messages that expect that a user can
	// run a follow-up command, perhaps because Terraform is running in
	// some sort of workflow automation tool that abstracts away the
	// exact commands that are being run.
	RunningInAutomation bool
	// contains filtered or unexported fields
}

Local is an implementation of EnhancedBackend that performs all operations locally. This is the "default" backend and implements normal Terraform behavior as it is well known.

func New

func New() *Local

New returns a new initialized local backend.

func NewWithBackend

func NewWithBackend(backend backend.Backend) *Local

NewWithBackend returns a new local backend initialized with a dedicated backend for non-enhanced behavior.

func TestLocal

func TestLocal(t *testing.T) (*Local, func())

TestLocal returns a configured Local struct with temporary paths and in-memory ContextOpts.

No operations will be called on the returned value, so you can still set public fields without any locks.

func (*Local) CLIInit

func (b *Local) CLIInit(opts *backend.CLIOpts) error

backend.CLI impl.

func (*Local) Colorize

func (b *Local) Colorize() *colorstring.Colorize

Colorize returns the Colorize structure that can be used for colorizing output. This is guaranteed to always return a non-nil value and so is useful as a helper to wrap any potentially colored strings.

func (*Local) ConfigSchema

func (b *Local) ConfigSchema() *configschema.Block

func (*Local) Configure

func (b *Local) Configure(obj cty.Value) tfdiags.Diagnostics

func (*Local) Context

func (b *Local) Context(op *backend.Operation) (*terraform.Context, statemgr.Full, tfdiags.Diagnostics)

backend.Local implementation.

func (*Local) DeleteWorkspace

func (b *Local) DeleteWorkspace(name string) error

DeleteWorkspace removes a workspace.

The "default" workspace cannot be removed.

func (*Local) Operation

func (b *Local) Operation(ctx context.Context, op *backend.Operation) (*backend.RunningOperation, error)

Operation implements backend.Enhanced

This will initialize an in-memory terraform.Context to perform the operation within this process.

The given operation parameter will be merged with the ContextOpts on the structure with the following rules. If a rule isn't specified and the name conflicts, assume that the field is overwritten if set.

func (*Local) PathsConflictWith

func (b *Local) PathsConflictWith(other *Local) bool

PathsConflictWith returns true if any state path used by a workspace in the receiver is the same as any state path used by the other given local backend instance.

This should be used when "migrating" from one local backend configuration to another in order to avoid deleting the "old" state snapshots if they are in the same files as the "new" state snapshots.

func (*Local) PrepareConfig

func (b *Local) PrepareConfig(obj cty.Value) (cty.Value, tfdiags.Diagnostics)

func (*Local) ReportResult

func (b *Local) ReportResult(op *backend.RunningOperation, diags tfdiags.Diagnostics)

ReportResult is a helper for the common chore of setting the status of a running operation and showing any diagnostics produced during that operation.

If the given diagnostics contains errors then the operation's result will be set to backend.OperationFailure. It will be set to backend.OperationSuccess otherwise. It will then use b.ShowDiagnostics to show the given diagnostics before returning.

Callers should feel free to do each of these operations separately in more complex cases where e.g. diagnostics are interleaved with other output, but terminating immediately after reporting error diagnostics is common and can be expressed concisely via this method.

func (*Local) StateMgr

func (b *Local) StateMgr(name string) (statemgr.Full, error)

func (*Local) StatePaths

func (b *Local) StatePaths(name string) (stateIn, stateOut, backupOut string)

StatePaths returns the StatePath, StateOutPath, and StateBackupPath as configured from the CLI.

func (*Local) Workspaces

func (b *Local) Workspaces() ([]string, error)

type StateHook

type StateHook struct {
	terraform.NilHook
	sync.Mutex

	StateMgr statemgr.Writer
}

StateHook is a hook that continuously updates the state by calling WriteState on a statemgr.Full.

func (*StateHook) PostStateUpdate

func (h *StateHook) PostStateUpdate(new *states.State) (terraform.HookAction, error)

type TestLocalNoDefaultState

type TestLocalNoDefaultState struct {
	*Local
}

TestLocalNoDefaultState is a backend implementation that wraps Local and modifies it to support named states, but not the default state. It returns ErrDefaultWorkspaceNotSupported when the DefaultStateName is used.

func (*TestLocalNoDefaultState) DeleteWorkspace

func (b *TestLocalNoDefaultState) DeleteWorkspace(name string) error

func (*TestLocalNoDefaultState) StateMgr

func (b *TestLocalNoDefaultState) StateMgr(name string) (statemgr.Full, error)

func (*TestLocalNoDefaultState) Workspaces

func (b *TestLocalNoDefaultState) Workspaces() ([]string, error)

type TestLocalSingleState

type TestLocalSingleState struct {
	*Local
}

TestLocalSingleState is a backend implementation that wraps Local and modifies it to only support single states (returns ErrWorkspacesNotSupported for multi-state operations).

This isn't an actual use case, this is exported just to provide a easy way to test that behavior.

func (*TestLocalSingleState) DeleteWorkspace

func (b *TestLocalSingleState) DeleteWorkspace(string) error

func (*TestLocalSingleState) StateMgr

func (b *TestLocalSingleState) StateMgr(name string) (statemgr.Full, error)

func (*TestLocalSingleState) Workspaces

func (b *TestLocalSingleState) Workspaces() ([]string, error)