Documentation
¶
Overview ¶
The ebssurrogate package contains a packer.Builder implementation that builds a new EBS-backed AMI using an ephemeral instance.
Code generated by "mapstructure-to-hcl2 -type Config,RootBlockDevice,BlockDevice"; DO NOT EDIT.
Index ¶
Constants ¶
const BuilderId = "mitchellh.amazon.ebssurrogate"
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type BlockDevice ¶ added in v1.4.4
type BlockDevice struct { awscommon.BlockDevice `mapstructure:",squash"` // If true, this block device will not be snapshotted and the created AMI // will not contain block device mapping information for this volume. If // false, the block device will be mapped into the final created AMI. Set // this option to true if you need a block device mounted in the surrogate // AMI but not in the final created AMI. OmitFromArtifact bool `mapstructure:"omit_from_artifact"` }
func (BlockDevice) BuildEC2BlockDeviceMapping ¶ added in v1.4.4
func (blockDevice BlockDevice) BuildEC2BlockDeviceMapping() *ec2.BlockDeviceMapping
func (*BlockDevice) FlatMapstructure ¶ added in v1.5.0
func (*BlockDevice) FlatMapstructure() interface{ HCL2Spec() map[string]hcldec.Spec }
FlatMapstructure returns a new FlatBlockDevice. FlatBlockDevice is an auto-generated flat version of BlockDevice. Where the contents a fields with a `mapstructure:,squash` tag are bubbled up.
type BlockDevices ¶ added in v1.4.4
type BlockDevices []BlockDevice
func (BlockDevices) BuildEC2BlockDeviceMappings ¶ added in v1.4.4
func (bds BlockDevices) BuildEC2BlockDeviceMappings() []*ec2.BlockDeviceMapping
func (BlockDevices) Common ¶ added in v1.4.4
func (bds BlockDevices) Common() []awscommon.BlockDevice
func (BlockDevices) GetOmissions ¶ added in v1.4.4
func (b BlockDevices) GetOmissions() map[string]bool
func (BlockDevices) Prepare ¶ added in v1.4.4
func (bds BlockDevices) Prepare(ctx *interpolate.Context) (errs []error)
type Builder ¶
type Builder struct {
// contains filtered or unexported fields
}
func (*Builder) ConfigSpec ¶ added in v1.5.0
func (b *Builder) ConfigSpec() hcldec.ObjectSpec
type Config ¶
type Config struct { common.PackerConfig `mapstructure:",squash"` awscommon.AccessConfig `mapstructure:",squash"` awscommon.RunConfig `mapstructure:",squash"` awscommon.AMIConfig `mapstructure:",squash"` // Add one or more block device mappings to the AMI. These will be attached // when booting a new instance from your AMI. To add a block device during // the Packer build see `launch_block_device_mappings` below. Your options // here may vary depending on the type of VM you use. See the // [BlockDevices](#block-devices-configuration) documentation for fields. AMIMappings awscommon.BlockDevices `mapstructure:"ami_block_device_mappings" required:"false"` // Add one or more block devices before the Packer build starts. If you add // instance store volumes or EBS volumes in addition to the root device // volume, the created AMI will contain block device mapping information // for those volumes. Amazon creates snapshots of the source instance's // root volume and any other EBS volumes described here. When you launch an // instance from this new AMI, the instance automatically launches with // these additional volumes, and will restore them from snapshots taken // from the source instance. See the // [BlockDevices](#block-devices-configuration) documentation for fields. LaunchMappings BlockDevices `mapstructure:"launch_block_device_mappings" required:"false"` // A block device mapping describing the root device of the AMI. This looks // like the mappings in `ami_block_device_mapping`, except with an // additional field: // // - `source_device_name` (string) - The device name of the block device on // the source instance to be used as the root device for the AMI. This // must correspond to a block device in `launch_block_device_mapping`. RootDevice RootBlockDevice `mapstructure:"ami_root_device" required:"true"` // Tags to apply to the volumes that are *launched* to create the AMI. // These tags are *not* applied to the resulting AMI unless they're // duplicated in `tags`. This is a [template // engine](/docs/templates/engine.html), see [Build template // data](#build-template-data) for more information. VolumeRunTags awscommon.TagMap `mapstructure:"run_volume_tags"` // what architecture to use when registering the // final AMI; valid options are "x86_64" or "arm64". Defaults to "x86_64". Architecture string `mapstructure:"ami_architecture" required:"false"` // contains filtered or unexported fields }
func (*Config) FlatMapstructure ¶ added in v1.5.0
FlatMapstructure returns a new FlatConfig. FlatConfig is an auto-generated flat version of Config. Where the contents a fields with a `mapstructure:,squash` tag are bubbled up.
type FlatBlockDevice ¶ added in v1.5.0
type FlatBlockDevice struct { DeleteOnTermination *bool `mapstructure:"delete_on_termination" required:"false" cty:"delete_on_termination"` DeviceName *string `mapstructure:"device_name" required:"false" cty:"device_name"` Encrypted *bool `mapstructure:"encrypted" required:"false" cty:"encrypted"` IOPS *int64 `mapstructure:"iops" required:"false" cty:"iops"` NoDevice *bool `mapstructure:"no_device" required:"false" cty:"no_device"` SnapshotId *string `mapstructure:"snapshot_id" required:"false" cty:"snapshot_id"` VirtualName *string `mapstructure:"virtual_name" required:"false" cty:"virtual_name"` VolumeType *string `mapstructure:"volume_type" required:"false" cty:"volume_type"` VolumeSize *int64 `mapstructure:"volume_size" required:"false" cty:"volume_size"` KmsKeyId *string `mapstructure:"kms_key_id" required:"false" cty:"kms_key_id"` OmitFromArtifact *bool `mapstructure:"omit_from_artifact" cty:"omit_from_artifact"` }
FlatBlockDevice is an auto-generated flat version of BlockDevice. Where the contents of a field with a `mapstructure:,squash` tag are bubbled up.
type FlatConfig ¶ added in v1.5.0
type FlatConfig struct { PackerBuildName *string `mapstructure:"packer_build_name" cty:"packer_build_name"` PackerBuilderType *string `mapstructure:"packer_builder_type" cty:"packer_builder_type"` PackerDebug *bool `mapstructure:"packer_debug" cty:"packer_debug"` PackerForce *bool `mapstructure:"packer_force" cty:"packer_force"` PackerOnError *string `mapstructure:"packer_on_error" cty:"packer_on_error"` PackerUserVars map[string]string `mapstructure:"packer_user_variables" cty:"packer_user_variables"` PackerSensitiveVars []string `mapstructure:"packer_sensitive_variables" cty:"packer_sensitive_variables"` AccessKey *string `mapstructure:"access_key" required:"true" cty:"access_key"` CustomEndpointEc2 *string `mapstructure:"custom_endpoint_ec2" required:"false" cty:"custom_endpoint_ec2"` DecodeAuthZMessages *bool `mapstructure:"decode_authorization_messages" required:"false" cty:"decode_authorization_messages"` InsecureSkipTLSVerify *bool `mapstructure:"insecure_skip_tls_verify" required:"false" cty:"insecure_skip_tls_verify"` MaxRetries *int `mapstructure:"max_retries" required:"false" cty:"max_retries"` MFACode *string `mapstructure:"mfa_code" required:"false" cty:"mfa_code"` ProfileName *string `mapstructure:"profile" required:"false" cty:"profile"` RawRegion *string `mapstructure:"region" required:"true" cty:"region"` SecretKey *string `mapstructure:"secret_key" required:"true" cty:"secret_key"` SkipValidation *bool `mapstructure:"skip_region_validation" required:"false" cty:"skip_region_validation"` SkipMetadataApiCheck *bool `mapstructure:"skip_metadata_api_check" cty:"skip_metadata_api_check"` Token *string `mapstructure:"token" required:"false" cty:"token"` VaultAWSEngine *common.FlatVaultAWSEngineOptions `mapstructure:"vault_aws_engine" required:"false" cty:"vault_aws_engine"` AssociatePublicIpAddress *bool `mapstructure:"associate_public_ip_address" required:"false" cty:"associate_public_ip_address"` AvailabilityZone *string `mapstructure:"availability_zone" required:"false" cty:"availability_zone"` BlockDurationMinutes *int64 `mapstructure:"block_duration_minutes" required:"false" cty:"block_duration_minutes"` DisableStopInstance *bool `mapstructure:"disable_stop_instance" required:"false" cty:"disable_stop_instance"` EbsOptimized *bool `mapstructure:"ebs_optimized" required:"false" cty:"ebs_optimized"` EnableT2Unlimited *bool `mapstructure:"enable_t2_unlimited" required:"false" cty:"enable_t2_unlimited"` IamInstanceProfile *string `mapstructure:"iam_instance_profile" required:"false" cty:"iam_instance_profile"` SkipProfileValidation *bool `mapstructure:"skip_profile_validation" required:"false" cty:"skip_profile_validation"` TemporaryIamInstanceProfilePolicyDocument *common.FlatPolicyDocument `` /* 131-byte string literal not displayed */ InstanceInitiatedShutdownBehavior *string `mapstructure:"shutdown_behavior" required:"false" cty:"shutdown_behavior"` InstanceType *string `mapstructure:"instance_type" required:"true" cty:"instance_type"` SecurityGroupFilter *common.FlatSecurityGroupFilterOptions `mapstructure:"security_group_filter" required:"false" cty:"security_group_filter"` RunTags map[string]string `mapstructure:"run_tags" required:"false" cty:"run_tags"` SecurityGroupId *string `mapstructure:"security_group_id" required:"false" cty:"security_group_id"` SecurityGroupIds []string `mapstructure:"security_group_ids" required:"false" cty:"security_group_ids"` SourceAmi *string `mapstructure:"source_ami" required:"true" cty:"source_ami"` SourceAmiFilter *common.FlatAmiFilterOptions `mapstructure:"source_ami_filter" required:"false" cty:"source_ami_filter"` SpotInstanceTypes []string `mapstructure:"spot_instance_types" required:"false" cty:"spot_instance_types"` SpotPrice *string `mapstructure:"spot_price" required:"false" cty:"spot_price"` SpotPriceAutoProduct *string `mapstructure:"spot_price_auto_product" required:"false" cty:"spot_price_auto_product"` SpotTags map[string]string `mapstructure:"spot_tags" required:"false" cty:"spot_tags"` SubnetFilter *common.FlatSubnetFilterOptions `mapstructure:"subnet_filter" required:"false" cty:"subnet_filter"` SubnetId *string `mapstructure:"subnet_id" required:"false" cty:"subnet_id"` TemporaryKeyPairName *string `mapstructure:"temporary_key_pair_name" required:"false" cty:"temporary_key_pair_name"` TemporarySGSourceCidrs []string `mapstructure:"temporary_security_group_source_cidrs" required:"false" cty:"temporary_security_group_source_cidrs"` UserData *string `mapstructure:"user_data" required:"false" cty:"user_data"` UserDataFile *string `mapstructure:"user_data_file" required:"false" cty:"user_data_file"` VpcFilter *common.FlatVpcFilterOptions `mapstructure:"vpc_filter" required:"false" cty:"vpc_filter"` VpcId *string `mapstructure:"vpc_id" required:"false" cty:"vpc_id"` WindowsPasswordTimeout *string `mapstructure:"windows_password_timeout" required:"false" cty:"windows_password_timeout"` Type *string `mapstructure:"communicator" cty:"communicator"` PauseBeforeConnect *string `mapstructure:"pause_before_connecting" cty:"pause_before_connecting"` SSHHost *string `mapstructure:"ssh_host" cty:"ssh_host"` SSHPort *int `mapstructure:"ssh_port" cty:"ssh_port"` SSHUsername *string `mapstructure:"ssh_username" cty:"ssh_username"` SSHPassword *string `mapstructure:"ssh_password" cty:"ssh_password"` SSHKeyPairName *string `mapstructure:"ssh_keypair_name" cty:"ssh_keypair_name"` SSHClearAuthorizedKeys *bool `mapstructure:"ssh_clear_authorized_keys" cty:"ssh_clear_authorized_keys"` SSHPrivateKeyFile *string `mapstructure:"ssh_private_key_file" cty:"ssh_private_key_file"` SSHPty *bool `mapstructure:"ssh_pty" cty:"ssh_pty"` SSHTimeout *string `mapstructure:"ssh_timeout" cty:"ssh_timeout"` SSHAgentAuth *bool `mapstructure:"ssh_agent_auth" cty:"ssh_agent_auth"` SSHDisableAgentForwarding *bool `mapstructure:"ssh_disable_agent_forwarding" cty:"ssh_disable_agent_forwarding"` SSHHandshakeAttempts *int `mapstructure:"ssh_handshake_attempts" cty:"ssh_handshake_attempts"` SSHBastionHost *string `mapstructure:"ssh_bastion_host" cty:"ssh_bastion_host"` SSHBastionPort *int `mapstructure:"ssh_bastion_port" cty:"ssh_bastion_port"` SSHBastionAgentAuth *bool `mapstructure:"ssh_bastion_agent_auth" cty:"ssh_bastion_agent_auth"` SSHBastionUsername *string `mapstructure:"ssh_bastion_username" cty:"ssh_bastion_username"` SSHBastionPassword *string `mapstructure:"ssh_bastion_password" cty:"ssh_bastion_password"` SSHBastionPrivateKeyFile *string `mapstructure:"ssh_bastion_private_key_file" cty:"ssh_bastion_private_key_file"` SSHFileTransferMethod *string `mapstructure:"ssh_file_transfer_method" cty:"ssh_file_transfer_method"` SSHProxyHost *string `mapstructure:"ssh_proxy_host" cty:"ssh_proxy_host"` SSHProxyPort *int `mapstructure:"ssh_proxy_port" cty:"ssh_proxy_port"` SSHProxyUsername *string `mapstructure:"ssh_proxy_username" cty:"ssh_proxy_username"` SSHProxyPassword *string `mapstructure:"ssh_proxy_password" cty:"ssh_proxy_password"` SSHKeepAliveInterval *string `mapstructure:"ssh_keep_alive_interval" cty:"ssh_keep_alive_interval"` SSHReadWriteTimeout *string `mapstructure:"ssh_read_write_timeout" cty:"ssh_read_write_timeout"` SSHRemoteTunnels []string `mapstructure:"ssh_remote_tunnels" cty:"ssh_remote_tunnels"` SSHLocalTunnels []string `mapstructure:"ssh_local_tunnels" cty:"ssh_local_tunnels"` SSHPublicKey []byte `mapstructure:"ssh_public_key" cty:"ssh_public_key"` SSHPrivateKey []byte `mapstructure:"ssh_private_key" cty:"ssh_private_key"` WinRMUser *string `mapstructure:"winrm_username" cty:"winrm_username"` WinRMPassword *string `mapstructure:"winrm_password" cty:"winrm_password"` WinRMHost *string `mapstructure:"winrm_host" cty:"winrm_host"` WinRMPort *int `mapstructure:"winrm_port" cty:"winrm_port"` WinRMTimeout *string `mapstructure:"winrm_timeout" cty:"winrm_timeout"` WinRMUseSSL *bool `mapstructure:"winrm_use_ssl" cty:"winrm_use_ssl"` WinRMInsecure *bool `mapstructure:"winrm_insecure" cty:"winrm_insecure"` WinRMUseNTLM *bool `mapstructure:"winrm_use_ntlm" cty:"winrm_use_ntlm"` SSHInterface *string `mapstructure:"ssh_interface" cty:"ssh_interface"` AMIName *string `mapstructure:"ami_name" required:"true" cty:"ami_name"` AMIDescription *string `mapstructure:"ami_description" required:"false" cty:"ami_description"` AMIVirtType *string `mapstructure:"ami_virtualization_type" required:"false" cty:"ami_virtualization_type"` AMIUsers []string `mapstructure:"ami_users" required:"false" cty:"ami_users"` AMIGroups []string `mapstructure:"ami_groups" required:"false" cty:"ami_groups"` AMIProductCodes []string `mapstructure:"ami_product_codes" required:"false" cty:"ami_product_codes"` AMIRegions []string `mapstructure:"ami_regions" required:"false" cty:"ami_regions"` AMITags common.TagMap `mapstructure:"tags" required:"false" cty:"tags"` AMIENASupport *bool `mapstructure:"ena_support" required:"false" cty:"ena_support"` AMISriovNetSupport *bool `mapstructure:"sriov_support" required:"false" cty:"sriov_support"` AMIForceDeregister *bool `mapstructure:"force_deregister" required:"false" cty:"force_deregister"` AMIForceDeleteSnapshot *bool `mapstructure:"force_delete_snapshot" required:"false" cty:"force_delete_snapshot"` AMIEncryptBootVolume *bool `mapstructure:"encrypt_boot" required:"false" cty:"encrypt_boot"` AMIKmsKeyId *string `mapstructure:"kms_key_id" required:"false" cty:"kms_key_id"` AMIRegionKMSKeyIDs map[string]string `mapstructure:"region_kms_key_ids" required:"false" cty:"region_kms_key_ids"` AMISkipBuildRegion *bool `mapstructure:"skip_save_build_region" cty:"skip_save_build_region"` SnapshotTags common.TagMap `mapstructure:"snapshot_tags" required:"false" cty:"snapshot_tags"` SnapshotUsers []string `mapstructure:"snapshot_users" required:"false" cty:"snapshot_users"` SnapshotGroups []string `mapstructure:"snapshot_groups" required:"false" cty:"snapshot_groups"` AMIMappings []common.FlatBlockDevice `mapstructure:"ami_block_device_mappings" required:"false" cty:"ami_block_device_mappings"` LaunchMappings []FlatBlockDevice `mapstructure:"launch_block_device_mappings" required:"false" cty:"launch_block_device_mappings"` RootDevice *FlatRootBlockDevice `mapstructure:"ami_root_device" required:"true" cty:"ami_root_device"` VolumeRunTags common.TagMap `mapstructure:"run_volume_tags" cty:"run_volume_tags"` Architecture *string `mapstructure:"ami_architecture" required:"false" cty:"ami_architecture"` }
FlatConfig is an auto-generated flat version of Config. Where the contents of a field with a `mapstructure:,squash` tag are bubbled up.
type FlatRootBlockDevice ¶ added in v1.5.0
type FlatRootBlockDevice struct { SourceDeviceName *string `mapstructure:"source_device_name" cty:"source_device_name"` DeviceName *string `mapstructure:"device_name" required:"false" cty:"device_name"` DeleteOnTermination *bool `mapstructure:"delete_on_termination" required:"false" cty:"delete_on_termination"` IOPS *int64 `mapstructure:"iops" required:"false" cty:"iops"` VolumeType *string `mapstructure:"volume_type" required:"false" cty:"volume_type"` VolumeSize *int64 `mapstructure:"volume_size" required:"false" cty:"volume_size"` }
FlatRootBlockDevice is an auto-generated flat version of RootBlockDevice. Where the contents of a field with a `mapstructure:,squash` tag are bubbled up.
func (*FlatRootBlockDevice) HCL2Spec ¶ added in v1.5.0
func (*FlatRootBlockDevice) HCL2Spec() map[string]hcldec.Spec
HCL2Spec returns the hcl spec of a RootBlockDevice. This spec is used by HCL to read the fields of RootBlockDevice. The decoded values from this spec will then be applied to a FlatRootBlockDevice.
type RootBlockDevice ¶
type RootBlockDevice struct { SourceDeviceName string `mapstructure:"source_device_name"` // The device name exposed to the instance (for // example, /dev/sdh or xvdh). Required for every device in the block // device mapping. DeviceName string `mapstructure:"device_name" required:"false"` // Indicates whether the EBS volume is // deleted on instance termination. Default false. NOTE: If this // value is not explicitly set to true and volumes are not cleaned up by // an alternative method, additional volumes will accumulate after every // build. DeleteOnTermination bool `mapstructure:"delete_on_termination" required:"false"` // The number of I/O operations per second (IOPS) that // the volume supports. See the documentation on // IOPs // for more information IOPS int64 `mapstructure:"iops" required:"false"` // The volume type. gp2 for General Purpose // (SSD) volumes, io1 for Provisioned IOPS (SSD) volumes, st1 for // Throughput Optimized HDD, sc1 for Cold HDD, and standard for // Magnetic volumes. VolumeType string `mapstructure:"volume_type" required:"false"` // The size of the volume, in GiB. Required if // not specifying a snapshot_id. VolumeSize int64 `mapstructure:"volume_size" required:"false"` }
func (*RootBlockDevice) FlatMapstructure ¶ added in v1.5.0
func (*RootBlockDevice) FlatMapstructure() interface{ HCL2Spec() map[string]hcldec.Spec }
FlatMapstructure returns a new FlatRootBlockDevice. FlatRootBlockDevice is an auto-generated flat version of RootBlockDevice. Where the contents a fields with a `mapstructure:,squash` tag are bubbled up.
func (*RootBlockDevice) Prepare ¶
func (c *RootBlockDevice) Prepare(ctx *interpolate.Context) []error
type StepRegisterAMI ¶
type StepRegisterAMI struct { RootDevice RootBlockDevice AMIDevices []*ec2.BlockDeviceMapping LaunchDevices []*ec2.BlockDeviceMapping EnableAMIENASupport confighelper.Trilean EnableAMISriovNetSupport bool Architecture string LaunchOmitMap map[string]bool AMISkipBuildRegion bool // contains filtered or unexported fields }
StepRegisterAMI creates the AMI.
func (*StepRegisterAMI) Cleanup ¶
func (s *StepRegisterAMI) Cleanup(state multistep.StateBag)
func (*StepRegisterAMI) Run ¶
func (s *StepRegisterAMI) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction
type StepSnapshotVolumes ¶ added in v1.2.3
type StepSnapshotVolumes struct { LaunchDevices []*ec2.BlockDeviceMapping SnapshotOmitMap map[string]bool // contains filtered or unexported fields }
StepSnapshotVolumes creates snapshots of the created volumes.
Produces:
snapshot_ids map[string]string - IDs of the created snapshots
func (*StepSnapshotVolumes) Cleanup ¶ added in v1.2.3
func (s *StepSnapshotVolumes) Cleanup(state multistep.StateBag)
func (*StepSnapshotVolumes) Run ¶ added in v1.2.3
func (s *StepSnapshotVolumes) Run(ctx context.Context, state multistep.StateBag) multistep.StepAction