NAME

eclat-mkimg, eclat-create-image - create an AMI image

SYNOPSIS

eclat mkimg [-N] [-d DESCR] [-m DEV=SPEC] [--noreboot] [--no-reboot] [--description=STRING] [--devmap=DEV=SPEC] [--block-device-mapping=DEV=SPEC] NAME INSTANCE-ID

eclat mkimg --help

DESCRIPTION

This command creates an Amazon EBS-backed AMI from an existing instance INSTANCE-ID. If the instance is running it will be rebooted, unless the -N (--noreboot) option is used.

The NAME argument sets the name of the new AMI.

Upon successful completion the ID of the newly created AMI is printed on the stdandard output.

OPTIONS

-N, --noreboot, --no-reboot: Don't shut down the instance before creating the image.
-d, --description=STRING: Set a description for the new image.
-m, --devmap, --block-device-mapping=DEV=SPEC: Set block device mapping for the instances to be created from that AMI. The DEV part is the device name of the physical device on the instance to map. The SPEC sets the mapping specification and can be one of:

none: Disable the existing mapping. E.g. -m /dev/xvdb=none disables the mapping for the device /dev/xvdb.
ephemeral[0-3]: Map an instance store volume to the device. E.g. -m /dev/xvdb=ephemeral1.
[snapshot-id]:[volume-size]:[DOT]:[standard|io1[:iops]]: Specifies an EBS volume to be mapped to the device. The snapshot-id specifies the ID of the snapshot to create the volume from, volume-size gives the desired size of the volume in gigabytes. The DOT parameter (delete on termination) specifies whether the device should be deleted after the instance is terminated. Possible values are true and false. The last parameter defines the volume type. The value standard instructs Amazon to create a standard volume. This is the default. To create a provisioned IOPS volume, specify io1. In that case you can also supply the number of IOPS that the volume supports in the iops argument. For example, -m /dev/xvdf=snap-12345abc::false:io1:500.

-h, --help: Display a short usage summary.

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <bug-eclat@gnu.org.ua>.

COPYRIGHT

Copyright © 2012-2018 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.