Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ECLAT-MKIMG(1)		      Eclat User Reference		  ECLAT-MKIMG(1)

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 IN-
     STANCE-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 snap-
		shot-id specifies the ID of the snapshot to  create  the  volume
		from,  volume-size gives the desired size of the volume in giga-
		bytes.	The DOT  parameter  (delete  on  termination)  specifies
		whether  the device should be deleted after the instance is ter-
		minated.  Possible values are true and false.  The last  parame-
		ter  defines the volume type.  The value standard instructs Ama-
		zon to create a standard volume.  This is the default.	To  cre-
		ate  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.

SEE ALSO
     eclat(1), eclat-lsimg(1), eclat-deimg(1).

AUTHORS
     Sergey Poznyakoff

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

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

ECLAT				January 26, 2015		  ECLAT-MKIMG(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=eclat-mkimg&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help