packer

Documentation

Overview

Package packer allows to interact with Packer.

Index

• func BuildAmi(t testing.TestingT, options *Options) string
• func BuildAmiE(t testing.TestingT, options *Options) (string, error)
• func BuildArtifact(t testing.TestingT, options *Options) string
• func BuildArtifactE(t testing.TestingT, options *Options) (string, error)
• func BuildArtifacts(t testing.TestingT, artifactNameToOptions map[string]*Options) map[string]string
• func BuildArtifactsE(t testing.TestingT, artifactNameToOptions map[string]*Options) (map[string]string, error)
• type Options

Functions

func BuildAmi

func BuildAmi(t testing.TestingT, options *Options) string

BuildAmi builds the given Packer template and return the generated AMI ID.

Deprecated: Use BuildArtifact instead.

func BuildAmiE

func BuildAmiE(t testing.TestingT, options *Options) (string, error)

BuildAmiE builds the given Packer template and return the generated AMI ID.

Deprecated: Use BuildArtifactE instead.

func BuildArtifact

func BuildArtifact(t testing.TestingT, options *Options) string

BuildArtifact builds the given Packer template and return the generated Artifact ID.

func BuildArtifactE

func BuildArtifactE(t testing.TestingT, options *Options) (string, error)

BuildArtifactE builds the given Packer template and return the generated Artifact ID.

func BuildArtifacts

func BuildArtifacts(t testing.TestingT, artifactNameToOptions map[string]*Options) map[string]string

BuildArtifacts can take a map of identifierName <-> Options and then parallelize the packer builds. Once all the packer builds have completed a map of identifierName <-> generated identifier is returned. The identifierName can be anything you want, it is only used so that you can know which generated artifact is which.

func BuildArtifactsE

func BuildArtifactsE(t testing.TestingT, artifactNameToOptions map[string]*Options) (map[string]string, error)

BuildArtifactsE can take a map of identifierName <-> Options and then parallelize the packer builds. Once all the packer builds have completed a map of identifierName <-> generated identifier is returned. If any artifact fails to build, the errors are accumulated and returned as a MultiError. The identifierName can be anything you want, it is only used so that you can know which generated artifact is which.

Types

type Options

type Options struct {
	Template           string            // The path to the Packer template
	Vars               map[string]string // The custom vars to pass when running the build command
	VarFiles           []string          // Var file paths to pass Packer using -var-file option
	Only               string            // If specified, only run the build of this name
	Env                map[string]string // Custom environment variables to set when running Packer
	RetryableErrors    map[string]string // If packer build fails with one of these (transient) errors, retry. The keys are a regexp to match against the error and the message is what to display to a user if that error is matched.
	MaxRetries         int               // Maximum number of times to retry errors matching RetryableErrors
	TimeBetweenRetries time.Duration     // The amount of time to wait between retries
	WorkingDir         string            // The directory to run packer in
	Logger             *logger.Logger    // If set, use a non-default logger
}

Options are the options for Packer.