Documentation
      ¶
    
    
  
    
  
    Index ¶
- Variables
 - func SSHAddress(e *ec2.EC2, port int) func(multistep.StateBag) (string, error)
 - func SSHConfig(username string) func(multistep.StateBag) (*gossh.ClientConfig, error)
 - func WaitForAMI(c *ec2.EC2, imageId string) error
 - func WaitForState(conf *StateChangeConf) (i interface{}, err error)
 - type AMIConfig
 - type AccessConfig
 - type Artifact
 - type BlockDevice
 - type BlockDevices
 - type RunConfig
 - type StateChangeConf
 - type StateRefreshFunc
 - type StepAMIRegionCopy
 - type StepCreateTags
 - type StepKeyPair
 - type StepModifyAMIAttributes
 - type StepRunSourceInstance
 - type StepSecurityGroup
 
Constants ¶
This section is empty.
Variables ¶
var TemplateFuncs = template.FuncMap{
	"clean_ami_name": templateCleanAMIName,
}
    Functions ¶
func SSHAddress ¶
SSHAddress returns a function that can be given to the SSH communicator for determining the SSH address based on the instance DNS name.
func SSHConfig ¶
SSHConfig returns a function that can be used for the SSH communicator config for connecting to the instance created over SSH using the generated private key.
func WaitForAMI ¶
WaitForAMI waits for the given AMI ID to become ready.
func WaitForState ¶
func WaitForState(conf *StateChangeConf) (i interface{}, err error)
WaitForState watches an object and waits for it to achieve a certain state.
Types ¶
type AMIConfig ¶ added in v0.3.0
type AMIConfig struct {
	AMIName         string            `mapstructure:"ami_name"`
	AMIDescription  string            `mapstructure:"ami_description"`
	AMIUsers        []string          `mapstructure:"ami_users"`
	AMIGroups       []string          `mapstructure:"ami_groups"`
	AMIProductCodes []string          `mapstructure:"ami_product_codes"`
	AMIRegions      []string          `mapstructure:"ami_regions"`
	AMITags         map[string]string `mapstructure:"tags"`
}
    AMIConfig is for common configuration related to creating AMIs.
type AccessConfig ¶
type AccessConfig struct {
	AccessKey string `mapstructure:"access_key"`
	SecretKey string `mapstructure:"secret_key"`
	RawRegion string `mapstructure:"region"`
}
    AccessConfig is for common configuration related to AWS access
func (*AccessConfig) Auth ¶
func (c *AccessConfig) Auth() (aws.Auth, error)
Auth returns a valid aws.Auth object for access to AWS services, or an error if the authentication couldn't be resolved.
func (*AccessConfig) Prepare ¶
func (c *AccessConfig) Prepare(t *packer.ConfigTemplate) []error
type Artifact ¶
type Artifact struct {
	// A map of regions to AMI IDs.
	Amis map[string]string
	// BuilderId is the unique ID for the builder that created this AMI
	BuilderIdValue string
	// EC2 connection for performing API stuff.
	Conn *ec2.EC2
}
    Artifact is an artifact implementation that contains built AMIs.
type BlockDevice ¶ added in v0.3.2
type BlockDevice struct {
	DeviceName          string `mapstructure:"device_name"`
	VirtualName         string `mapstructure:"virtual_name"`
	SnapshotId          string `mapstructure:"snapshot_id"`
	VolumeType          string `mapstructure:"volume_type"`
	VolumeSize          int64  `mapstructure:"volume_size"`
	DeleteOnTermination bool   `mapstructure:"delete_on_termination"`
	IOPS                int64  `mapstructure:"iops"`
	NoDevice            bool   `mapstructure:"no_device"`
}
    BlockDevice
type BlockDevices ¶ added in v0.3.2
type BlockDevices struct {
	AMIMappings    []BlockDevice `mapstructure:"ami_block_device_mappings"`
	LaunchMappings []BlockDevice `mapstructure:"launch_block_device_mappings"`
}
    func (*BlockDevices) BuildAMIDevices ¶ added in v0.3.2
func (b *BlockDevices) BuildAMIDevices() []ec2.BlockDeviceMapping
func (*BlockDevices) BuildLaunchDevices ¶ added in v0.3.2
func (b *BlockDevices) BuildLaunchDevices() []ec2.BlockDeviceMapping
type RunConfig ¶
type RunConfig struct {
	SourceAmi            string `mapstructure:"source_ami"`
	IamInstanceProfile   string `mapstructure:"iam_instance_profile"`
	InstanceType         string `mapstructure:"instance_type"`
	UserData             string `mapstructure:"user_data"`
	UserDataFile         string `mapstructure:"user_data_file"`
	RawSSHTimeout        string `mapstructure:"ssh_timeout"`
	SSHUsername          string `mapstructure:"ssh_username"`
	SSHPort              int    `mapstructure:"ssh_port"`
	SecurityGroupId      string `mapstructure:"security_group_id"`
	SubnetId             string `mapstructure:"subnet_id"`
	TemporaryKeyPairName string `mapstructure:"temporary_key_pair_name"`
	VpcId                string `mapstructure:"vpc_id"`
	// contains filtered or unexported fields
}
    RunConfig contains configuration for running an instance from a source AMI and details on how to access that launched image.
func (*RunConfig) SSHTimeout ¶
type StateChangeConf ¶
type StateChangeConf struct {
	Conn      *ec2.EC2
	Pending   []string
	Refresh   StateRefreshFunc
	StepState multistep.StateBag
	Target    string
}
    StateChangeConf is the configuration struct used for `WaitForState`.
type StateRefreshFunc ¶ added in v0.2.3
StateRefreshFunc is a function type used for StateChangeConf that is responsible for refreshing the item being watched for a state change.
It returns three results. `result` is any object that will be returned as the final object after waiting for state change. This allows you to return the final updated object, for example an EC2 instance after refreshing it.
`state` is the latest state of that object. And `err` is any error that may have happened while refreshing the state.
func InstanceStateRefreshFunc ¶ added in v0.2.2
func InstanceStateRefreshFunc(conn *ec2.EC2, i *ec2.Instance) StateRefreshFunc
InstanceStateRefreshFunc returns a StateRefreshFunc that is used to watch an EC2 instance.
type StepAMIRegionCopy ¶ added in v0.3.5
type StepAMIRegionCopy struct {
	Regions []string
}
    func (*StepAMIRegionCopy) Cleanup ¶ added in v0.3.5
func (s *StepAMIRegionCopy) Cleanup(state multistep.StateBag)
func (*StepAMIRegionCopy) Run ¶ added in v0.3.5
func (s *StepAMIRegionCopy) Run(state multistep.StateBag) multistep.StepAction
type StepCreateTags ¶ added in v0.2.3
func (*StepCreateTags) Cleanup ¶ added in v0.2.3
func (s *StepCreateTags) Cleanup(state multistep.StateBag)
func (*StepCreateTags) Run ¶ added in v0.2.3
func (s *StepCreateTags) Run(state multistep.StateBag) multistep.StepAction
type StepKeyPair ¶
type StepKeyPair struct {
	Debug        bool
	DebugKeyPath string
	KeyPairName  string
	// contains filtered or unexported fields
}
    func (*StepKeyPair) Cleanup ¶
func (s *StepKeyPair) Cleanup(state multistep.StateBag)
func (*StepKeyPair) Run ¶
func (s *StepKeyPair) Run(state multistep.StateBag) multistep.StepAction
type StepModifyAMIAttributes ¶ added in v0.3.0
type StepModifyAMIAttributes struct {
	Users        []string
	Groups       []string
	ProductCodes []string
	Description  string
}
    func (*StepModifyAMIAttributes) Cleanup ¶ added in v0.3.0
func (s *StepModifyAMIAttributes) Cleanup(state multistep.StateBag)
func (*StepModifyAMIAttributes) Run ¶ added in v0.3.0
func (s *StepModifyAMIAttributes) Run(state multistep.StateBag) multistep.StepAction
type StepRunSourceInstance ¶
type StepRunSourceInstance struct {
	Debug              bool
	ExpectedRootDevice string
	InstanceType       string
	UserData           string
	UserDataFile       string
	SourceAMI          string
	IamInstanceProfile string
	SubnetId           string
	BlockDevices       BlockDevices
	// contains filtered or unexported fields
}
    func (*StepRunSourceInstance) Cleanup ¶
func (s *StepRunSourceInstance) Cleanup(state multistep.StateBag)
func (*StepRunSourceInstance) Run ¶
func (s *StepRunSourceInstance) Run(state multistep.StateBag) multistep.StepAction
type StepSecurityGroup ¶
type StepSecurityGroup struct {
	SecurityGroupId string
	SSHPort         int
	VpcId           string
	// contains filtered or unexported fields
}
    func (*StepSecurityGroup) Cleanup ¶
func (s *StepSecurityGroup) Cleanup(state multistep.StateBag)
func (*StepSecurityGroup) Run ¶
func (s *StepSecurityGroup) Run(state multistep.StateBag) multistep.StepAction