terraform

Documentation

Overview

Copyright 2017 HootSuite Media Inc.

Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Modified hereafter by contributors to runatlantis/atlantis.

Package terraform handles the actual running of terraform commands.

Index

• func MustConstraint(v string) version.Constraints
• type Client
• type DefaultClient
  • func NewClient(log *logging.SimpleLogger, dataDir string, tfeToken string, ...) (*DefaultClient, error)
  • func (c *DefaultClient) RunCommandAsync(log *logging.SimpleLogger, path string, args []string, v *version.Version, ...) (chan<- string, <-chan Line)
  • func (c *DefaultClient) RunCommandWithVersion(log *logging.SimpleLogger, path string, args []string, v *version.Version, ...) (string, error)
  • func (c *DefaultClient) Version() *version.Version
• type DefaultDownloader
  • func (d *DefaultDownloader) GetFile(dst, src string, opts ...getter.ClientOption) error
• type Downloader
• type Line

Functions

func MustConstraint

func MustConstraint(v string) version.Constraints

MustConstraint will parse one or more constraints from the given constraint string. The string must be a comma-separated list of constraints. It panics if there is an error.

Types

type Client

type Client interface {
	Version() *version.Version
	RunCommandWithVersion(log *logging.SimpleLogger, path string, args []string, v *version.Version, workspace string) (string, error)
}

type DefaultClient

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

func NewClient

func NewClient(log *logging.SimpleLogger, dataDir string, tfeToken string, defaultVersionStr string, defaultVersionFlagName string, tfDownloader Downloader) (*DefaultClient, error)

NewClient constructs a terraform client. tfeToken is an optional terraform enterprise token. defaultVersionStr is an optional default terraform version to use unless a specific version is set. defaultVersionFlagName is the name of the flag that sets the default terraform version. tfDownloader is used to download terraform versions. Will asynchronously download the required version if it doesn't exist already.

func (*DefaultClient) RunCommandAsync

func (c *DefaultClient) RunCommandAsync(log *logging.SimpleLogger, path string, args []string, v *version.Version, workspace string) (chan<- string, <-chan Line)

RunCommandAsync runs terraform with args. It immediately returns an input and output channel. Callers can use the output channel to get the realtime output from the command. Callers can use the input channel to pass stdin input to the command. If any error is passed on the out channel, there will be no further output (so callers are free to exit).

func (*DefaultClient) RunCommandWithVersion

func (c *DefaultClient) RunCommandWithVersion(log *logging.SimpleLogger, path string, args []string, v *version.Version, workspace string) (string, error)

RunCommandWithVersion executes the provided version of terraform with the provided args in path. v is the version of terraform executable to use. If v is nil, will use the default version. Workspace is the terraform workspace to run in. We won't switch workspaces, just set a WORKSPACE environment variable.

func (*DefaultClient) Version

func (c *DefaultClient) Version() *version.Version

Version returns the version of the terraform executable in our $PATH.

type DefaultDownloader

type DefaultDownloader struct{}

func (*DefaultDownloader) GetFile

func (d *DefaultDownloader) GetFile(dst, src string, opts ...getter.ClientOption) error

type Downloader

type Downloader interface {
	GetFile(dst, src string, opts ...getter.ClientOption) error
}

Downloader is for downloading terraform versions.

type Line

type Line struct {
	// Line is the contents of the line (without the newline).
	Line string
	// Err is set if there was an error.
	Err error
}

Line represents a line that was output from a terraform command.