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
       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  de-
	      vice on the instance to map.  The	SPEC sets the mapping specifi-
	      cation and can be	one of:

	   none	  Disable  the	existing mapping.  E.g.	-m /dev/xvdb=none dis-
		  ables	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 vol-
		  ume in gigabytes.  The DOT parameter (delete on termination)
		  specifies whether the	device should be deleted after the in-
		  stance is terminated.	 Possible values are true  and	false.
		  The last parameter defines the volume	type.  The value stan-
		  dard	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.

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/licens-
       es/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.0>

home | help